Supported Fire TV Devices
You need Version631098910 or later on your Fire TV device before the app-only integration becomes available for your device. To check if you have the right version:
- Connect to your Fire TV through ADB
- Run this adb command:
versionCode needs to be 631098910 or later. Alternatively, press your microphone button and say a voice command. If the voice chrome (Alexa’s blue bar) appears at the bottom of the screen, you have the new build. If it appears at the top, you don’t have the new build.
To check your Fire TV build, go to Settings > About. Click either Device & Software or My Fire TV (the menu name differs by device). Then click your Fire TV device and look for the Fire TV Home Version. If you don’t see Build 631098910 or later, click Check for updates and get the latest build available.
If you don’t want to wait until the rollout dates, you can send your Device Serial Number (DSN) along with your Customer ID (CID) to your Amazon representative to have your device manually added to the software rollout. To retrieve your DSN and CID:
- DSN: On your Fire TV, go to Settings > Device & Software (or My Fire TV) > About.
- CID: First, sign in to the developer portal; then once signed in, go to https://developer.amazon.com/mycid.html.
Explicit Targeting with the Sample App and other Pre-release Apps
Explicit targeting refers to including the app name in the request, such as “Alexa, watch Interstellar on <App Name>” rather than just “Alexa, watch Interstellar.” Note the following:- Explicit targeting won’t work in the sample app.
- Explicit targeting will only work in your real app after (1) you’ve completed catalog integration and (2) you’ve either submitted your app into either Live App Testing (LAT) or production. The Amazon services that required to support explicit targeting require your app to be in either the LAT or prod state.
Support for App Name Aliases in Launch Utterances
Apps can be launched with different app names. For example, suppose the app was named “Sports Streamz Now.” Users might be able to open the app by saying “Open Sports Streamz,” or “Open Streamz Now,” or maybe even “Open Streamz.” These alternative app names are all recognized aliases. With cloudside integrations, you could specify these aliases in the video skill configuration in the Alexa console. However, app-only integrations don’t require you to create a video skill in the Alexa console. (The skill is automatically created for you on the backend, so it’s invisible to you.) But as a result, there isn’t a place for you to specify aliases to launch your app. Until there’s a way to specify aliases, you will need to reach out to your Amazon representative with this request. The VSK team will then create the aliases you need for your app manually.Support for Web Apps (wrapped webapps)
App-only integrations are designed for native Android projects. If you have an HTML5 Web App, app-only integrations aren’t supported. However, if you have a hybrid app (web app wrapped with native Android through wrappers such as Cordova), this approach is supported. However, exactly how you manage the communication between the native layer and the Amazon Web View (AWV) might need to be something you figure out on your own. The VSK team has not tested app-only integrations on hybrid apps. You will need to create a BroadcastReciever that can handle intents, get the directive payloads from intents through your BroadcastReceiver, and then apply handling logic in your app.Recommended Interfaces in App-only Integrations
The only recommended VSK interface with app-only integrations isRemoteVideoPlayer, specifically the SearchAndPlay and SearchAndDisplayResults directives. For the others, here’s what’s recommended:
- Instead of
PlaybackControllerandSeekController, implement MediaSession. - Instead of
Channelcontroller, implement the Live TV integration. - Instead of
KeypadController, use the built-in In-App Voice Scrolling and Selection.
How Alexa Reads Your Catalog
When you declare your app’sRemoteVideoPlayer capabilities, you’re required to list your partner ID in the catalogs object:
catalogs object in the future.
