Release Notes (VSK Fire TV)
Release notes for VSK for Fire TV and Alexa Client Library are provided here.
- VSK Fire TV Release Notes
- VSK Developer Portal 1.1 Self-service Portal Release Notes
- Alexa Client Library Release Notes
VSK Fire TV Release Notes
The following tables provide release notes for the VSK for Fire TV.
|May 1, 2022||Directives payload upadate. The VSK directives payload has been updated to deprecate some categories of IDs.|
|January 14, 2022||Discovery declaration and formatting update, and new support for Alexa.Launcher 3.1. Updated Capabilities API for easy declaration and formatting of discovery using Builder objects. Added support for Alexa.Launcher 3.1 capability.|
|August 12, 2021||New country and language support. Launched support of video skills for German in Austria (de-DE).|
|June 30, 2021||New country and language support. Launched support of video skills for Mexico (es-MX), Brazil (pt-BR), Australia (en-AU), New Zealand (en-AU), and Ireland (en-GB).|
|January 11, 2021||Alexa Client Library 1.4.9. Alexa Client Library version 1.4.9 released. This version increases the accepted value of the
|Sept 28, 2020||App-only integration released. App-only integrations provide a more efficient and simple way to integrate the VSK into your Fire TV app, allowing you to work directly in your app's Android code rather than configuring external services (e.g., ADM, Lambda, CloudWatch, IAM). With app-only integrations, a service on Fire TV, called the VSK Agent. routes directives from Alexa to your app by way of broadcast intents. A BroadcastReceiver in your app handles the intents. Based on the intents, you fulfill the user's requests in your app (often by retrieving or playing the requested content). To get started, see App-only Integration Overview.|
|August 10, 2020||New entity types. Three new entity types were added:
|July 27, 2020||Doc navigation. Some documentation updates were made. VSK for Fire TV and VSK for Echo Show were split off into their own navigation, making them easier to view and navigate. Utterances were moved from the certification step to an Utterances Reference for easier navigation, with a Utterances Overview included as well to clarify different aspects of the utterances. Additionally, the list of supported utterances across every locale was updated with the latest confirmed implemented utterances in natural language understanding algorithms that Alexa uses. Versions were also listed for utterances.|
|May 21, 2020||es-MX beta. Support for video skills in es-MX (Spanish localized for Mexico) entered public beta. For more details, see Supported Countries.|
|May 13, 2020||en-AU support. Support for video skills in Australia (en-AU) entered public beta. For more details, see Supported Countries.|
|Mar 22, 2020||New Sample App. Released a new sample app that incorporates the VSK. For more details, see Step 2: Set Up the Sample Fire TV App for details, or go directly to the GitHub repo at sample-fire-tv-app-video-skill. Documentation related to the new sample app was also updated.|
|Feb 14, 2020||hi-IN support. Support for video skills in Hindu-speaking India (hi-IN) launched. For more details, see Supported Countries|
|Nov 23, 2019||Portal update. Developer Portal 1.1 Self-service Portal Release launched. For more details, see the section Developer Portal 1.1 Self-service Portal Release below.|
|Nov 12, 2019||fr-CA support. Support for video skills in French-speaking Canada (fr-CA) launched. For more details, see Supported Countries.|
|Nov 7, 2019||es-ES support. Support for video skills in Spain (es-ES) launched. For more details, see Supported Countries.|
|Oct 31, 2019||en-IN support. Support for video skills in India (en-IN), Japan (ja-JP), Italy (it-IT), and France (fr-FR) locales launched. Support for video skills in Spain (es-ES) entered public beta. For more details, see Supported Countries.|
|Oct 25, 2019||Auto-pairing. Options for self-service auto-pairing launched in the video skill configuration screens in the Alexa console. Documentation updates around this feature are still pending.|
|Sept 20, 2019||Alexa Client Library 1.4.5. Alexa Client Library version 1.4.5 released. This version supports a new interface called
|Sept 20, 2019||KeypadController interface. Documentation for
|Sept 15, 2019||Discovery documentation. Documentation for
|June 28, 2019||de-DE beta. Beta support for video skills in Germany (de-DE) launched. For more details, see Supported Countries.|
|June 27, 2019||en-CA support. Support for video skills in Canada (en-CA) launched. For more details, see Supported Countries.|
|May 2, 2019||en-GB support. Support for video skills in the UK (en-GB) launched. Support for video skills in India entered public beta. For more details, see Supported Countries.|
|May 2, 2019||Public doc release. First public documentation for VSK for Fire TV Apps released. Previously, this documentation was in a private Github repository. Also, to consolidate device implementation docs for video skills, the Echo Show docs were moved here.|
For updates related to the Alexa Client Library, see Alexa Client Library Release Notes.
VSK Developer Portal 1.1 Self-service Portal Release Notes
Dev Portal 1.1 simplifies the manual backend configuration that field engineers had to do to pair video skills with Fire TV apps. With this release, when you configure your video skill, you can select a Fire TV app to pair with your video skill all on your own, without involving field engineers.
The release adds a new section on the video skill configuration in the Alexa Console called "4. Fire TV Support":
This section lets you choose the Fire TV app associated with your video skill.
Although the changes in the video skill UI are minimal, enabling auto-pairing required a host of other changes as a result. Much of the documentation has been updated. The following updates were made:
Changes to the Lambda code
- Previously, there was a basic Lambda function used for a quick start, and another Lambda function used when you start customizing the Lambda code with your skill. To simplify the configuration, there's now just one Lambda. (The basic Lambda that you previously pasted into the editor has been removed.) The Lambda previously contained in the sample-nodejs-vsk-with-adm.zip project is now the only Lambda you need to work with. Also, this project was renamed to firetv-lambda.zip.
- The ADM registration ID is now retrieved automatically in the Lambda code. There's no need to initially hard-code the registration ID in the Lambda code and then later replace the code with a more automated method after auto-pairing.
- To upload your Lambda code into Lambda in AWS, you now always generate a Lambda deployment package (zip file). You no longer paste code into the Lambda function editor.
- The Lambda was updated to show the directive name in the first line of the CloudWatch logs. This helps you more easily identify the directive your Lambda receives.
- A section of the endpoint code from the
Discover.Responsepayload is no longer needed:
"endpointId": "VSKTV", "description": "VSKTV is the default device used for video skills developed for Fire TV integrations", "friendlyName": "VSKTV", "manufacturerName": "Amazon"
Changes to the sample app:
- In the sample app, the Alexa Client Manager enables Alexa immediately. This line, previously commented out, is now active:
- In the sample app, when the Alexa Client Library is initialized, the skill stage is set to
AlexaClientManager.SKILL_STAGE_DEVELOPMENT. Only after your skill passes Live App Testing and certification do you update this to
- The sample app's version of the Alexa Client Library updated to 1.4.5.
Changes to processes:
- Many of the previous instructions related to auto-pairing were removed.
- When you create your video skill, you will do the bare minimum at the start — just getting the video skill ID. You will leave the other video skill fields and sections blank. Later on in the process (step 7), you will return to complete the other fields. Most importantly, in step 7 you will complete the new video skill section: "4. Enable Fire TV Support." This section lets you pair your video skill with a specific Fire TV app.
- More setup is required before you can test out utterances with your sample app and see logs in CloudWatch. Previously, this utterance testing was available in step 2. Now you do the utterance testing in step 8.
- You no longer need to use the Alexa app to manually discover your video skill, nor do you need to manually pair your skill by selecting VSKTV in the Alexa app. Discovery is automatic.
- Previously, you would see catalog results for every catalog prior to auto-pairing your app with your video skill. Now that your video skill is paired with your app much earlier in the development process, you see only catalog results for the catalog associated with your video skill and catalog results for Prime video titles.
- The sequence and order of the implementation steps has been updated, expanded, or otherwise adjusted in various places. More instructions were also added about how to go live after certification.
Alexa Client Library Release Notes
Release notes for the latest versions of the Alexa Client Library are provided below. For integration instructions, see Step 3: Integrate the Alexa Client Library.
Released January 14, 2022
- Updated Capabilities API for easy declaration and formatting of discovery using Builder objects
- Added support for
Released January 11, 2021
- Increases the accepted value of the
- Includes stability and security enhancements
Released November 23, 2020
javax.injectdependency to reduce potential for build conflicts.
- Increased resiliency in the case of multiple calls to
initialize(). This will no longer crash the client, but should still be avoided.
Released August 26, 2020
- Removed Dagger dependency injection framework to prevent build conflicts and to not require consumers to declare it as a dependency
- Update LWA SDK to latest to prevent build conflicts
Released December 17, 2019
- Enhance handling of package name to prevent cases where initialization order could cause it to be null
- Prevent logging of package name
- Don't resend discovery after 7 days if no relevant fields have changed
Released August 29, 2019
- Update discovered capabilities version for KeypadController to "version 3"
- Only send status changed reports on status change
Released June 12, 2019
- Provides support for Fire OS 7. New Fire TV devices will run on Fire OS 7, so your app needs this version of the Alexa Client Library to support FOS 7 devices. Older versions of the Alexa Client Library are not compatible with FOS 7.
- Includes fixes to bugs that will help drive a better experience to customers when using voice.
- Enhances the security in the relationship between Alexa, Fire TV, and your application.
Released Apr 19, 2019
- Removed call to
Build.getSerial()to prevent crashing.
- Security enhancements.
Released Feb 12, 2019
- Fixed bug that could cause client library to retry failed events with no backoff.
Released Oct 9, 2018
Starting with version 1.4.0, the client library supports international regions. The library takes into account the marketplace within which the user's Amazon account is registered, and then performs pairing with the "correct" regional Alexa endpoint based on the customer currently registered to the device.
For this flow to work end-to-end, you must ensure that you have provided region-specific catalogs to your Amazon solution architect, or at least indicated that you would like your US catalog to also be available in specific regions. Once your skill is updated with these details, your users in international regions will be able to auto-pair and use voice with Alexa to control your app.
Last updated: Jun 15, 2022