- Amazon Developer Account
- The sample code on GitHub.
If you use Alexa hosted, follow the steps:
- Create a new Alexa Hosted skill using Node.js
- Copy paste the file models/en-US.json into the json editor of the interaction model.
- Enable Alexa Presentation Language under Interfaces.
- Build your interaction model and skill changes.
- Go to the Code tab. Copy paste the index.js into the index.js file already in your hosted environment. (SkillCode > lambda > index.js)
- Create a new file for each of the json documents in the Code tab and copy the code repo's files into your new file. You must do this with "colors.json", "pagerDocument.json", and "sequenceDocument.json". You can exclude "SampleData.json". This is only for using the APL authoring tool.
- Deploy and enjoy!
To start the demo say/type "alexa open color picker". It will present the APL document on the device if you are using an APL compatible device, such as the Echo Show. Otherwise, you will be asked to run the skill on a compatible device. This demo does require at least APL version 1.3.
The demo will allow a very large set of items (colors) to be displayed inside of a pager or a sequence component. You can change the component being used in the document by selecting pager or sequence in the header. As you scroll, more items will be loaded in. This is handled in the lambda code through the use of the new directive, Alexa.Presentation.APL.SendIndexListData as a part of the handler, LoadIndexListDataRequestHandler.
This demo also shows an example APL error handler, APLRuntimeErrorHandler. This handles the new request type, Alexa.Presentation.APL.RuntimeError.
Check out the build directory README if you want to modify the colors list or just want to see the code/instructions on how the interaction model was created.
Explore the demo and feel free to use this as a base to try out handling your own data sources. Open a Github issue if you find any problems.