Step 11: Test for Certification (VSK Fire TV)
The following guidelines detail the user experience requirements to certify your video skill. Review these guidelines carefully to ensure that your Fire TV video skill meets the certification requirements. The guidelines here include a list of the individual test cases that Amazon reviews your skill against for skill launch quality.
- Prerequisites and Notes
- Targeting Your Video Skill on Fire TV Devices
- Overall Certification Requirements
- Testing Alexa Enablement
- Testing Utterance Support
- Response Performance Requirements
- Next Steps
Prerequisites and Notes
As part of the capability discovery payload, you declare the capabilities of your skill, such as channel change, quick play, and search. Your skill then needs to pass certification for those capabilities, following the guidelines listed. As you are creating your skill, list the capabilities that you plan to support in the testing instructions field. This certification test cases below provide a list of possible utterances. Make sure you test your skill with these utterances before you consider your integration to be complete.
Targeting Your Video Skill on Fire TV Devices
When you test your skill on a Fire TV device, make sure you target your skill through any of the following methods:
Explicitly target your skill: You can explicitly target your skill in your utterances by saying, "Alexa, watch X on <video provider>" or "Alexa, show me comedies on <video provider>."
Launch your skill from the Home screen: You can find your skill in on the Fire TV launcher home screen and click it to open it. Then your utterances are evaluated in the context of your video skill.
Launch your skill by means of voice: You can also open your skill by voice by saying "Alexa, open <video provider>."
When you target your skill like this, Alexa performs commands and other lookups within the context of your app and catalog, rather than looking across all video skills on the device.
Overall Certification Requirements
Your skill must meet the requirements listed in the following sections to pass certification.
- Latency Requirements: Your skill's end-to-end latency should be comparable to or better than currently-live video skills on Fire TV apps.
- Error Handling: If your media player has trouble during playback, the player should handle the error and display an error message so that users are aware of what is happening and broadcast that error. For more information about how to broadcast errors, see Error Handling.
- Continuous Play for TV Series VOD: If a user is currently watching a TV series, continuous play is recommended and supported. Once a new episode is playing, you must broadcast the capabilities of that next episode. If it is a single episode, you must honor the user's request and close the session.
Testing Alexa Enablement
When you integrated the Alexa Client Library, you enabled the client manager with this code:
The recommendation is to enable Alexa (setting it to
true) only for subscribed customers. As you log in and out of your app, check whether this is set appropriately.
||When a user signs in,
||When a user signs out,
Testing Utterance Support
Your video skill must provide appropriate responses to the utterances you support. To determine what capabilities your skill provides, Alexa sends the
Discover directive to your Lambda. You list your supported capabilities in the
capabilities section in the
Discovery Interface for more details.
If your app doesn't support a capability (for example, you might not support
ChangeChannel if your app doesn't have channels), you don't have to certify against those utterances. And if you don't claim support for
ChangeChannel directives, Alexa won't send those directives to your Lambda.
However, if your skill only supports certain capabilities for an interface, your responses should provide the appropriate handling for unsupported actions.
See the Utterances Reference for a detailed list of the various utterances that Fire TV devices support, including each phrase by locale as well. Utterances are grouped by the directives that Alexa sends when it hears the utterance.
Utterances are listed for all directives:
Response Performance Requirements
The table describes the latency limits for
SearchAndDisplayResults directives by call percentage.
|Call Percentage||Latency Limit
After you've finished testing your app, see Go Live with Your Skill.
(If you run into any issues that prevent you from continuing, see Troubleshooting for Cloudside Integrations.)
Last updated: Oct 13, 2021