Alexa.EqualizerControllerインターフェース3

Note: Sign in to the developer console to build or publish your skill.

AlexaスキルにAlexa.EqualizerControllerインターフェースを実装すると、ユーザーはイコライザーの帯域やスマートエンターテイメントデバイスのサウンドモードを設定したり調整したりできます。エンターテイメントデバイスのスキルの詳細については、エンターテイメントデバイス用のスマートホームスキルを作成するを参照してください。

Alexa.EqualizerControllerインターフェースがサポートする言語については、Alexaインターフェースとサポートしている言語の一覧を参照してください。メッセージプロパティの定義については、Alexaインターフェースのメッセージとプロパティを参照してください。

発話

Alexa.EqualizerControllerインターフェースではプリビルド音声対話モデルを使用します。ユーザーが次のいずれかの発話をしたら、Alexaがそれに対応するディレクティブをスキルに送信します。

以下に、ユーザーの発話の例を示します。

Alexa, set bass to minus two on the speakers.
Alexa, increase bass on the stereo.
Alexa, increase bass by three on the stereo.
Alexa, reset bass on the TV.
Alexa, reset equalizer on the speakers.
Alexa, set mode to movie on the TV.

Alexa, règle les basses sur deux sur les haut-parleurs.
Alexa, augmente les basses sur la stéréo.
Alexa, augmente les basses par trois sur la stéréo.
Alexa, réinitialise les basses sur la télé.
Alexa, réinitialise l'égaliseur sur les haut-parleurs.
Alexa, mets le téléviseur en mode film.

Alexa, stelle (den) Bass auf minus zwei auf (dem) Lautsprecher.
Alexa, erhöhe den Bass (auf) der Stereoanlage.
Alexa, erhöhe den Bass (auf) der Stereoanlage um drei.
Alexa, Bass auf dem Fernseher zurücksetzen.
Alexa, Equalizer auf den Lautsprechern zurücksetzen.
Alexa, setze den Modus auf Film auf dem Fernseher.

Alexa, स्पीकर पर बास को माइनस दो पर सेट करें।
Alexa, स्टीरियो पर बास बढ़ाओ।
Alexa, स्टीरियो पर बास को तीन से बढ़ाएं।
Alexa, टीवी पर बास रीसेट करें
Alexa, स्पीकर पर इक्वलाइज़र रीसेट करें।
Alexa, टीवी पर मूवी के लिए मोड सेट करें।

Alexa, imposta i bassi su meno due sugli altoparlanti.
Alexa, aumenta i bassi sullo stereo.
Alexa, aumenta di tre i bassi sullo stereo.
Alexa, reimposta i bassi sulla TV.
Alexa, resetta l'equalizzatore sugli altoparlanti.
Alexa, imposta la modalità su film sulla TV.

アレクサ、スピーカーの低音域をマイナス2にして
アレクサ、ステレオの低音域を上げて
アレクサ、ステレオの低音域を3上げて
アレクサ、テレビの低音域をリセットして
アレクサ、イコライザーをリセットして
アレクサ、テレビをシネマモードにして

Alexa, diminua os graves em dois nos alto-falantes.
Alexa, aumenta os graves no estéreo.
Alexa, aumente os graves em três no estéreo.
Alexa, resetar os graves na t.v.
Alexa, reinicie o equalizador nos alto-falantes.
Alexa, coloque a t.v. no modo filme.

Alexa, pon los graves a menos dos en los altavoces.
Alexa, aumenta los graves en el estéreo.
Alexa, aumenta los graves del estéreo en tres.
Alexa, restablece los graves en la TV.
Alexa, restablece el ecualizador en los altavoces.
Alexa, configura el modo de película en el televisor.

Alexa, zet de bas van de speakers op min twee.
Alexa, verhoog de bas van de stereo.
Alexa, verhoog de bas van de stereo met drie.
Alexa, reset de bas van de tv.
Alexa, reset de equalizer van de speakers.
Alexa, zet de TV op filmmodus.

出力可能なプロパティ

Alexa.EqualizerControllerインターフェースは、bandsプロパティとmodeプロパティをサポートします。検出応答で、サポートするプロパティを指定します。

Bandsプロパティ

Alexa.EqualizerControllerインターフェースは、bandsプロパティを使用してデバイス上のイコライザーのさまざまな帯域および各帯域のレベルを指定します。bandsプロパティは、Bandオブジェクトの配列です。

以下の例では、3つの帯域の現在の値を出力しています。

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

{
  "name": "bands",
  "value": [
    {
      "name": "BASS",
      "value": 0
    },
    {
      "name": "MIDRANGE",
      "value": 3
    },
    {
      "name": "TREBLE",
      "value": 1
    }
  ]
},

以下の表は、Bandオブジェクト定義の一覧です。

プロパティ	説明	型
`name`	帯域の名前です。有効な値は `BASS`、`TREBLE`、`MIDRANGE`のいずれかです。	文字列
`value`	イコライザー帯域の専用周波数の値（レベル）を指定します。デバイスが検出応答でサポートしているレベルの範囲を指定します。	整数
`levelDirection`	帯域を調整する際、現在の設定に対してレベルを調整する方向を表します。有効な値は `UP`、`DOWN`のいずれかです。	文字列
`levelDelta`	帯域を調整する際、現在の設定に対してレベルを調整する量を表します。`levelDelta`を指定しない場合、レベルをデフォルトの量で調整します。	整数

Modeプロパティ

Alexa.EqualizerControllerインターフェースのmodeプロパティを指定すると、デバイスのイコライザーモードを指定できます。このプロパティは文字列で、有効な値はMOVIE、MUSIC、NIGHT、SPORT、TVのいずれかです。

以下は、modeプロパティの例です。

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

{
  "name": "mode",
  "value": "MOVIE"
}

検出

Alexa.EqualizerControllerをサポートするエンドポイントは、Alexa.Discoveryの標準検出メカニズムを使用して表します。

Alexaからスキルに状態レポートリクエストが送信されたら、レポートするプロパティのretrievableをtrueに設定します。変更レポートでAlexaにプロアクティブにレポートするプロパティのproactivelyReportedをtrueに設定します。

SPEAKER、TV、STREAMING_DEVICE、GAME_CONSOLEなどの適切な表示カテゴリーを使用します。表示カテゴリーの一覧は、表示カテゴリーを参照してください。

Alexaにデバイスの健全性を通知する場合、Alexa.EndpointHealthインターフェースも実装してください。

Configurationsオブジェクト

Alexa.EqualizerControllerには、標準の検出応答フィールドのほかに、次のフィールドを含むconfigurationsオブジェクトを含めます。少なくともbands、modesのいずれかを指定する必要があります。

プロパティ	説明	型
`bands`	デバイスがサポートする帯域です。デバイスがプリセットのイコライザーモードのみをサポートする場合、このフィールドを省略します。	オブジェクト
`bands.supported`	デバイスがサポートする帯域名です。有効な値は、`BASS`、`TREBLE`、`MIDRANGE`です。	配列
`bands.range`	デバイスがサポートする帯域レベルの`範囲`の最小値と最大値です。	オブジェクト
`modes`	デバイスがサポートするプリセットのイコライザーモードです。デバイスが帯域のみをサポートする場合、このフィールドを省略します。	オブジェクト
`modes.supported`	デバイスがサポートするモード名です。有効な値は `MOVIE`、`MUSIC`、`NIGHT`、`SPORT`、`TV`です。	配列

重要： デバイスがサポートする帯域またはモードが変わった場合など、エンドポイントの機能サポートが最初の検出応答以降に変更された場合は、AddOrUpdateReportメッセージを送信してAlexaに通知します。詳細については、AddOrUpdateReportを参照してください。

Rangeオブジェクト

値の範囲を表すには、rangeを使用します。

以下は、範囲の最小値と最大値の例です。

{
  "name": "range",
  "value": {
    "minimum": -100,
    "maximum": 100
  }
}

検出応答の例

以下は、Alexa.EqualizerControllerインターフェースとAlexa.PowerControllerインターフェースをサポートするテレビのDiscover.Responseメッセージの例です。テレビに推奨されるすべてのインターフェースの一覧については、スマートホームスキル用のデバイステンプレートを参照してください。

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

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "Discover.Response",
      "payloadVersion": "3",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
    },
    "payload": {
      "endpoints": [
        {
          "endpointId": "エンドポイントの一意のID",
          "manufacturerName": "エンドポイントのメーカー名",
          "description": "テレビメーカーのスマートテレビ",
          "friendlyName": "リビングのテレビ",
          "displayCategories": ["TV"],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.EqualizerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "bands"
                  },
                  {
                    "name": "mode"
                  }
                ],
                "retrievable": true,
                "proactivelyReported": true
              },
              "configurations": {
                "bands": {
                  "supported": [
                    {
                      "name": "BASS"
                    },
                    {
                      "name": "MIDRANGE"
                    },
                    {
                      "name": "TREBLE"
                    }
                  ],
                  "range": {
                    "minimum": -6,
                    "maximum": 6
                  }
                },
                "modes": {
                  "supported": [
                    {
                      "name": "MOVIE"
                    },
                    {
                      "name": "MUSIC"
                    },
                    {
                      "name": "SPORT"
                    }
                  ]
                }
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PowerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "powerState"
                  }
                ],
                "retrievable": true,
                "proactivelyReported": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}

ディレクティブ

Alexaは次のAlexa.EqualizerControllerインターフェースディレクティブをスキルに送信します。

SetModeディレクティブ

SetModeディレクティブをサポートすると、ユーザーがデバイスのオーディオモードを設定できます。

以下は、ユーザーの発話の例です。

Alexa, set mode to movie on the TV.

Alexa, mets le téléviseur en mode film.

Alexa, setze den Modus auf Film auf dem Fernseher.

Alexa, टीवी पर मूवी के लिए मोड सेट करें।

Alexa, imposta la modalità su film sulla TV.

アレクサ、テレビをシネマモードにして

Alexa, coloque a t.v. no modo filme.

Alexa, configura el modo de película en el televisor.

Alexa, zet de TV op filmmodus.

SetModeディレクティブの例

以下は、Alexaがスキルに送信するSetModeディレクティブの例です。

{
  "directive": {
    "header": {
      "namespace": "Alexa.EqualizerController",
      "name": "SetMode",
      "messageId": "一意のバージョン4 UUID",
      "correlationToken": "opaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID",
      "cookie": {}
    },
    "payload": {
       "mode": "MOVIE"
    }
  }
}

SetModeディレクティブペイロード

次の表は、SetModeディレクティブのペイロードの詳細を示しています。

プロパティ	説明	型
`mode`	デバイスに設定する`mode`です。	文字列

SetMode応答

SetModeディレクティブを正しく処理したら、Alexa.Responseイベントを使用して応答します。contextオブジェクトに、関連するすべてのプロパティの値を含めます。応答は同期または非同期のどちらでも可能です。非同期で応答する場合、認可トークンにスコープを含めます。

以下は、SetMode応答の例です。

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

{
  "event": {
    "header": {
      "namespace": "Alexa",
      "name": "Response",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい",
      "correlationToken": "リクエストに一致するopaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID"
    },
    "payload": {}
  },
  "context": {
    "properties": [
      {
        "namespace": "Alexa.EqualizerController",
        "name": "mode",
        "value": "MOVIE",
        "timeOfSample": "2017-02-03T16:20:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.EqualizerController",
        "name": "bands",
        "value": [
          {
            "name": "BASS",
            "value": 0
          },
          {
            "name": "MIDRANGE",
            "value": 3
          },
          {
            "name": "TREBLE",
            "value": 1
          }
        ],
        "timeOfSample": "2017-02-03T16:20:30.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.PowerController",
        "name": "powerState",
        "value": "ON",
        "timeOfSample": "2017-02-03T16:18:40.12Z",
        "uncertaintyInMilliseconds": 500
      }
    ]
  }
}

SetModeディレクティブのエラー処理

SetModeディレクティブを正しく処理できなかった場合は、Alexa.ErrorResponseイベントを使用して応答します。ユーザーがデバイスでサポートしていないモードをリクエストした場合、エラータイプにはINVALID_VALUEを使用します。

SetBandsディレクティブ

SetBandsディレクティブをサポートすると、ユーザーがデバイスのイコライザー帯域を設定できます。

以下は、ユーザーの発話の例です。

Alexa, set bass to minus two on the Living Room TV.

Alexa, règle les basses sur deux sur les haut-parleurs.

Alexa, stelle (den) Bass auf minus zwei auf (dem) Lautsprecher.

Alexa, लिविंग रूम टीवी पर बेस को माइनस दो पर सेट करो

Alexa, imposta i bassi su meno due sugli altoparlanti.

アレクサ、スピーカーの低音域をマイナス2にして

Alexa, diminua os graves em dois nos alto-falantes.

Alexa, pon los graves a menos dos en los altavoces.

Alexa, zet de bas van de woonkamertv op min twee.

SetBandsディレクティブの例

以下は、Alexaがスキルに送信するSetBandsディレクティブの例です。

{
  "directive": {
    "header": {
      "namespace": "Alexa.EqualizerController",
      "name": "SetBands",
      "messageId": "一意のバージョン4 UUID",
      "correlationToken": "opaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID",
      "cookie": {}
    },
    "payload": {
      "bands": [
        {
          "name": "BASS",
          "value": -2
        }
      ]
    }
  }
}

SetBandsディレクティブのペイロード

次の表は、SetBandsディレクティブのペイロードの詳細を示しています。

プロパティ	説明	型
`bands`	デバイスに設定する`bands`と、そのレベルを指定します。	配列

SetBands応答

SetBandsディレクティブを正しく処理したら、Alexa.Responseイベントを使用して応答します。contextオブジェクトに、関連するすべてのプロパティの値を含めます。応答は同期または非同期のどちらでも可能です。非同期で応答する場合、認可トークンにスコープを含めます。

以下は、SetBands応答の例です。

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

{
  "event": {
    "header": {
      "namespace": "Alexa",
      "name": "Response",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい",
      "correlationToken": "リクエストに一致するopaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID"
    },
    "payload": {}
  },
  "context": {
    "properties": [
      {
        "namespace": "Alexa.EqualizerController",
        "name": "mode",
        "value": "MOVIE",
        "timeOfSample": "2017-02-03T16:25:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.EqualizerController",
        "name": "bands",
        "value": [
          {
            "name": "BASS",
            "value": -2
          },
          {
            "name": "MIDRANGE",
            "value": 3
          },
          {
            "name": "TREBLE",
            "value": 1
          }
        ],
        "timeOfSample": "2017-02-03T16:20:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.PowerController",
        "name": "powerState",
        "value": "ON",
        "timeOfSample": "2017-02-03T16:18:40.12Z",
        "uncertaintyInMilliseconds": 500
      }
    ]
  }
}

SetBandsディレクティブのエラー処理

SetBandsディレクティブを正しく処理できなかった場合は、Alexa.ErrorResponseイベントを使用して応答します。ユーザーがデバイスでサポートしていない値や帯域をリクエストした場合、エラータイプにはINVALID_VALUEを使用します。

AdjustBandsディレクティブ

AdjustBandsディレクティブをサポートすると、ユーザーはデバイスのイコライザー帯域を現在の設定に対して相対的に調整できます。

以下は、ユーザーの発話の例です。

Alexa, increase bass by three on the stereo.

Alexa, augmente les basses par trois sur la stéréo.

Alexa, erhöhe den Bass (auf) der Stereoanlage um drei.

Alexa, स्टीरियो पर बास को तीन से बढ़ाएं।

Alexa, aumenta di tre i bassi sullo stereo.

アレクサ、ステレオの低音域を3上げて

Alexa, aumente os graves em três no estéreo.

Alexa, aumenta los graves del estéreo en tres.

Alexa, verhoog de bas van de stereo met drie.

AdjustBandsディレクティブの例

以下の例は、Alexaがスキルに送信するAdjustBandsディレクティブを示しています。

{
  "directive": {
    "header": {
      "namespace": "Alexa.EqualizerController",
      "name": "AdjustBands",
      "messageId": "一意のバージョン4 UUID",
      "correlationToken": "opaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID",
      "cookie": {}
    },
    "payload": {
      "bands": [
        {
          "name": "BASS",
          "levelDelta": 3,
          "levelDirection": "UP"
        }
      ]
    }
  }
}

AdjustBandsディレクティブのペイロード

次の表は、AdjustBandsディレクティブのペイロードの詳細を示しています。

プロパティ	説明	型
`bands`	デバイスで変更する`bands`と、各帯域のレベル調整を指定します。	配列

AdjustBands応答

AdjustBandsディレクティブを正しく処理したら、Alexa.Responseイベントを使用して応答します。contextオブジェクトに、関連するすべてのプロパティの値を含めます。応答は同期または非同期のどちらでも可能です。非同期で応答する場合、認可トークンにスコープを含めます。

以下は、AdjustBands応答の例です。

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

{
  "event": {
    "header": {
      "namespace": "Alexa",
      "name": "Response",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい",
      "correlationToken": "リクエストに一致するopaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID"
    },
    "payload": {}
  },
  "context": {
    "properties": [
      {
        "namespace": "Alexa.EqualizerController",
        "name": "mode",
        "value": "MOVIE",
        "timeOfSample": "2017-02-03T16:32:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.EqualizerController",
        "name": "bands",
        "value": [
          {
            "name": "BASS",
            "value": 1
          },
          {
            "name": "MIDRANGE",
            "value": 3
          },
          {
            "name": "TREBLE",
            "value": 1
          }
        ],
        "timeOfSample": "2017-02-03T16:20:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.PowerController",
        "name": "powerState",
        "value": "ON",
        "timeOfSample": "2017-02-03T16:18:40.12Z",
        "uncertaintyInMilliseconds": 500
      }
    ]
  }
}

AdjustBandsディレクティブのエラー処理

AdjustBandsディレクティブを正しく処理できなかった場合は、Alexa.ErrorResponseイベントを使用して応答します。ユーザーがデバイスでサポートしていない帯域をリクエストした場合、エラータイプにはINVALID_VALUEを使用します。

ResetBandsディレクティブ

ResetBandsディレクティブをサポートすると、ユーザーがデバイスのイコライザー帯域をデフォルト値にリセットできます。

以下は、ユーザーの発話の例です。

Alexa, reset bass on the TV.

Alexa, réinitialise les basses sur la télé.

Alexa, Bass auf dem Fernseher zurücksetzen.

Alexa, टीवी पर बास रीसेट करें

Alexa, reimposta i bassi sulla TV.

アレクサ、テレビの低音域をリセットして

Alexa, resetar os graves na t.v.

Alexa, restablece los graves en la TV.

Alexa, reset de bas van de tv.

ResetBandsディレクティブの例

以下は、Alexaがスキルに送信するResetBandsディレクティブの例です。

{
  "directive": {
    "header": {
      "namespace": "Alexa.EqualizerController",
      "name": "ResetBands",
      "messageId": "一意のバージョン4 UUID",
      "correlationToken": "opaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID",
      "cookie": {}
    },
    "payload": {
      "bands": [
        {
          "name": "BASS"
        },
        {
          "name": "MIDRANGE"
        },
        {
          "name": "TREBLE"
        }
      ]
    }
  }
}

ResetBandsディレクティブのペイロード

次の表は、ResetBandsディレクティブのペイロードの詳細を示しています。

プロパティ	説明	型
`bands`	デバイスでリセットする`bands`を指定します。	配列

ResetBands応答

ResetBandsディレクティブを正しく処理したら、Alexa.Responseイベントを使用して応答します。contextオブジェクトに、関連するすべてのプロパティの値を含めます。応答は同期または非同期のどちらでも可能です。非同期で応答する場合、認可トークンにスコープを含めます。

以下は、ResetBands応答の例です。

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

{
  "event": {
    "header": {
      "namespace": "Alexa",
      "name": "Response",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい",
      "correlationToken": "リクエストに一致するopaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID"
    },
    "payload": {}
  },
  "context": {
    "properties": [
      {
        "namespace": "Alexa.EqualizerController",
        "name": "mode",
        "value": "MOVIE",
        "timeOfSample": "2017-02-03T16:40:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.EqualizerController",
        "name": "bands",
        "value": [
          {
            "name": "BASS",
            "value": 0
          },
          {
            "name": "MIDRANGE",
            "value": 3
          },
          {
            "name": "TREBLE",
            "value": 1
          }
        ],
        "timeOfSample": "2017-02-03T16:20:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.PowerController",
        "name": "powerState",
        "value": "ON",
        "timeOfSample": "2017-02-03T16:18:40.12Z",
        "uncertaintyInMilliseconds": 500
      }
    ]
  }
}

ResetBandsディレクティブのエラー処理

ResetBandsディレクティブを正しく処理できなかった場合は、Alexa.ErrorResponseイベントを使用して応答します。ユーザーがデバイスでサポートしていない帯域をリクエストした場合、エラータイプにはINVALID_VALUEを使用します。

状態レポート

Alexaはエンドポイントの状態についての情報をリクエストするために、ReportStateディレクティブを送信します。AlexaがReportStateディレクティブを送信したら、それに対する応答としてStateReportイベントを送信します。この応答には、contextオブジェクトのすべてのretrievableプロパティの現在の状態を含めます。retrievableプロパティは検出応答で特定します。状態レポートの詳細については、状態および変更レポートについてを参照してください。

StateReport応答の例

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

{
  "event": {
    "header": {
      "namespace": "Alexa",
      "name": "StateReport",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい",
      "correlationToken": "リクエストに一致するopaque相関トークン",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID"
    },
    "payload": {}
  },
  "context": {
    "properties": [
      {
        "namespace": "Alexa.EqualizerController",
        "name": "mode",
        "value": "MOVIE",
        "timeOfSample": "2017-02-03T17:50:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.EqualizerController",
        "name": "bands",
        "value": [
          {
            "name": "BASS",
            "value": 0
          },
          {
            "name": "MIDRANGE",
            "value": 3
          },
          {
            "name": "TREBLE",
            "value": 1
          }
        ],
        "timeOfSample": "2017-02-03T16:20:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.PowerController",
        "name": "powerState",
        "value": "ON",
        "timeOfSample": "2017-02-03T16:18:40.12Z",
        "uncertaintyInMilliseconds": 500
      }
    ]
  }
}

変更レポート

エンドポイントの状態の変化をプロアクティブにレポートするために、ChangeReportイベントを送信します。プロアクティブにレポートするプロパティは検出応答で特定します。変更レポートの詳細については、状態および変更レポートについてを参照してください。

ChangeReportイベントの例

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

{  
  "event": {
    "header": {
      "namespace": "Alexa",
      "name": "ChangeReport",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "OAuth2.0ベアラートークン"
      },
      "endpointId": "エンドポイントID"
    },
    "payload": {
      "change": {
        "cause": {
          "type": "VOICE_INTERACTION"
        },
        "properties": [
          {
            "namespace": "Alexa.EqualizerController",
            "name": "mode",
            "value": "SPORT",
            "timeOfSample": "2017-02-03T18:20:50.52Z",
            "uncertaintyInMilliseconds": 0
          }
        ]
      }
    }
  },
  "context": {
    "properties": [
      {
        "namespace": "Alexa.EqualizerController",
        "name": "bands",
        "value": [
          {
            "name": "BASS",
            "value": 0
          },
          {
            "name": "MIDRANGE",
            "value": 3
          },
          {
            "name": "TREBLE",
            "value": 1
          }
        ],
        "timeOfSample": "2017-02-03T16:20:50.52Z",
        "uncertaintyInMilliseconds": 0
      },
      {
        "namespace": "Alexa.PowerController",
        "name": "powerState",
        "value": "ON",
        "timeOfSample": "2017-02-03T16:18:40.12Z",
        "uncertaintyInMilliseconds": 500
      }
    ]
  }
}

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

フィードバックを送信

最終更新日: 2024 年 12 月 02 日

Alexa.EqualizerControllerインターフェース3

発話

出力可能なプロパティ

Bandsプロパティ

Modeプロパティ

検出

Configurationsオブジェクト

Rangeオブジェクト

検出応答の例

ディレクティブ

SetModeディレクティブ

SetModeディレクティブの例

SetModeディレクティブペイロード

SetMode応答

SetModeディレクティブのエラー処理

SetBandsディレクティブ

SetBandsディレクティブの例

SetBandsディレクティブのペイロード

SetBands応答

SetBandsディレクティブのエラー処理

AdjustBandsディレクティブ

AdjustBandsディレクティブの例

AdjustBandsディレクティブのペイロード

AdjustBands応答

AdjustBandsディレクティブのエラー処理

ResetBandsディレクティブ

ResetBandsディレクティブの例

ResetBandsディレクティブのペイロード

ResetBands応答

ResetBandsディレクティブのエラー処理

状態レポート

StateReport応答の例

変更レポート

ChangeReportイベントの例

関連トピック

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