エラー処理


エラー処理

Alexaからスキルに送信されたリクエストを正常に処理できない場合は、Alexa.ErrorResponseイベントで応答し、エラーの種類と原因を指定します。応答は、同期または非同期のどちらでも実行できます。非同期で応答する場合は、相関トークン、および認証トークンを含むスコープを含めます。

ErrorResponseイベントのペイロードでは、typemessageを指定する必要があります。

Alexa.Video.ErrorResponse

Alexa.Video名前空間は、1つのエラーメッセージタイプを含みます。

説明
ACTION_NOT_PERMITTED_FOR_CONTENT リクエストされたアクションがコンテンツで許可されていないことを示します。たとえば、削除不可とマークされている録画をユーザーが削除しようとした場合などです。
CONFIRMATION_REQUIRED リクエストされたアクションを完了するために追加の確認が必要であることを示します。
CONTENT_NOT_RECORDABLE コンテンツの制限により録画操作が失敗したことを示します。
NOT_SUBSCRIBED チャンネルやその他のサブスクリプションベースのコンテンツをユーザーが定期購入していないことを示します。
RECORDING_EXISTS 録画が既に存在するため、録画リクエストが失敗したことを示します。
STORAGE_FULL DVRストレージに空き容量がないため、録画リクエストが失敗したことを示します。
TITLE_DISAMBIGUATION_REQUIRED 指定されたタイトルの候補が複数見つかり、録画する番組を決定するにはあいまいさを解消する必要があることを示します。この値は、対象のデバイスにあいまいさを解消するメカニズムがあることを示すために使用します。たとえば、放送される番組が複数あることや、録画をリクエストされたエンティティに関連付けられた番組が複数あることなどをこのエラーで示すことができます。
TUNER_OCCUPIED 別の録画とスケジュールが競合するため、録画リクエストが失敗したことを示します。

例: Alexa.Video.ErrorResponse

{
    "event": {
        "header": {
            "messageId": "4e02d3c8-85e8-4e32-8a1b-08c1d52122ad",
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/==",
            "name": "ErrorResponse",
            "namespace": "Alexa.Video",
            "payloadVersion": "3"
        },
        "endpoint": {
            "scope": {
                "type": "DirectedUserId",
                "directedUserId": "access-token-from-Amazon"
            },
            "endpointId": "videoDevice-001"
        },
        "payload": {
            "message": "Alexaによってログに記録されるエラーに関する追加情報",
            "type": "NOT_SUBSCRIBED"
        }
    }
}