Please refer to below list of known issues and bugs for Alexa Presentation Language.
- Using more than 100 images in an APL document prevent the document from rendering on devices. When this issue is fixed, developers will see validation errors for documents that use more images than are supported by a device.
- The imageAspectRatio property on responsive components does not support the value round at this time. Setting this value still results in rectangular images. When this issue is fixed, the round value will work as expected.
- Devices cannot handle Frame’s border radius over image.
- APL Commands start immediately without waiting Alexa to finish saying outputSpeech on Fire TV.
- When rendered in the simulator, a TouchWrapper within a Pager sends incorrect UserEvent information to a skill. In some cases, the UserEvent information corresponds to Pager items not currently visible in the simulator.
- AMAZON.SelectIntent is not fired for utterances like "select number 3". When this issue is fixed, the built-in intent will also handle these utterances.
- When testing voice-based selection in the simulator, please use voice input. Using the text box will work, however the results will not be the same as you would get when using voice input. When this issue is addressed, you will be able to use the text box to test voice-based selection scenarios.
- The AlexaTransportControls can only be used in APL documents that have a single Video component.
- When a single video is played using the Video component the previous/next buttons of an associated AlexaTransportControl just pause the video. When this issue is fixed, the buttons will skip to the first/last frame of the video respectively.
- When used with a video that has autoplay set to false, the AlexaTransportControls will start out by showing a Pause button in the simulator. This is a known issue. However, on Alexa devices the button will correctly render as a Play button.
- The ControlMedia seek command does not work in the Alexa Skills Kit test simulator.
- The Video component's onPause and onPlay event handlers can not be used to invoke a SendEvent command on the simulator.
- The onCursorEnter/onCursorExit events don't work for all components. To work around the issue, set the inheritParentState property to true on the component that is being targeted by onCursorEnter/onCursorExit. When this issue is fixed, you will no longer need to set inheritParentState.
- Incorrect data binding expressions such as "height": "${payload.templateData.properties.text.height + 10}" when payload.templateData.properties.text.height isn't in the data source will lead to unpredictable APL rendering behavior.
- APL animation (AnimateItem command) gets jittery if too many elements are simultaneously animated on-screen.
- When automatic scaling is being applied to an APL document, Image components with scale set to 'none' don't scale correctly with the rest of the experience. To work around this issue, opt out of automatic scaling by selecting the checkbox for the relevant viewport profile in the ASK Console.
- In some scenarios, touching the screen on an Echo device does not stop APL command execution. When this issue is addressed, touching the screen will stop any ongoing APL command sequence in line with the command sequencing rules defined here https://developer.amazon.com/docs/alexa-presentation-language/apl-commands.html.
- Certain Fire tablets stop showing APL as a supported interface after being idle for some time. We believe the root cause may be APL's interaction with the tablet screen saver. When this issue is addressed, Fire tablets will consistently support APL even if the screen saver is active.
- Array of commands do not work as a part of onCursorEnter/onCursorExit event handlers. onCursorEnter/onCursorExit event handler only runs the first command in an array of commands.
- APL Runtime version is incorrectly reported as 1.1 instead of 1.2 on Simulator.
- Skill session continues after getting out of skill by pressing remote Back button on FireTV.
- ExecuteCommands directive can not be used to invoke user-defined commands
- Key event handlers (handleKeyDown/handleKeyUp) attached directly to APL documents are not executed unless the document contains an actionable component such as a TouchWrapper that has focus.
- When a customer uses an utterance (such as "select the third one") and the list on-screen does not have visible ordinals, the entity resolution logic does not match the selected item's id.
- Ordinal-based selection does not function reliably. The Resolutions Object is not populated accurately.
- When implementing Lazy Loading, visible blank space would be observed when "items" property is missing in the document sent as a part of SendIndexList or RenderDocument directive. This can be avoided by assigning an empty array to the "items" property.
- [APLT] A pager that makes multiple references to a data source only displays the first page, ignoring the other pages in the pager
- [APLT] The screen is locked on the first page of a pager when the "duration" property of the AutoPage command is omitted.
- [APLT] The starting index is not reset when using the SetValue command for a text component with marquee overflow.
- [APLT] Rendering of APL-T RenderDocument and ExecuteCommands directives do not persist through the skill session unless idleTimeout property is defined as a part of the directive.
- [APLT] Delay property for an AutoPage command on Echo Dot (3rd Gen) does not work and is throwing an error.
- [APLT] On any device supporting APLT (currently only Echo Dot (3rd Gen)), a document that uses "resources" will not render properly unless "datasources" field is present in directive payload. The workaround is to include an empty "datasources" field.
If you have any questions, please post on this forum space with this link and provide below information!
- Device(s) Affected: <Alexa device(s) affected>
- Device Serial Number (DSN):
- Skill Request received by the skill: <This can be captured by logging the skill request you get when the skill is invoked>
- Skill response containing the APL and any applicable datasources: <This can be captured in the Test tab of the skill developer console>
- Screenshot of the authoring tool: <Link to a screenshot of the authoring tool if relevant>
- Picture(s) of device(s) affected: <Link to pictures of device issues. Videos if the issue is related to animation/interactions>
- SW Build number on the respective device(s): <Accessible by pulling down the notification tray, click on Settings>Device Options->Check for software updates>
- Environment agentName and agentVersion: <You can capture this information by running below document>
{
"type": "APL",
"version": "1.2",
"mainTemplate": {
"items": [
{
"type": "Container",
"width": "100%",
"height": "100%",
"alignItems": "center",
"justifyContent": "center",
"items": [
{
"type": "Text",
"text": "${environment.agentName}"
},
{
"type": "Text",
"text": "${environment.agentVersion}"
}
]
}
]
}
}
