Alexa.RecordController界面 (VSK Fire TV)
Alexa.RecordController界面 (VSK Fire TV)
Alexa.RecordController
接口提供用于录制内容和结束当前录制操作的指令。为可以立即开始录制的设备实现此接口。如需了解可以计划要录制的内容的设备,请参阅Alexa.VideoRecorder。
有关RecordController
接口支持的区域设置列表,请参阅功能接口和支持的区域设置列表。
注意:
Alexa.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。 |
响应
当开始或停止录制的请求成功完成时,您应该在消息上下文中以状态为RecordingState
的Alexa.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日