Alexa.Presentation 1.0

Note: Learn how to improve your skills with APL with Build visually rich experiences using APL at the Alexa Learning Lab.

The Alexa.Presentation interface extends the Alexa Voice Service (AVS) to report presentation states to AVS.

To learn more about APL, its interfaces, and how to use those interfaces together, see Alexa Presentation Language (APL) Overview.

Capability assertion

Alexa.Presentation 1.0 may be implemented by the device on its own behalf, but not on behalf of any connected endpoints.

New AVS integrations must assert support through Alexa.Discovery, but Alexa will continue to support existing integrations using the Capabilities API.

Sample declaration

{
  "type": "AlexaInterface",
  "interface": "Alexa.Presentation",
  "version": "1.0"
}

Events

Dismissed

Devices send a Dismissed event to Alexa to report that a Presentation has been dismissed. Always send the Dismissed event along with a complete Context object. See Context for more details.

Sample Dismissed Event message

The following sample code shows the structure for a Dismissed event message:

{
    "header": {
        "namespace": "Alexa.Presentation",
        "name": "Dismissed",
        "messageId": STRING
    },
    "payload": {
        "presentationToken": STRING
    }
}

Dismissed Event Payload parameters

The following table lists the payload parameters for the Dismissed event:

Field	Type	Description
presentationToken	STRING	Opaque token for the active presentation.

Last updated: Feb 22, 2021