article

Chihiro@Amazon avatar image
Chihiro@Amazon posted

Alexa Developer Console APL Interface Viewport User Interface Update

After the release of APL 1.6, we began defining viewports as ranges of pixel values, rather than as fixed pixel values in order to represent multiple possible physical devices.

Therefore, if you published an Alexa skill which supported APL prior to APL 1.6, you may notice that the viewport profile check marks might be removed from the "Live" version of your skill.

Within the Alexa Developer Console, your skill's supported APL viewport profiles can be found under: Build > Interfaces > Alexa Presentation Language:

apl-ui.png

Although the check marks are removed from the Alexa Developer Console's user interface, your previously selected viewports, which used fixed pixel values, are still saved in skill's skill.json manifest file and we continue to support them. Thus, your skill's supported viewports have not changed.

To review the supported APL viewports for a live skill, as recorded in the skill's skill.json manifest file, you may use the ASK CLI's "get-skill-manifest" command:
https://developer.amazon.com/en-US/docs/alexa/smapi/ask-cli-command-reference.html#get-skill-manifest-subcommand


Converting Your Skill To Use Range Viewport Values

If you would like to convert your skill from using fixed viewport values, to instead use range values, then within the Alexa Developer Console, please re-check the checkboxes next to the desired supported viewport values for the "In Dev" version of your skill. Once that's done, you may submit the "In Dev" version of your skill for review via the "Certification" tab.

If you use the ASK CLI, please update the supportedViewports array in the skill manifest with the new range values for each viewport. Manually providing viewport range values in the skill manifest will also restore the the check marks for the corresponding viewport in the Alexa Developer Console. Please note, updating the skill manifest with fixed viewport values will not restore the check marks on the Alexa Developer Console.


Viewport Fixed Range
Hub Round Small {
"mode": "HUB",
"shape": "ROUND",
"maxHeight": 480,
"minHeight": 480,
"maxWidth": 480,
"minWidth": 480
}
{
"mode": "HUB",
"shape": "ROUND",
"minHeight": 100,
"maxHeight": 599,
"minWidth": 100,
"maxWidth": 599
}
Hub Landscape Small {
"mode": "HUB",
"shape": "RECTANGLE",
"maxHeight": 480,
"minHeight": 480,
"maxWidth": 960,
"minWidth": 960
}
{
"mode": "HUB",
"shape": "RECTANGLE",
"minHeight": 100,
"maxHeight": 599,
"minWidth": 960,
"maxWidth": 1279
}
Hub Landscape Medium {
"mode": "HUB",
"shape": "RECTANGLE",
"maxHeight": 600,
"minHeight": 600,
"maxWidth": 1024,
"minWidth": 1024
}
{
"mode": "HUB",
"shape": "RECTANGLE",
"minHeight": 600,
"maxHeight": 959,
"minWidth": 960,
"maxWidth": 1279
}
Hub Landscape Large {
"mode": "HUB",
"shape": "RECTANGLE",
"maxHeight": 800,
"minHeight": 800,
"maxWidth": 1280,
"minWidth": 1280
}
{
"mode": "HUB",
"shape": "RECTANGLE",
"minHeight": 600,
"maxHeight": 1279,
"minWidth": 1280,
"maxWidth": 1920
}


Additional Documentation:

alexa skills kitaplask cliask sdkalexa developer console
apl-ui.png (219.0 KiB)
10 |3000 characters needed characters left characters exceeded

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Article

Contributors

KirkC@Amazon contributed to this article tatarac contributed to this article