Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Develop
Test
Publish
Monetize
Engage users
Device specifications
Resources
Skip to main content
When users say to skip ahead or rewind by a specific duration (such as “Alexa, fast forward 5 minutes” or “Alexa, skip ahead 60 seconds”), the Alexa.SeekController interface sends an AdjustSeekPosition directive to your app or Lambda. Note that directives sent by the SeekController interface (such as the AdjustSeekPosition directive) are different from the fast-forward and rewind operations within the PlaybackController Interface because they include a specific duration for the offset.

Utterances for AdjustSeekPosition directives

Alexa sends AdjustSeekPosition directives to your app (for app-only integrations) or to your Lambda (for cloudside integrations) when users say the following utterances. As with other directives, when you receive a Discovery directive, you must specify the SeekController directives that your video skill supports.

Handling AdjustSeekPosition Directives

AdjustSeekPosition directives include a property in the payload called deltaPositionMilliseconds. The value of deltaPositionMilliseconds can be positive (seek forward) or negative (go backwards in the stream). For example, “Skip 5 minutes” would yield a deltaPositionMilliseconds value of 300000, whereas “Rewind 10 minutes” would yield a deltaPositionMilliseconds value of -600000. In other words, a negative value indicates rewind, and a positive value indicates fast forward. You must fulfill the user’s request by going forward by the specified offset.

Example AdjustSeekPosition Directive

The following is an example AdjustSeekPosition directive:
payload contains the following:

Payload Definitions

The following table describes the payload properties.
Payload Descriptions
FieldDescriptionData Type
deltaPositionMilliseconds
required
The relative milliseconds to seek on the playback on a media player. A positive or negative integer value could be used to seek forward or backwards in relation to the current seek position. Accepted values include any integer value between -86400000 and 86400000 (-/+ 24 hrs.). If the required position falls outside the duration of the media item, it should be set to the beginning or the end of it depending on if deltaPositionMilliseconds was negative or positive respectively.Example: 86400000integer
experience
optional
An object that optimizes the display of search results. With the experience object, you can change the search results based on the device your customer used to search. See Experience Types for more details about the experience object and its values.Object containing mode

Experience Types

Use the experience object to optimize the display of search results based on the device used to perform the search. For example, if a customers searches from a Fire TV remote, the experience object shows a large number of search results that the customer can browse through with a remote. However, if the search request is from an Echo paired to Fire TV, the experience object limits the number of results shown, and how they are displayed, allowing the customer to see results without using the remote. The experience object consists of a mode object, which determines how to display the search results. The mode object takes two values: VOICE_OPTIMIZED and DEFAULT.
  • VOICE_OPTIMIZED: The optimized display of search results for voice-only devices. Provides a list of results that customers can navigate via voice, without the need for a remote.
  • DEFAULT: The default displays of all search results list format, regardless of the device used for the search.
To ensure forward compatibility, fallback to DEFAULT instead of failing if you receive an unknown value in mode.

Response Example

If your app handled the directive successfully, your BroadcastReceiver class should send a success intent back with a success status, like this:
For more details, see Step 7: Add a Broadcast Receiver. Also see the AlexaDirectiveReceiver class in the sample app for a more specific code example.

Declaring Capability Support for this Interface

To receive SeekController directives in your app, you must indicate support for this interface when you declare your capabilities. See the following for more information on declaring capabilities with app-only integrations:
Last modified on June 9, 2021