Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://developer.amazon.com/docs/custom-skills/playback-controller-interface-reference.html below:

PlaybackController Interface Reference | Alexa Skills Kit

The PlaybackController interface provides requests to notify your skill when the user interacts with player controls, such as the buttons on a device, a remote control, or the next and previous tap controls on an Alexa-enabled device with a screen. Your skill can respond to these requests with AudioPlayer directives to start and stop playback.

Note: PlaybackController requests are not sent in response to voice requests such as "Alexa, next song." Voice requests are sent to your skill as built-in intents (such as AMAZON.NextIntent) via a normal IntentRequest request.

The PlaybackController interface has no directives.

Note: Some hardware devices don't support sending PlaybackController requests in response to button presses. For example, the Amazon Tap device handles pause button events locally, so your skill won't receive these requests when used on this device. The (pause) tap control on an Alexa-enabled device with a screen also handles the pause automatically and doesn't send a request.

PlaybackController sends the following requests to notify your skill about playback control events:

Important: The request doesn't include the session object because the request isn't sent in the context of a skill session. Use the context object to get details, such as the applicationId and userId.

{
  "version": "1.0",
  "context": {
    "System": {
      "application": {},
      "user": {},
      "device": {}
    },
    "AudioPlayer": {
      "token": "AAAABBBBCCCCCDDDDEEEEEFFFF",
      "offsetInMilliseconds": 0,
      "playerActivity": "PLAYING"
    }
  },
  "request": {
    "type": "PlaybackController.NextCommandIssued",
    "requestId": "amzn1.echo-api.request.aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "timestamp": "2018-04-11T15:15:25Z",
    "locale": "en-US"
  }
}

For the full request format, see [Request Format][service_ref#request-format] in the [JSON Interface Reference for Custom Skills][service_ref].

When responding to any

request, you can only respond with

. The response can't include any of the standard properties such as

,

, or

. Sending a response with these unsupported properties causes an error.

Note that the Alexa simulator on the Test page of the developer console doesn't support testing PlaybackController requests.

Sent when the user uses (next) with the intent to skip to the next audio item.

{
  "type": "PlaybackController.NextCommandIssued",
  "requestId": "unique.id.for.the.request",
  "timestamp": "timestamp of request in format: 2018-04-11T15:15:25Z",
  "locale": "a locale code such as en-US"
}

Your skill can respond to NextCommandIssued with any AudioPlayer directive.

The response cannot include:

• Any standard properties such as outputSpeech, card, or reprompt.
• Any other directives from other interfaces, such a [Dialog directive][dialog-interface-reference#directives].

Sent when the user uses (pause) with the intent to stop playback.

{
  "type": "PlaybackController.PauseCommandIssued",
  "requestId": "unique.id.for.the.request",
  "timestamp": "timestamp of request in format: 2018-04-11T15:15:25Z",
  "locale": "a locale code such as en-US"
}

Your skill can respond to PauseCommandIssued with any AudioPlayer directive.

The response cannot include:

• Any standard properties such as outputSpeech, card, or reprompt.
• Any other directives from other interfaces, such a [Dialog directive][dialog-interface-reference#directives].

Sent when the user uses (play) to start or resume playback.

{
  "type": "PlaybackController.PlayCommandIssued",
  "requestId": "unique.id.for.the.request",
  "timestamp": "timestamp of request in format: 2018-04-11T15:15:25Z",
  "locale": "a locale code such as en-US"
}

Your skill can respond to PlayCommandIssued with any AudioPlayer directive.

The response cannot include:

• Any standard properties such as outputSpeech, card, or reprompt.
• Any other directives from other interfaces, such a [Dialog directive][dialog-interface-reference#directives].

Sent when the user uses (previous) with the intent to go back to the previous audio item.

{
  "type": "PlaybackController.PreviousCommandIssued",
  "requestId": "unique.id.for.the.request",
  "timestamp": "timestamp of request in format: 2018-04-11T15:15:25Z",
  "locale": "a locale code such as en-US"
}

Your skill can respond to PreviousCommandIssued with any AudioPlayer directive.

The response cannot include:

• Any standard properties such as outputSpeech, card, or reprompt.
• Any other directives from other interfaces, such a [Dialog directive][dialog-interface-reference#directives].

If a response to a PlaybackController request causes an error, Alexa sends your skill a System.ExceptionEncountered request. Alexa ignores any directives included in the response to this request.

{
  "type": "System.ExceptionEncountered",
  "requestId": "unique.id.for.the.request",
  "timestamp": "timestamp of request in format: 2018-04-11T15:15:25Z",
  "locale": "a locale code such as en-US",
  "error": {
    "type": "error code such as INVALID_RESPONSE",
    "message": "description of the error that occurred"
  },
  "cause": {
    "requestId": "unique identifier for the request that caused the error"
  }
}

Your skill can't return a response to System.ExceptionEncountered request.

• Request and Response JSON Reference
• Request Types Reference
• AudioPlayer Interface Reference

Last updated: Nov 28, 2023

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4