Media services

We aim to provide the best in-car Alexa experience for our customers; which means we are flexible as to how media is played and surfaced. Whether it’s through your devices embedded media player, the Auto SDK embedded application, or an MSP’s embedded application on your device; what’s best for the customer is always our preferred approach. To ensure customers maintain a great listening experience in the vehicle, we send Alexa’s Display Cards through the Auto SDK to enable media to be visually surfaced and played when no embedded app or media player is being used. Alexa services media content from a variety of sources (e.g. Amazon Music, Spotify, etc.). Customers may ask Alexa to play music, audiobooks, podcasts, and more. Alexa responds by seamlessly switching between the sources and surfacing the right media to the customer.

High-level requirements

Playback controls

Media playback controls vary depending on the source and content playing. Partners have the flexibility to determine the position and order of these controls. The example below shows different variations that could appear across different sources, at different times. The TemplateRuntime API provides real-time instructions on which buttons should be displayed. For questions on the following guidelines, please refer to this template. The JSON in this template provides all playback controls for each music service provider and must be display accordingly.

(Required) Any touch target on the media player must be controllable via voice.

(Required) Enable voice control of switching between all local media sources.

Each touch target on the media player should have a voice analog, but not every voice command needs to have a touch analog. This is the voice forward approach for Alexa.

(Required) Display tuning and transport controls for local media sources.

(Required) Remove controls not available in the active media.

Media includes content types like podcasts, playlists, songs, audiobooks, etc., which utilize different sets of controls. Media should not present a control that it does not use for the current playing media. Example: “fast-forward/rewind 30 seconds” are controls available in audiobook and podcast controls, but not within music controls. Because of this, these controls should only appear when an audiobook or podcast is playing.

(Required) Disable controls not currently selectable in the active media.

When a control is generally available, but cannot be used at a certain time, disable the control (gray it out) to avoid frustrating the customer. Example: Some music providers offer customers free accounts with limited features /functionality. The customer may only be able to skip a set amount of tracks. Once they reach the limit, they can no longer press the next track button. In this instance, the next track button must appear disabled.

These are available in the design toolkit. Alternatively, if Alexa plays media using the local media player (e.g. Alexa is the media source), use local media control icons.

For international vehicles where customers drive on different side of the vehicle, swap all pertinent information.

Left sided media player
Right sided media player

Source attribution

Customers can ask Alexa to play media from a wide range of sources – Amazon Music, Audible, Spotify, Pandora, etc. These media sources require attribution so customers to know where the media is coming from.

Full screen media player
Mini media player

(Required) When playing media from a Music Provider, always display logo attribution.

The media source logo must be displayed on the media player in the center console. Use the designer toolkit, for the attribution icon with the render template.

(Required) Use the appropriate attribution icon available in the Amazon Icon Library.

These are available in the design toolkit.

Metadata

Media Metadata must appear on the screen at all times to inform the customer of what they are listening to. We provide three lines of metadata in the JSON payload. The order data is presented depends on the type of media playing. Refer to the UI Text Guidelines for more details on string requirements.

(Required) Display media metadata on the center stack.

Refer to the UI Text Guidelines for more details on string requirements.

This is typically a song title, chapter of a book, or podcast name.

Images: Album art, cover art, logos, etc.

(Required) Show display art when received from the media service provider.

Display art includes album art, book cover designs, station logos, and other display graphics used to describe the media content. We recommend showing this passenger side, as pertinent information and controls should always be easily accessible to the driver.

(Required) Do not alter display art in any way.

Display art must be presented in its original form. Do not use beveling, overlays, or other effects to graphically alter display art.

Examples of images are provided below and can be found in the resources section of these guidelines.

Placeholder images

Media screens

Results

Show Billie Eilish

For requests that generate a list of results, we provide list results metadata to display in the List Template card. The customer may choose a list item with a screen tap or by voice (i.e. “Alexa, number 2”). Once an item is selected, transition to the now playing card.

Now Playing:

Play Billie Eilish

Media Playback is a multimodal pattern for when the customer requests something for which Alexa's response is to play audio content in the vehicle. When playing media through the Audo SDK Embedded Application, display the Now Playing card on your device.

Left sided media player

(Required) Use the NowPlaying display card to display media.

Follow the METADATA AND IMAGES, SOURCE ATTRIBUTION, and PLAYER CONTROLS requirements.

(Required) Show the progress indicator on the NowPlaying display card when received from the media service provider.

This must show the time elapsed/time remaining as indicated in the example above. If you have a touch screen, customers must be able to scrub through the progress bar via touch. They can also control this via voice (i.e. “Alexa, fast forward 20 seconds”).

Toast:

Play Billie Eilish

Whether a customer is in the middle of viewing their vehicle’s information, following navigation, or engaged with some other driver-pertinent feature; they may want to change a song without changing their screen. To provide the best experience, we always recommend showing visual feedback whenever an action is performed. Holding true to this guidance, we request you surface a temporary toast in situations where a customer changes or requests a song while on a driver-focused screen.

Toast

(Required) If a customer taps the toast, launch the Now Playing view

The toast will indicate media currently playing. When tapped, you may display media in a native note playing view of the Alexa NowPlaying display card.

Mini-player

Mini player

In the vehicle, there are certain instances where a mini-media player is more beneficial to the customer than a full screen visual. Should your system support a mini-player, follow the requirements below to ensure you meet our branding guidelines.

(Required) Follow the METADATA AND IMAGES, SOURCE ATTRIBUTION, and PLAYER CONTROLS requirements.

If you show controls on your mini-player, only surface the imperative controls specific to the current playing source.