Alexa.ThermostatController.Schedule.ErrorResponseインターフェース3.2

Alexa.ThermostatController.Schedule.ErrorResponseインターフェース3.2

Alexaから送信されたAlexa.ThermostatController.Scheduleディレクティブを正しく処理できなかった場合、スキルはAlexa.ThermostatController.Schedule.ErrorResponseイベントで応答します。詳細については、Alexa.ThermostatController.Scheduleを参照してください。

ErrorResponseイベント

Alexa.ThermostatController.Schedule.ErrorResponseのペイロードでは、エラータイプを指定し、エラー情報のメッセージを含めます。Alexa.ThermostatController.Scheduleのエラータイプのリストについては、エラータイプの値を参照してください。エラー応答は、同期応答または非同期応答で送信できます。詳細については、Alexa.ErrorResponseを参照してください。

ErrorResponseイベントの形式

クリップボードにコピーされました。

{
"event": {
    "header": {
      "namespace": "Alexa.ThermostatController.Schedule",
      "name": "ErrorResponse",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい",
      "correlationToken": "リクエストに一致するopaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint":{
      "endpointId": "エンドポイントID"
    },
    "payload": {
      "type": "エラータイプ",
      "message": "エラーメッセージ"
    }
  }
}

ErrorResponseイベントのペイロードのプロパティ

フィールド 説明 型 必須
type エラーのタイプです。Alexaはこれをユーザーと共有します。 文字列 ◯
message エラーのエラーメッセージ。この情報はユーザーには共有されません。 文字列 ◯

エラータイプの値

以下の表は、有効なAlexa.ThermostatController.Scheduleエラータイプの一覧です。

エラータイプ 説明
INSUFFICIENT_SPACE サーモスタットに十分な容量がありません。このエラーは、ユーザーが大量のスケジュールを設定し、デバイスの制限を超えた場合に発生する可能性があります。

Alexa.ThermostatController.Schedule.ErrorResponseエラータイプのほかに、INVALID_VALUEやTEMPERATURE_VALUE_OUT_OF_RANGEなどのAlexaエラータイプを設定できます。詳細については、Alexa.ErrorResponseエラータイプの値を参照してください。

Alexa.ThermostatController.Schedule.ErrorResponseの例

以下の例は、さまざまなエラータイプのペイロードを示しています。

INSUFFICIENT_SPACE

以下は、INSUFFICIENT_SPACEエラータイプのエラー応答の例です。

クリップボードにコピーされました。

{
  "event": {
    "header": {
      "namespace": "Alexa.ThermostatController.Schedule",
      "name": "ErrorResponse",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい",
      "correlationToken": "リクエストに一致するopaque相関トークン",
      "payloadVersion": "3.2"
    },
    "endpoint":{
      "endpointId": "エンドポイントID"
    },
    "payload": {
      "type": "INSUFFICIENT_SPACE",
      "message": "ユーザーはスケジュールエントリの制限を超えました。"
      }
  }
}

このページは役に立ちましたか？

最終更新日: 2024 年 07 月 11 日