Alexa.Presentation.APL.Video (v1.0)

The Alexa.Presentation.APL.Video interface is one of the APIs available for the Alexa Presentation Language (APL). This interface describes the video codecs that are supported by the APL runtime for a device. These codecs may differ from video codecs supported elsewhere on the device.

Publish the codec values based on both the base system and on the ability of APL to play the format.

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

Capability Assertion

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

Object Syntax

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


{
    "type": "AlexaInterface",
    "interface": "Alexa.Presentation.APL.Video",
    "version": "1.0",
    "configurations" : {
        "video" : {
            "codecs" : [ "H_264_42", "H_264_41" ]
        }
    }
}

Configuration Parameters

The following table lists the parameters, valid values, and types for the Alexa.Presentation.APL.Video interface.

Field Type Required Description

video

Object Yes Describes video-related settings.
video.codecs Array of strings Yes

A collection of one or more supported codecs by the device. Supported values are “H_264_42” and “H_264_41”.

  • H_264_41 : H.264 at a maximum resolution of 1080p @ 30fps (codec level 4.1) and supporting the main and high capability profiles (MP & HP).

  • H_264_42 : H.264 at a maximum resolution of 1080p @ 60fps (codec level 4.2) and supporting the main and high capability profiles (MP & HP).