# 音频控制请求

注意

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

若你的技能使用了音频播放器,当用户在设备的物理按键或者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的指令