开发者控制台

错误处理 (VSK Fire TV)

错误处理 (VSK Fire TV)

如果Alexa向您的技能发送了请求,但您无法成功处理该请求,可使用Alexa.ErrorResponse事件进行响应。指定错误的类型及其发生的原因。

ErrorResponse事件的有效负载必须指定typemessage

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"
        }
    }
}