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 sendsAdjustSeekPosition 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 exampleAdjustSeekPosition directive:
- App-only Integrations
- Cloudside Integrations
payload contains the following:Payload Definitions
The following table describes thepayload properties.
| Field | Description | Data Type |
|---|---|---|
deltaPositionMillisecondsrequired | 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: 86400000 | integer |
experienceoptional | 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 theexperience 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.
DEFAULT instead of failing if you receive an unknown value in mode.
Response Example
- App-only Integrations
- Cloudside Integrations
AlexaDirectiveReceiver class in the sample app for a more specific code example.Declaring Capability Support for this Interface
- App-only Integrations
- Cloudside Integrations
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:
