検出応答の例

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

検出応答の例

Alexa.Discoveryインターフェースを実装して、Alexaにユーザーのコネクテッドデバイスの機能について通知します。まず、検出応答の例を確認し、デバイスタイプに合ったものを見つけてください。これらのDiscover.Responseメッセージの例をスキルコードで使用できます。デバイスのニーズに合わせてインターフェースの追加・削除を行い、これらの例を変更してください。ほかの機能での検出応答の例を確認するには、各インターフェースのドキュメントを参照してください。

Alexaスキルでさまざまなインターフェースを組み合わせる方法の詳細については、スマートホームスキル用のデバイステンプレートを参照してください。

パン、チルト、ズームをサポートするカメラの例

以下は、玄関のカメラや子ども部屋のカメラといったセキュリティカメラを制御するAlexaスキルでDiscover.Responseイベントを使った例です。カメラは、Alexaデバイスとカメラの間の通信にAlexa.RTCSessionControllerインターフェースをサポートしています。また、カメラは、物理的に左右にパンしたり、上下にチルトしたり、ズームイン／ズームアウトしたりできます。スキルには、パン、チルト、ズームをサポートするAlexa.RangeControllerインターフェースを実装しています。

カメラはどのようなパン、チルト、ズームの機能もサポートできます。パンとチルトには、カメラの実視野（FOV）のパーセンテージとして範囲を指定します。たとえば、カメラが90度の水平FOVを持ち、合計360度回転できる場合、可動範囲は400%となります。合計サポート範囲は0～400や-200～200などのように定義できます。パンの範囲を-200～200として定義し、0が中央を表すようにします。チルトの範囲は-50～50で、ズーム範囲は0～200です。

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

{
  "event":{
    "header":{
      "namespace": "Alexa.Discovery",
      "name": "Discover.Response",
      "payloadVersion": "3",
      "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
    },
    "payload": {
      "endpoints": [
        {
          "endpointId": "エンドポイントの一意のID",
          "manufacturerName": "サンプルメーカー",
          "description": "Alexaアプリに表示される説明",
          "friendlyName": "玄関のカメラ",
          "displayCategories": ["CAMERA"],
          "additionalAttributes":  {
            "manufacturer" : "サンプルメーカー",
            "model" : "サンプルモデル",
            "serialNumber": "デバイスのシリアル番号",
            "firmwareVersion" : "デバイスのファームウェアバージョン",
            "softwareVersion": "デバイスのソフトウェアバージョン",
            "customIdentifier": "＜デバイスのカスタム識別子＞"
          },
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.RTCSessionController",
              "version": "3",
              "configuration": {
                "isFullDuplexAudioSupported": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.RangeController",
              "version": "3",
              "instance": "Camera.Pan",
              "capabilityResources": {
                "friendlyNames": [
                  {
                    "@type": "text",
                    "value": {
                      "text": "カメラのパン",
                      "locale": "ja-JP"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "カメラの回転",
                      "locale": "ja-JP"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "回転",
                      "locale": "ja-JP"
                    }
                  }
                ]
              },
              "properties": {
                "supported": [
                  {
                    "name": "rangeValue"
                  }
                ],
                "retrievable": true,
                "proactivelyReported": true
              },
              "configuration": {
                "supportedRange": {
                  "minimumValue": -200,
                  "maximumValue": 200,
                  "precision": 1
                },
                "presets": [
                  {
                    "rangeValue": -200,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "一番左",
                            "locale": "ja-JP"
                          }
                        }
                      ]
                    }
                  },
                  {
                    "rangeValue": 0,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "中央",
                            "locale": "ja-JP"
                          }
                        }
                      ]
                    }
                  },
                  {
                    "rangeValue": 200,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "一番右",
                            "locale": "ja-JP"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.RangeController",
              "version": "3",
              "instance": "Camera.Tilt",
              "capabilityResources": {
                "friendlyNames": [
                  {
                    "@type": "text",
                    "value": {
                      "text": "カメラのチルト",
                      "locale": "ja-JP"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "チルト",
                      "locale": "ja-JP"
                    }
                  }
                ]
              },
              "properties": {
                "supported": [
                  {
                    "name": "rangeValue"
                  }
                ],
                "retrievable": true,
                "proactivelyReported": true
              },
              "configuration": {
                "supportedRange": {
                  "minimumValue": -50,
                  "maximumValue": 50,
                  "precision": 1
                },
                "presets": [
                  {
                    "rangeValue": -50,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "下",
                            "locale": "ja-JP"
                          }
                        }
                      ]
                    }
                  },
                  {
                    "rangeValue": 0,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "中央",
                            "locale": "ja-JP"
                          }
                        }
                      ]
                    }
                  },
                  {
                    "rangeValue": 50,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "上",
                            "locale": "ja-JP"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.RangeController",
              "version": "3",
              "instance": "Camera.Zoom",
              "capabilityResources": {
                "friendlyNames": [
                  {
                    "@type": "text",
                    "value": {
                      "text": "カメラのズーム",
                      "locale": "ja-JP"
                    }
                  },
                  {
                    "@type": "text",
                    "value": {
                      "text": "ズーム",
                      "locale": "ja-JP"
                    }
                  }
                ]
              },
              "properties": {
                "supported": [
                  {
                    "name": "rangeValue"
                  }
                ],
                "retrievable": true,
                "proactivelyReported": true
              },
              "configuration": {
                "supportedRange": {
                  "minimumValue": 0,
                  "maximumValue": 200,
                  "precision": 50
                },
                "presets": [
                  {
                    "rangeValue": 0,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "ズームアウト",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "asset",
                          "value": {
                            "assetId": "Alexa.Value.Minimum"
                          }
                        }
                      ]
                    }
                  },
                  {
                    "rangeValue": 200,
                    "presetResources": {
                      "friendlyNames": [
                        {
                          "@type": "text",
                          "value": {
                            "text": "ズームイン",
                            "locale": "ja-JP"
                          }
                        },
                        {
                          "@type": "asset",
                          "value": {
                            "assetId": "Alexa.Value.Maximum"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            },
            {
                "type": "AlexaInterface",
                "interface": "Alexa.EndpointHealth",
                "version": "3.1",
                "properties": {
                    "supported": [{
                            "name": "connectivity"
                        }
                    ],
                    "proactivelyReported": true,
                    "retrievable": true
                }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}

エンターテイメントデバイスの例

以下は、エンターテイメントデバイスを制御するAlexaスキルでのDiscover.Responseイベントの例です。

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

{
    "event": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "payloadVersion": "3",
            "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
        },
        "payload": {
            "endpoints": [{
                "endpointId": "エンドポイントの一意のID",
                "manufacturerName": "サンプルメーカー",
                "description": "サンプルメーカーのブランド名",
                "friendlyName": "エンターテイメントシステム",
                "displayCategories": ["TV"],
                "additionalAttributes": {
                    "manufacturer": "サンプルメーカー",
                    "model": "サンプルモデル",
                    "serialNumber": "デバイスのシリアル番号",
                    "firmwareVersion": "デバイスのファームウェアバージョン",
                    "softwareVersion": "デバイスのソフトウェアバージョン",
                    "customIdentifier": "<デバイスのカスタム識別子>"
                },
                "cookie": {},
                "capabilities": [{
                        "type": "AlexaInterface",
                        "interface": "Alexa.PowerController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "powerState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.ChannelController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "channel"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.InputController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "input"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        },
                        "inputs": [{
                                "name": "HDMI1"
                            },
                            {
                                "name": "HDMI2"
                            }
                        ]
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.PlaybackController",
                        "version": "3",
                        "properties": {},
                        "supportedOperations": [
                            "Play",
                            "Pause",
                            "Stop"
                        ]
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.Speaker",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                    "name": "volume"
                                },
                                {
                                    "name": "muted"
                                }
                            ],
                            "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"
                    }
                ]
            }]
        }
    }
}

暖炉の例

以下は、暖炉を制御するAlexaスキルでのDiscover.Responseイベントの例です。この暖炉は、次のインターフェースを使用します。

Alexa.PowerControllerで暖炉のオン／オフを切り替えます。
Alexa.ColorControllerで炎の色を変更します。
Alexa.RangeControllerで、オンになっているバーナーの数を変更します。
Alexa.ModeControllerで、キャンプファイヤー、キャンドル、氷の炎の各モードを提供します。

この例は、スマートホームバーチャル暖炉スキルを作成するチュートリアルの一部です。詳細については、GitHubのSkill Sample: Smart Home Fireplace (Python)を参照してください。

ユーザーがより自由な言葉でAlexaに話しかけられるように、フレンドリー名を指定します。詳細については、フレンドリー名のリソースとアセットを参照してください。

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

{
    "event": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "payloadVersion": "3",
            "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
        },
        "payload": {
            "endpoints": [{
                "endpointId": "エンドポイントの一意のID",
                "manufacturerName": "サンプルメーカー",
                "description": "サンプルメーカーの暖炉",
                "friendlyName": "リビングの暖炉",
                "displayCategories": ["OTHER"],
                "additionalAttributes": {
                    "manufacturer": "サンプルメーカー",
                    "model": "サンプルモデル",
                    "serialNumber": "デバイスのシリアル番号",
                    "firmwareVersion": "デバイスのファームウェアバージョン",
                    "softwareVersion": "デバイスのソフトウェアバージョン",
                    "customIdentifier": "<デバイスのカスタム識別子>"
                },
                "cookie": {},
                "capabilities": [{
                        "type": "AlexaInterface",
                        "interface": "Alexa.PowerController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "powerState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.ColorController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "color"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.RangeController",
                        "instance": "Fireplace.Burners",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "rangeValue"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true,
                            "nonControllable": false
                        },
                        "capabilityResources": {
                            "friendlyNames": [{
                                "@type": "asset",
                                "value": {
                                    "assetId": "Alexa.Setting.Preset"
                                }
                            }]
                        },
                        "configuration": {
                            "supportedRange": {
                                "minimumValue": 1,
                                "maximumValue": 3,
                                "precision": 1
                            },
                            "presets": [{
                                    "rangeValue": 1,
                                    "presetResources": {
                                        "friendlyNames": [{
                                                "@type": "asset",
                                                "value": {
                                                    "assetId": "Alexa.Value.Low"
                                                }
                                            },
                                            {
                                                "@type": "asset",
                                                "value": {
                                                    "assetId": "Alexa.Value.Minimum"
                                                }
                                            },
                                            {
                                                "@type": "text",
                                                "value": {
                                                    "text": "最小",
                                                    "locale": "ja-JP"
                                                }
                                            }
                                        ]
                                    }
                                },
                                {
                                    "rangeValue": 2,
                                    "presetResources": {
                                        "friendlyNames": [{
                                                "@type": "asset",
                                                "value": {
                                                    "assetId": "Alexa.Value.Medium"
                                                }
                                            },
                                            {
                                                "@type": "text",
                                                "value": {
                                                    "text": "標準",
                                                    "locale": "ja-JP"
                                                }
                                            }
                                        ]
                                    }
                                },
                                {
                                    "rangeValue": 3,
                                    "presetResources": {
                                        "friendlyNames": [{
                                                "@type": "asset",
                                                "value": {
                                                    "assetId": "Alexa.Value.Maximum"
                                                }
                                            },
                                            {
                                                "@type": "asset",
                                                "value": {
                                                    "assetId": "Alexa.Value.High"
                                                }
                                            },
                                            {
                                                "@type": "text",
                                                "value": {
                                                    "text": "最大",
                                                    "locale": "ja-JP"
                                                }
                                            }
                                        ]
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.ModeController",
                        "instance": "Fireplace.FlameType",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "mode"
                            }],
                            "retrievable": true,
                            "proactivelyReported": true,
                            "nonControllable": false
                        },
                        "capabilityResources": {
                            "friendlyNames": [{
                                    "@type": "text",
                                    "value": {
                                        "text": "炎のタイプ",
                                        "locale": "ja-JP"
                                    }
                                },
                                {
                                    "@type": "text",
                                    "value": {
                                        "text": "炎",
                                        "locale": "ja-JP"
                                    }
                                }
                            ]
                        },
                        "configuration": {
                            "ordered": false,
                            "supportedModes": [{
                                    "value": "FlameType.Campfire",
                                    "modeResources": {
                                        "friendlyNames": [{
                                                "@type": "text",
                                                "value": {
                                                    "text": "標準",
                                                    "locale": "ja-JP"
                                                }
                                            },
                                            {
                                                "@type": "text",
                                                "value": {
                                                    "text": "キャンプファイヤー",
                                                    "locale": "ja-JP"
                                                }
                                            }
                                        ]
                                    }
                                },
                                {
                                    "value": "FlameType.Candle",
                                    "modeResources": {
                                        "friendlyNames": [{
                                                "@type": "text",
                                                "value": {
                                                    "text": "キャンドル",
                                                    "locale": "ja-JP"
                                                }
                                            },
                                            {
                                                "@type": "text",
                                                "value": {
                                                    "text": "キャンドルライト",
                                                    "locale": "ja-JP"
                                                }
                                            }
                                        ]
                                    }
                                },
                                {
                                    "value": "FlameType.IceFlame",
                                    "modeResources": {
                                        "friendlyNames": [{
                                                "@type": "text",
                                                "value": {
                                                    "text": "氷モード",
                                                    "locale": "ja-JP"
                                                }
                                            },
                                            {
                                                "@type": "text",
                                                "value": {
                                                    "text": "氷の炎",
                                                    "locale": "ja-JP"
                                                }
                                            },
                                            {
                                                "@type": "text",
                                                "value": {
                                                    "text": "氷",
                                                    "locale": "ja-JP"
                                                }
                                            }
                                        ]
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.ModeController",
                        "instance": "Fireplace.CurrentFlameType",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "mode"
                            }],
                            "retrievable": true,
                            "proactivelyReported": true,
                            "nonControllable": true
                        },
                        "capabilityResources": {
                            "friendlyNames": [{
                                "@type": "text",
                                "value": {
                                    "text": "現在の炎のタイプ",
                                    "locale": "ja-JP"
                                }
                            }]
                        },
                        "configuration": {
                            "ordered": false,
                            "supportedModes": [{
                                    "value": "CurrentFlameType.Campfire",
                                    "modeResources": {
                                        "friendlyNames": [{
                                            "@type": "text",
                                            "value": {
                                                "text": "キャンプファイヤー",
                                                "locale": "ja-JP"
                                            }
                                        }]
                                    }
                                },
                                {
                                    "value": "CurrentFlameType.Candle",
                                    "modeResources": {
                                        "friendlyNames": [{
                                            "@type": "text",
                                            "value": {
                                                "text": "キャンドル",
                                                "locale": "ja-JP"
                                            }
                                        }]
                                    }
                                },
                                {
                                    "value": "CurrentFlameType.Ice",
                                    "modeResources": {
                                        "friendlyNames": [{
                                            "@type": "text",
                                            "value": {
                                                "text": "氷",
                                                "locale": "ja-JP"
                                            }
                                        }]
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.EndpointHealth",
                        "version": "3.1",
                        "properties": {
                            "supported": [{
                                "name": "connectivity"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa",
                        "version": "3"
                    }
                ]
            }]
        }
    }
}

ギターアンプの例

以下は、ギターアンプを制御するAlexaスキルでのDiscover.Responseイベントの例です。

この例では、ユーザーがより自由な言葉でAlexaに話しかけられるように、フレンドリー名を指定します。詳細については、フレンドリー名のリソースとアセットを参照してください。

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

{
    "event": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "payloadVersion": "3",
            "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
        },
        "payload": {
            "endpoints": [{
                "endpointId": "エンドポイントの一意のID",
                "manufacturerName": "サンプルメーカー",
                "description": "サンプルメーカーのスマートアンプ",
                "friendlyName": "ギターアンプ",
                "displayCategories": ["OTHER"],
                "additionalAttributes": {
                    "manufacturer": "サンプルメーカー",
                    "model": "サンプルモデル",
                    "serialNumber": "デバイスのシリアル番号",
                    "firmwareVersion": "デバイスのファームウェアバージョン",
                    "softwareVersion": "デバイスのソフトウェアバージョン",
                    "customIdentifier": "<デバイスのカスタム識別子>"
                },
                "capabilities": [{
                        "type": "AlexaInterface",
                        "interface": "Alexa.PowerController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "powerState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.Speaker",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                    "name": "volume"
                                },
                                {
                                    "name": "muted"
                                }
                            ],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.EqualizerController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "bands"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        },
                        "configurations": {
                            "bands": {
                                "supported": [{
                                        "name": "BASS"
                                    },
                                    {
                                        "name": "MIDRANGE"
                                    },
                                    {
                                        "name": "TREBLE"
                                    }
                                ],
                                "range": {
                                    "minimum": 1,
                                    "maximum": 10
                                }
                            }
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.ToggleController",
                        "version": "3",
                        "instance": "SampleManufacturer.Amp.OverDrive",
                        "capabilityResources": {
                            "friendlyNames": [{
                                    "@type": "text",
                                    "value": {
                                        "text": "Overdrive",
                                        "locale": "ja-JP"
                                    }
                                },
                                {
                                    "@type": "text",
                                    "value": {
                                        "text": "オーバードライブ",
                                        "locale": "ja-JP"
                                    }
                                }
                            ]
                        },
                        "properties": {
                            "supported": [{
                                "name": "toggleState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true,
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.RangeController",
                        "version": "3",
                        "instance": "SampleManufacturer.Amp.Gain",
                        "capabilityResources": {
                            "friendlyNames": [{
                                    "@type": "text",
                                    "value": {
                                        "text": "ゲイン",
                                        "locale": "ja-JP"
                                    }
                                },
                                {
                                    "@type": "text",
                                    "value": {
                                        "text": "ドライブ",
                                        "locale": "ja-JP"
                                    }
                                }
                            ]
                        },
                        "properties": {
                            "supported": [{
                                "name": "rangeValue"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        },
                        "configuration": {
                            "supportedRange": {
                                "minimumValue": 1,
                                "maximumValue": 10,
                                "precision": 1
                            },
                            "presets": []
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.ModeController",
                        "version": "3",
                        "instance": "SampleManufacturer.Amp.Presets",
                        "capabilityResources": {
                            "friendlyNames": [{
                                    "@type": "text",
                                    "value": {
                                        "text": "プリセット",
                                        "locale": "ja-JP"
                                    }
                                },
                                {
                                    "@type": "text",
                                    "value": {
                                        "text": "エフェクト",
                                        "locale": "ja-JP"
                                    }
                                }
                            ]
                        },
                        "properties": {
                            "supported": [{
                                "name": "mode"
                            }],
                            "retrievable": true,
                            "proactivelyReported": true
                        },
                        "configuration": {
                            "ordered": false,
                            "supportedModes": [{
                                    "value": "Preset.Normal",
                                    "modeResources": {
                                        "friendlyNames": [{
                                                "@type": "text",
                                                "value": {
                                                    "text": "Normal",
                                                    "locale": "en-US"
                                                }
                                            },
                                            {
                                                "@type": "text",
                                                "value": {
                                                    "text": "Standard",
                                                    "locale": "en-US"
                                                }
                                            }
                                        ]
                                    }
                                },
                                {
                                    "value": " Preset.LowGain",
                                    "modeResources": {
                                        "friendlyNames": [{
                                            "@type": "text",
                                            "value": {
                                                "text": "ローゲイン",
                                                "locale": "ja-JP"
                                            }
                                        }]
                                    }
                                },
                                {
                                    "value": " Preset.LeadBoost",
                                    "modeResources": {
                                        "friendlyNames": [{
                                            "@type": "text",
                                            "value": {
                                                "text": "リードブースト",
                                                "locale": "ja-JP"
                                            }
                                        }]
                                    }
                                },
                                {
                                    "value": " Preset.Metal",
                                    "modeResources": {
                                        "friendlyNames": [{
                                            "@type": "text",
                                            "value": {
                                                "text": "メタル",
                                                "locale": "ja-JP"
                                            }
                                        }]
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.EndpointHealth",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "connectivity"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa",
                        "version": "3"
                    }
                ]
            }]
        }
    }
}

アクションの確認を求めるサーモスタットの例

注：現時点で、アクションの確認は日本にあるデバイス向けに日本語のみでサポートされています。

以下は、サーモスタットを制御するAlexaスキルでのDiscover.Responseイベントの例です。このスキルは、Alexa.PowerControllerインターフェースを使用してサーモスタットのオン／オフを切り替え、Alexa.ThermostatControllerインターフェースを使用して温度とモードを制御します。

このスキルでは、Alexaがアクションを実行する前にこのエンドポイントに対するアクションの確認を求めます。そのため、Discover.Responseには、アクションの確認をサポートするインターフェースごとにverificationsRequiredオブジェクトが含まれています。詳細については、VerificationsRequiredオブジェクトを参照してください。

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

{
    "event": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "payloadVersion": "3",
            "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
        },
        "payload": {
            "endpoints": [{
                "endpointId": "エンドポイントの一意のID",
                "manufacturerName": "サンプルメーカー",
                "description": "サーモスタットメーカー製のスマートサーモスタット",
                "friendlyName": "廊下のサーモスタット",
                "displayCategories": ["THERMOSTAT", "TEMPERATURE_SENSOR"],
                "additionalAttributes": {
                    "manufacturer": "サンプルメーカー",
                    "model": "サンプルモデル",
                    "serialNumber": "デバイスのシリアル番号",
                    "firmwareVersion": "デバイスのファームウェアバージョン",
                    "softwareVersion": "デバイスのソフトウェアバージョン",
                    "customIdentifier": "＜デバイスのカスタム識別子＞"
                },
                "cookie": {},
                "capabilities": [{
                        "type": "AlexaInterface",
                        "interface": "Alexa.ThermostatController",
                        "version": "3.1",
                        "properties": {
                            "supported": [{
                                    "name": "targetSetpoint"
                                },
                                {
                                    "name": "thermostatMode"
                                }
                            ],
                            "proactivelyReported": true,
                            "retrievable": true
                        },
                        "configuration": {
                            "supportedModes": ["OFF", "COOL"],
                            "supportsScheduling": false
                        },
                        "verificationsRequired": [{
                                "directive": "SetTargetTemperature",
                                "methods": [{
                                    "@type": "Confirmation"
                                }]
                            },
                            {
                                "directive": "SetThermostatMode",
                                "methods": [{
                                    "@type": "Confirmation"
                                }]
                            }
                        ]
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.PowerController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "powerState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        },
                        "verificationsRequired": [{
                                "directive": "TurnOn",
                                "methods": [{
                                    "@type": "Confirmation"
                                }]
                            },
                            {
                                "directive": "TurnOff",
                                "methods": [{
                                    "@type": "Confirmation"
                                }]
                            }
                        ]
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.EndpointHealth",
                        "version": "3.1",
                        "properties": {
                            "supported": [{
                                    "name": "connectivity"
                                }
                            ],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa",
                        "version": "3"
                    }
                ]
            }]
        }
    }
}

ビデオデバイスの例

以下は、ビデオデバイスを制御するAlexaスキルでのDiscover.Responseイベントの例です。

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

{
    "event": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "payloadVersion": "3",
            "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
        },
        "payload": {
            "endpoints": [{
                "endpointId": "エンドポイントの一意のID",
                "manufacturerName": "サンプルメーカー",
                "description": "Alexaアプリに表示される説明",
                "friendlyName": "2階のテレビ",
                "displayCategories": ["TV"],
                "additionalAttributes": {
                    "manufacturer": "サンプルメーカー",
                    "model": "サンプルモデル",
                    "serialNumber": "デバイスのシリアル番号",
                    "firmwareVersion": "デバイスのファームウェアバージョン",
                    "softwareVersion": "デバイスのソフトウェアバージョン",
                    "customIdentifier": "<デバイスのカスタム識別子>"
                },
                "capabilities": [{
                        "type": "AlexaInterface",
                        "interface": "Alexa.RemoteVideoPlayer",
                        "version": "3.1",
                        "properties": {},
                        "configurations": {
                            "operations": ["SearchAndPlay"],
                            "entityTypes": ["MediaType", "League", "Sport", "SportsTeam"],
                            "catalogs": [{
                                    "type": "VIDEO_INGESTION_IDENTIFIER",
                                    "sourceId": "ABCD"
                                },
                                {
                                    "type": "VIDEO_PUBLIC_CATALOG_IDENTIFIER",
                                    "sourceId": "imdb"
                                }
                            ]
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.ChannelController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "channel"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "interface": "Alexa.PlaybackController ",
                        "type": "AlexaInterface",
                        "version": "3",
                        "supportedOperations": ["Play", "Pause", "Stop"]
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.PlaybackStateReporter",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "playbackState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.VideoRecorder",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                    "name": "isExtendedRecordingGUIShown"
                                },
                                {
                                    "name": "storageLevel"
                                }
                            ],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.Launcher",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "target"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.EndpointHealth",
                        "version": "3.1",
                        "properties": {
                            "supported": [{
                                "name": "connectivity"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa",
                        "version": "3"
                    }
                ]
            }]
        }
    }
}

給湯器の例

以下は、給湯器で説明されている給湯器を制御するAlexaスキルでのDiscover.Responseイベントの例です。

この例ではAlexa.ToggleControllerインターフェースを使用してAlexa Hunches（日本未対応）をサポートします。Alexa Hunchesの詳細については、What Are Alexa Hunches?およびEnable Alexa to Proactively Act on Hunches Without Customers Needing to Askを参照してください。

この例ではまた、Alexa.DeviceUsage.Meterインターフェースを使用して、ユーザーがAlexaエネルギーダッシュボードでエネルギー使用量を管理できるようにもしています。詳細については、Smart Home Energy Overviewを参照してください。

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

{
    "event": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "payloadVersion": "3",
            "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
        },
        "payload": {
            "endpoints": [{
                "endpointId": "エンドポイントの一意のID",
                "manufacturerName": "サンプルメーカー",
                "description": "Alexaアプリに表示される説明",
                "friendlyName": "給湯器",
                "displayCategories": ["WATER_HEATER"],
                "additionalAttributes": {
                    "manufacturer": "サンプルメーカー",
                    "model": "サンプルモデル",
                    "serialNumber": "デバイスのシリアル番号",
                    "firmwareVersion": "デバイスのファームウェアバージョン",
                    "softwareVersion": "デバイスのソフトウェアバージョン",
                    "customIdentifier": "<デバイスのカスタム識別子>"
                },
                "cookie": {},
                "capabilities": [

                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.ToggleController",
                        "version": "3",
                        "instance": "EnergySaverMode",
                        "capabilityResources": {
                            "friendlyNames": [{
                                "@type": "text",
                                "value": {
                                    "text": "省エネモード",
                                    "locale": "ja-JP"
                                }
                            }]
                        },
                        "properties": {
                            "supported": [{
                                "name": "toggleState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        },
                        "semantics": {
                            "actionMappings": [{
                                    "@type": "ActionsToDirective",
                                    "actions": ["Alexa.Actions.SetEcoOff"],
                                    "directive": {
                                        "name": "TurnOff",
                                        "payload": {}
                                    }
                                },
                                {
                                    "@type": "ActionsToDirective",
                                    "actions": ["Alexa.Actions.SetEcoOn"],
                                    "directive": {
                                        "name": "TurnOn",
                                        "payload": {}
                                    }
                                }
                            ],
                            "stateMappings": [{
                                    "@type": "StatesToValue",
                                    "states": ["Alexa.States.EcoOff"],
                                    "value": "OFF"
                                },
                                {
                                    "@type": "StatesToValue",
                                    "states": ["Alexa.States.EcoOn"],
                                    "value": "ON"
                                }
                            ]
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.DeviceUsage.Meter",
                        "version": "1.0",
                        "configurations": {
                            "energySources": {
                                "electricity": {
                                    "unit": "MILLIWATT_HOUR",
                                    "measuringMethod": "ESTIMATED",
                                    "defaultResolution": 3600
                                }
                            }
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.PowerController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "powerState"
                            }],
                            "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"
                    }
                ]
            }]
        }
    }
}

Wi-Fiルーターの例

以下は、Wi-Fiルーターで説明されているWi-Fiルーターを制御するAlexaスキルでのDiscover.Responseイベントの例です。

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

{
    "event": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "payloadVersion": "3",
            "messageId": "一意の識別子、バージョン4 UUIDが望ましい"
        },
        "payload": {
            "endpoints": [{
                "endpointId": "エンドポイントの一意のID",
                "manufacturerName": "サンプルメーカー",
                "description": "サンプルメーカーのWi-Fiルーター",
                "friendlyName": "ゲストWi-Fi",
                "displayCategories": ["OTHER"],
                "additionalAttributes": {
                    "manufacturer": "サンプルメーカー",
                    "model": "サンプルモデル",
                    "serialNumber": "デバイスのシリアル番号",
                    "firmwareVersion": "デバイスのファームウェアバージョン",
                    "softwareVersion": "デバイスのソフトウェアバージョン",
                    "customIdentifier": "<デバイスのカスタム識別子>"
                },
                "cookie": {},
                "capabilities": [{
                        "type": "AlexaInterface",
                        "interface": "Alexa.ToggleController",
                        "version": "3",
                        "instance": "GuestWiFi",
                        "capabilityResources": {
                            "friendlyNames": [{
                                    "@type": "asset",
                                    "value": {
                                        "assetId": "Alexa.Setting.GuestWiFi"
                                    }
                                },
                                {
                                    "@type": "text",
                                    "value": {
                                        "text": "ゲスト",
                                        "locale": "ja-JP"
                                    }
                                },
                                {
                                    "@type": "text",
                                    "value": {
                                        "text": "ゲストアクセス",
                                        "locale": "ja-JP"
                                    }
                                }
                            ]
                        },
                        "properties": {
                            "supported": [{
                                "name": "toggleState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.EndpointHealth",
                        "version": "3.1",
                        "properties": {
                            "supported": [{
                                "name": "connectivity"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa",
                        "version": "3"
                    }
                ]
            }]
        }
    }
}

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

フィードバックを送信

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

検出応答の例

パン、チルト、ズームをサポートするカメラの例

エンターテイメントデバイスの例

暖炉の例

ギターアンプの例

アクションの確認を求めるサーモスタットの例

ビデオデバイスの例

給湯器の例

Wi-Fiルーターの例

関連トピック

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