AVS Speaker Guidance
- 1. Packaging and User Guide
- 2. Companion app
- 3. Alexa on Product
This document covers the materials, best practices and customer experiences that create a great Alexa smart speaker. It considers the customer journey for an AVS product from the Out of Box Experience (OOBE) through to ongoing use, and outlines what it takes to make a great Alexa-enabled product.
In creating an Alexa-enabled product, your customer engages with three key touch-points:
Printed materials in the packaging provide the customer with an opportunity to learn about Alexa and what they can do with their smart speaker before setting it up.
A companion app gives your customers the ability to learn about key Alexa features on your product, and the choice to set it up. If a customer chooses not to enable Alexa, it should be easy to locate and enable in the future should they change their mind. Once Alexa is set up, the companion app becomes the customer’s go-to place to learn about what Alexa can do on their smart speaker. Educating customers about the capabilities of Alexa is crucial to driving ongoing engagement with your product.
A clear attention system that accurately communicates that state of Alexa on your product. Once Alexa is set up, the smart speaker should provide audio and/or visual cues for what Alexa is doing at any given moment. Adjusting the volume, playing/pausing media, and activating Alexa is accomplished with the customer’s voice or touch, but also with simple physical controls on the smart speaker itself.
1. Packaging and User Guide
A customer has just received your Alexa-enabled speaker and may have different levels of familiarity with Alexa, depending on if they did research online, read that your product was Alexa-enabled on the packaging, or have no context at all.
User guides in your smart speaker packaging should:
- Educate customers on the benefits of using Alexa on their smart speaker
- Highlight Alexa use cases that are the most delightful on your product
- Showcase features that will be most useful and interesting for your customers
If your product does not have easily identifiable button controls for physical interactions with Alexa, your user guide should also include:
- How to start an Alexa interaction
- How to interrupt Alexa
- If your product is wake-word enabled, how to turn the microphone(s) on and off.
Additionally, all packaging must adhere to our marketing and branding guidelines.
2. Companion app
A successful Alexa integration into your smart speaker’s companion app should allow your customer to quickly and easily set up and configure Alexa, educate your customer about how to use Alexa, and drive engagement with Alexa.
Setting up Alexa
Setting up Alexa in your companion app consists of these three steps:
- Introducing Alexa and its benefits, typically on a splash screen
- Signing in with Login with Amazon (LWA)
- Educating the customer on how to use the product and Alexa, typically with the Things to Try screen
Alexa setup should be integrated into the product OOBE flow so that the customer moves directly from product setup into Alexa setup.
For detailed information, see the Setup and Authentication overview. As you build your Alexa setup flow, keep the following in mind for each stage:
1. A Splash Screen
The splash screen explains what Alexa is and what it does, highlighting the benefits of voice control. You can design your own splash screen to match your companion app, or use the example from our splash screen guidance.
The splash screen must include:
- Amazon Alexa logo
- Mention of Amazon
- Description of Amazon Alexa
- Description of what Alexa does
- Link to initiate authentication flow
2. Login with Amazon
Login With Amazon screens must be implemented to Amazon specifications. See the LWA implementation guides for detailed specifications for Authorizing from a Companion App (Android/iOS).
When registering your product, we recommend choosing a security profile name that accurately represents your product. The security profile name and information will appear on the LWA permissions screen for customers.
3. Things to Try screen
The Things to Try screen confirms a successful login and provides example utterances to try with Alexa. You can design your own Things to Try screen to match your companion app, or use the example from our Things to Try guidance. The Things to Try screen must include:
- Amazon Alexa logo
- Mention of Amazon
- Description of how to wake Alexa
- Example utterances
- A link to download or open the Amazon Alexa app.
The example utterances on the Things to Try screen should be appropriate for the product’s use cases. A speaker may emphasize audio controls, while a product designed for the kitchen may emphasize timers and alarms. Example utterances are available in the Setup and Authentication guidance.
When selecting example utterances, keep the following requirements in mind:
- If the product is voice-initiated, the example utterances must start with wake word “Alexa”
- If the product is touch-initiated, the example utterances should not start with “Alexa”
- The utterances should not reference third-party products the customer must purchase in addition to your product
- The utterances should not reference third-party skills that the customer must enable, however, examples of how to enable your own skill(s) are appropriate to include
If the device your customer signs in from supports the Amazon Alexa app, you must:
- Link directly to the Amazon Alexa app if installed, or
- Link to the Amazon Alexa app in the app store for your OS.
The syntax for the links are:
If the device your customer signs in from does not support the Amazon Alexa app, you must inform the customer that the Amazon Alexa app is available for download. However, you are not required to link directly to the app in the app store for your OS.
We recommend including screens in your app that educate the customer on:
- Features that are delightful and useful on your product
- How to use the product’s buttons to wake Alexa
- For those products that are voice-initiated, how to turn the product’s microphones off
This reinforces the information provided in the user guide, ensuring new customers are educated on how to use your product.
Where to add education
This information can be provided at the first stage on the splash screen or between the LWA login and the Things to Try screens. It is up to you to decide what features to highlight to best drive engagement on your smart speaker. As new features are released, we suggest updating this section.
You are provided with examples of what these screens might look like, but you are ultimately responsible for their creation.
Sign out and Settings
You need to enable an easy to find, no hassle way for customers to sign out. It can be integrated into the companion app's Alexa settings or may be a standalone screen within the app. If it is a standalone screen, we recommend using the Things to Try content so that customers are reminded of the benefits of staying signed in.
Alexa settings within your companion app will give your customer more control of their Alexa experience without having to use the Alexa app. The Alexa settings section should be labeled “Amazon Alexa” and if you use logos for each setting, use the Alexa brand asset provided by Amazon.
Settings that can be made available in your companion app are:
- Alexa language selection
- Enabling and disabling the start and stop listening sounds (only for products with prominent LEDs)
- Signing out
3. Alexa on Product
When integrating Alexa into your product, your product must have:
- Affordances to physically interact with Alexa
- Affordances to communicate Alexa states
The physical affordances to interact with Alexa will depend up on whether your products is voice-initiated or touch-initiated.
Sound cues are a key component of Alexa communicating with customers.
The ideal smart speaker is voice-initiated, allowing customers to interact with Alexa by saying “Alexa,” followed by an utterance. This implementation puts voice first, but provides the flexibility for customers to interact with Alexa by pressing an affordance on the product.
This option is right for your product if it has a 2+ microphone array and a robust battery or AC adapter for power. See Audio Hardware Configurations for more about hardware and audio considerations.
Voice-initiated products require two physical affordances for interacting with Alexa:
- Action button
- Microphone On/Off button
This option is right for your product if it has a single microphone, a limited battery supply, or is unable to communicate the microphone-off state because of insufficient LEDs.
These products do not have wake-word capabilities and solely rely on the Action button to initiate Alexa.
A physical button that allows a customer to invoke Alexa without requiring them to say the word “Alexa.”
When the product is Idle, a single press puts the product into Listening mode.
When Alexa is Speaking, a single press immediately stops Alexa Speaking and puts the product into Active Listening mode.
When Alexa is playing media, a single press attenuates or pauses the music and puts the product into Active Listening mode. If Alexa doesn’t hear any utterance from the customer, the product should return to the Idle state with the music continuing at its previous volume.
When an Alexa alert, such as a timer, alarm, or reminder, is sounding, a single press stops the alert.
Ideally, the Action button would have the Amazon Alexa logo as its icon.
If your product’s action button is very small, making the Amazon Alexa logo illegible, a microphone icon is an appropriate alternative.
If your button has other uses besides waking Alexa, a microphone icon should be used.
Microphone On/Off button
A physical button that toggles the products wake-word capability on/off either through disabling the products microphone or disabling its wake-word.
Pressing the Microphone On/Off button once disables the product ability to receive Alexa requests.
Pressing the Microphone On/Off button when disabled, re-enables the product ability to receive Alexa requests.
The recommended icon for the Microphone On/Off button is a microphone with a slash through it.
Both the Action and Microphone On/Off buttons should not be overloaded with additional functionality. These controls are essential to a good experience with Alexa, and they should behave only with the functionality specified above. Avoid button interactions that require the customer to hold for a certain amount of time, or double tap to access functionality.
If you are integrating Alexa into an existing product, and there is no possibility to add Alexa-specific buttons to your product, or will overload existing buttons with Alexa functionality, you can incorporate the Action and Microphone On/Off buttons into your companion app. However, this approach is discouraged as it does not provide your customer with a great Alexa experience.
A product is required to communicate state to customers either visually or with the sounds provided by Amazon. A great smart speaker experience communicates Alexa states with both, and they should be synchronized. The AVS Sound Library can be downloaded from the Developer Console once you have registered your first product.
Sound files communicate Alexa states and should:
- Be stored on the product so that they are available if the product is unable to connect to Alexa or if latency issues are encountered
- Use the sound file optimized for your speaker quality. Typically speakers use the “full” set, though there are three sets of sound files available
See Attention State Sounds for more details.
To best display the Alexa states, a smart speaker’s LEDs should support:
- A full range of colors
- Animations such as pulsing and blinking
For specific guidance on the LED color and animations for each state, see [Attention States LEDs][avs-ux-attention#multicolor-leds].
Core Attention States
The core attention states communicate to customers that Alexa is:
- Listening for their utterance
- Thinking about their utterance
- Then Speaking the response
There should be no lags between the transitions so that the customer never wonders if the Alexa interaction has failed.
You must support the following states: Idle, Listening, Thinking, Speaking, Microphone On/Off, Alerts, New and Queued Notifications, and Do Not Disturb. See Attention States for detailed information.
When Alexa is Idle, customers can use the Alexa wake-word or a physical control to wake Alexa, which starts her Listening state.
Alexa has been initiated via wake-word, tap-to-talk, or push-to-talk, and the microphone begins streaming the customer’s request to the Alexa Voice Service.
LEDs: Cyan and blue, animated
Sounds: Start listening, Stop listening, stored locally
When a customer completes a request, Alexa enters a Thinking state, which lets the customer know the microphone is no longer active and Alexa will respond shortly.
LEDS: Cyan and blue, animated
The Microphone On/Off state communicates that Alexa is disabled due to the customer pressing Microphone On/Off button. In this state, the product is not capable of sending any utterance to Alexa. The LED that communicates the Microphone On/Off state may be a different LED from the one that communicates all other Alexa attention states, and can even be embedded in the Microphone On/Off button itself. The Microphone On/Off and Microphone On sounds must be played even if Alexa is responding when the customer presses the button.
LEDs: Red, unanimated
Sounds: Microphone On/Off and Microphone on, both stored locally
Timers and Alarms
Timers and Alarms use distinct sounds, but otherwise, behave the same way. When a timer or alarm goes off, the appropriate sound must be played until the customer stops the alert or for an hour, whichever comes first. The timer and alarm sounds must be stored on product.
LEDs: Cyan and blue, animated
Sounds: Timer and Alarm, both stored locally
Reminders are also known as Named Timers and Alarms. When a Reminder goes off, the product must play the sound included in the Alexa response, and Alexa should then speak the Reminder. The number of times the reminder should be looped and the pause between loops is information included in the Alexa response.
LEDs: Cyan and blue, animated
Sounds: Reminder, cached from cloud
New Notifications and Queued Notifications
The new Notifications state informs the customer that one or multiple Notifications have arrived, while the Queued Notification state informs the customer that there are Notifications waiting to be read for the customer. New Notification require both LEDs and sounds to communicate the state, while Queued Notifications only requires LEDs.
LEDs: Yellow, animated
Sound: Notification arrived, pulled from cloud
Do Not Disturb
The product will not proactively communicate to the customer. Currently this is only applicable to sounds played when Notifications are received. When this state is active, the product will not play sounds. There are 2 ways customers can activate Do Not Disturb.
LEDs: Purple, animated
Sound: Do Not Disturb enabled and Do Not Disturb disabled, both pulled from cloud
When errors that prevent Alexa from functioning, e.g. Wi-Fi not available.
LEDs: Orange, solid