調光式スイッチをAlexaに接続する



調光式スイッチをAlexaに接続する

機能インターフェースを使用して調光式スイッチをAlexaに接続する方法の例を以下に示します。

機能

調光式スイッチは次の機能を提供します。

機能 目的 サンプル発話

PowerController

ユーザーがデバイスをオンまたはオフにできます。

「プールの明かりをつけて」

BrightnessController

ユーザーが照明の明るさを制御できます。

「プールの明かりの明るさを30パーセントにして」

EndpointHealth

ユーザーがAlexaアプリなどのエクスペリエンスを使用してデバイスの状態の詳細なレポートを確認できます。

ありません。

Alexa

状態とエラーのレポートに関するディレクティブとイベントを含んでいます。検出に応答する際には、このインターフェースとサポートしているバージョンを明示的に示してください。

ありません。

検出

調光式スイッチは次のAddOrUpdateReportを提供します。

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "AddOrUpdateReport",
      "payloadVersion": "3",
      "messageId": "00000000-0000-0000-0000-000000000000"
    },
    "payload": {
      "endpoints": [
        {
          "endpointId": "appliance-001",
          "friendlyName": "プールの照明",
          "description": "サンプルメーカーのスマートスイッチ",
          "manufacturerName": "サンプルメーカー",
          "displayCategories": [
            "SWITCH"
          ],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PowerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "powerState"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.BrightnessController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "brightness"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.EndpointHealth",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "connectivity"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}

照明を制御するスイッチ向けのスマートホームスキルの作成の詳細については、照明用のスマートホームスキルを作成するを参照してください。

状態レポートの詳細については、スマートホームスキルの状態レポートについてを参照してください。

デバイスにその他の機能がある場合は、他の機能インターフェースを追加できます。