开发者控制台

Alexa.RecordController界面 (VSK Fire TV)

Alexa.RecordController界面 (VSK Fire TV)

Alexa.RecordController接口提供用于录制内容和结束当前录制操作的指令。为可以立即开始录制的设备实现此接口。如需了解可以计划要录制的内容的设备,请参阅Alexa.VideoRecorder

有关RecordController接口支持的区域设置列表,请参阅功能接口和支持的区域设置列表

指令

StartRecording

开始录制当前播放内容的请求。

User: Alexa, start recording(Alexa,开始录制)

示例: StartRecording

{
    "header": {
        "payloadVersion": "3",
        "messageId": "abc-123-def-456",
        "namespace": "Alexa.RecordController",
        "name": "StartRecording",
        "correlationToken": "4d64dccb-bebc-4990-990a-abb922fd285d"
    },
       "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "video-endpoint-001",
      "cookie": {}
     },
    "payload": {
    }
}

StopRecording

停止当前录制操作的请求。

User: Alexa, stop recording(Alexa,停止录制)

示例: StopRecording

{
  "directive": {
    "header": {
      "namespace": "Alexa.RecordController",
      "name": "StopRecording",
      "messageId": "abc-123-def-456",
      "correlationToken": "4d64dccb-bebc-4990-990a-abb922fd285d",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "video-endpoint-001",
      "cookie": {}
     },
    "payload": {
    }
  }
}

属性和事件

对于此功能,您必须:

  • 以同步方式回复,这意味着您从Lambda函数向Alexa发送响应

当您发送响应时,应在消息的上下文中纳入接口属性的状态。

可报告的属性

属性名称 类型 描述
RecordingState RecordingState 指示终端是否正在录制。要么是RECORDING,要么是NOT_RECORDING。

响应

当开始或停止录制的请求成功完成时,您应该在消息上下文中以状态为RecordingStateAlexa.Response进行响应。

响应示例

{
  "context": {
    "properties": [{
      "name": "RecordingState",
      "namespace": "Alexa.RecordController",
      "timeOfSample": "2017-05-06T16:20:50.52Z",
      "uncertaintyInMilliseconds": 0,
      "value": "RECORDING"
    }]
  },
  "event": {
    "header": {
      "correlationToken": "4d64dccb-bebc-4990-990a-abb922fd285d",
      "messageId": "abc-123-def-456",
      "name": "Response",
      "namespace": "Alexa",
      "payloadVersion": "3"
    },
    "payload": {}
  }
}

有效负载详情

字段 描述 类型 必需
有效负载中没有必填字段或可选字段。 不适用 不适用

ErrorResponse

如果您由于某种原因无法完成客户请求,则应以错误来回应。有关更多信息,请参阅错误处理文档。


Last updated: 2021年6月9日