Test Pairing and Discovery
Note: Sign in to the developer console to build or publish your skill.
Note: On December 31, 2021, we paused support for third-party device makers working with Alexa Gadgets, while we work to create an even better developer and customer experience. Please stay tuned to the Amazon developer portal for updates. In the interim, please visit the landing pages for Alexa Voice Service, Alexa Connect Kit, and Alexa Skills Kit to discover ways you can provide new customer experiences with voice.
This topic contains tests that indicate whether your gadget can successfully communicate with an Echo device.
Preparation
Before performing these tests, ensure that you have done the following:
- Register your gadget – Register your gadget in the developer portal, as described in Register a Gadget. You will receive a secret key at the end.
- Get an Amazon Echo device – Get an Echo device and register it to the account that you used to register the gadget in the developer portal. For a list of Echo devices that support gadgets, see Echo devices that support gadgets.
- Configure communication channel settings – Set the Bluetooth pairing parameters of your gadget to the settings described in Gadget Settings for Classic Bluetooth.
- Set up the gadget to receive directives – Have code in place to accept the
Discover
directive. - Set up the gadget to send events – Have code in place to assemble and send the
Discover.Response
event in response to theDiscover
directive.
Test pairing
- Put the gadget into pairing mode.
- Put the Echo device into pairing mode. If your Echo device has a screen, follow the on-screen instructions for pairing. If your device does not have a screen, do the following:
- Go to the Amazon Alexa app (alexa.amazon.com) and sign in with your Amazon developer account.
- On the left, select Settings.
- From the Device list, select your Echo device.
- Under Connected Devices, select Pair Alexa Gadget, and follow the instructions. If you can successfully pair your gadget, the gadget's Bluetooth settings are correct.
Test a directive
Continuing from the test above:
- Once paired, the Echo device will send a
Discover
directive to your gadget with a request to respond with aDiscover.Response
event. If your gadget receives theDiscover
directive, your gadget and the Echo device have successfully established a communication channel. - Your gadget should respond with a
Discover.Response
event. - Say "Alexa" to the Echo device. Your gadget should receive a
Alexa.Gadget.StateListener.StateUpdate
directive notifying it that the wake word was detected.
Last updated: Feb 14, 2022