音频控制请求

注意

该请求只适用于技能协议v2.1，v2.0中没有该请求

• 消息示例
• request参数说明
• 合法回复

若你的技能使用了音频播放器，当用户在设备的物理按键或者GUI界面上进行音频控制操作时，你将会收到以下请求。你的技能可以使用AudioPlayer指令来响应这些请求，以启动和停止播放。

提示

用户语音请求时不会发送PlaybackController请求。

请求类型分为

type取值	描述
PlaybackController.NextCommandIssued	用户按【下一首】切歌时，发送该请求
PlaybackController.PauseCommandIssued	用户按【暂停】时，发送该请求
PlaybackController.PlayCommandIssued	用户按【播放】或者【继续播放】按钮时，发送该请求
PlaybackController.PreviousCommandIssued	用户按【上一首】时，发送该请求

注意

这类请求不包含session字段，因为它们不是在技能会话上下文中发送的。你可以使用context对象获取诸如applicationId和userId等详细信息。

消息示例

{
  "version": "2.1",
  "context": {
    "System": {
      "application": {},
      "user": {},
      "device": {}
    },
    "AudioPlayer": {
      "token": "audioplayer-token...",
      "offsetInMilliseconds": 0,
      "playerActivity": "PLAYING"
    }
  },
  "request": {
    "type": "PlaybackController.NextCommandIssued",
    "requestId": "f78b7d68...",
    "timestamp": "2018-04-11T15:15:25Z",
  }
}

request参数说明

参数	描述	类型	必须出现
type	请求类型	String	是
requestId	代表请求的唯一标识符。	String	是
timestamp	请求时间戳，以ISO 8601格式发送	String	是

合法回复

在回复PlaybackController请求时，你的技能可以回复任何AudioPlayer指令。不能包含：

• 标准回复的任意字段，包括 outputSpeech, card, or reprompt
• 其他Interface的指令