Alexa.InteractionMode 1.0

The Alexa.InteractionMode interface is one of the APIs available for the Alexa Presentation Language (APL). Use the Alexa.InteractionMode interface to publish the supported interaction modes for your device.

An interaction mode defines a way that a user can interact with your device. For example, a tablet mode might support touch input, keyboard input, and video playback, while an auto display mode might support touch input and directional keyboard input but not video (for safety reasons). Each supported mode must have a unique identifier.

Some properties related to interaction modes may be defined by other interfaces, such as Alexa.Presentation.APL.Video defining the supported codecs for video playback or Alexa.Display defining general support for touch interactions.

Publish your Alexa.InteractionMode characteristics to the Alexa cloud upon device startup.

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

• Capability assertion
• Sample Object
• Object parameters

Capability assertion

Alexa.InteractionMode 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.InteractionMode",
    "version": "1.0"
}

Sample Object

The following code snippet shows the parameters, valid values, and types for the Alexa.InteractionMode interface:

{
    "type": "AlexaInterface",
    "interface": "Alexa.InteractionMode",
    "version": "1.0",
    "configurations" : {
        “interactionModes” : [
            {
                "uiMode": ["HUB", "TV", "MOBILE", "PC", "AUTO", "HEADLESS"],
                “id” : "{{STRING}}",
                “interactionDistance” : {
                    "unit" : [ "CENTIMETERS" | "INCHES" ],
                    "value" : {{DECIMAL}}
                },
                “touch” : [ "SUPPORTED" | "UNSUPPORTED" ],
                "keyboard" : [ "SUPPORTED" | "UNSUPPORTED" ],
                “video” : [ "SUPPORTED" | "UNSUPPORTED" ]
            }, ...
        ]
    }
}

Object parameters

The following table lists the parameters, valid values, and types for the Alexa.InteractionMode interface.