错误处理 (VSK Fire TV)
错误处理 (VSK Fire TV)
注意: 这里的错误处理仅适用于VSK云端集成。对于仅限应用的集成,您只能以
true
或false
来回应,以表明您是否成功处理了该指令。请参阅步骤7: 添加广播接收器,了解有关在履行指令后发送响应的详细信息。如果Alexa向您的技能发送了请求,但您无法成功处理该请求,可使用Alexa.ErrorResponse
事件进行响应。指定错误的类型及其发生的原因。
ErrorResponse
事件的有效负载必须指定type
和message
。
Alexa.Video
命名空间中有一种错误消息类型。
类型 | 描述 |
---|---|
ACTION_NOT_PERMITTED_FOR_CONTENT |
表示内容不允许执行请求的操作。例如,如果用户尝试删除标记为不可删除的录制文件。 |
CONFIRMATION_REQUIRED |
表示必须额外进行确认才能完成请求的操作。 |
CONTENT_NOT_RECORDABLE |
表示由于内容限制,录制操作失败。 |
NOT_SUBSCRIBED |
用户未订阅某个频道的内容或其他基于订阅的内容。 |
RECORDING_EXISTS |
表示录制请求失败,因为录制文件已经存在。 |
STORAGE_FULL |
表示录制请求因为DVR存储空间已满而失败。 |
TITLE_DISAMBIGUATION_REQUIRED |
表示指定的标题产生了多个结果,需要消除歧义才能确定要录制的节目。该值应当用于表示目标设备将提供消除歧义的机制。例如,此错误可能表示一个节目有多次播出,或者请求录制的实体有多个与之相关的节目。 |
TUNER_OCCUPIED |
表示录制请求由于与其他录制文件发生日程冲突而失败。 |
INVALID_AUTHORIZATION_CREDENTIAL |
请求中的授权凭证无效。例如,OAuth 2.0访问令牌对用户的账户无效。 |
EXPIRED_AUTHORIZATION_CREDENTIAL |
请求中的OAuth 2.0访问令牌已过期。 |
示例: Alexa.Video.ErrorResponse
{
"event": {
"header": {
"messageId": "4e02d3c8-85e8-4e32-8a1b-08c1d52122ad",
"name": "ErrorResponse",
"namespace": "Alexa.Video",
"payloadVersion": "3"
},
"endpoint": {
"scope": {
"type": "DirectedUserId",
"directedUserId": "access-token-from-Amazon"
},
"endpointId": "videoDevice-001"
},
"payload": {
"message": "optional information about the error that will be logged by Alexa",
"type": "NOT_SUBSCRIBED"
}
}
}