Alexa.DoorbellEventSourceインターフェース3
ドアベルのイベントを発生させるAlexa.DoorbellEventSourceインターフェースをAlexaスキルに実装します。ユーザーは、どのEchoデバイスでドアベルイベントに応答するかを選択します。Alexaは、アナウンス、モバイル通知、定型アクションなどのユースケースにドアベルイベントを使用します。セキュリティスキルの詳細については、スマートホームセキュリティの概要を参照してください。
ドアベルイベントが発生すると、Alexaは選択したEchoデバイスでドアベルのアナウンスを再生します。ユーザーが画面の付いていないEchoデバイスを選択した場合、Echoデバイスはドアベルのアナウンスを再生します。ユーザーがEcho Showデバイスを選択し、ドアベルにAlexa.RTCSessionControllerインターフェースが実装されている場合、ドアベルイベントが発生すると、Echo Showデバイスはドアベルのアナウンスを再生し、ドアベルのビデオカメラからのライブフィードを自動的に表示します。
Alexa.DoorbellEventSourceインターフェースがサポートする言語については、Alexaインターフェースとサポートしている言語の一覧を参照してください。メッセージプロパティの定義については、Alexaインターフェースのメッセージとプロパティを参照してください。
発話
Alexa.DoorbellEventSourceインターフェースにはユーザー発話はありません。
出力可能なプロパティ
Alexa.DoorbellEventSourceインターフェースは、出力可能なプロパティを定義しません。
検出
Alexa.DoorbellEventSourceをサポートするエンドポイントは、Alexa.Discoveryの標準検出メカニズムを使用して表します。
表示カテゴリーには、DOORBELLを使用します。デバイスがカメラ付きのビデオドアベルの場合は、表示カテゴリーにCAMERAとDOORBELLを使用します。表示カテゴリーの一覧は、表示カテゴリーを参照してください。
Alexaにデバイスの健全性を通知する場合、Alexa.EndpointHealthインターフェースも実装してください。
displayCategoriesリストにDOORBELLを指定する前にCAMERAを指定してください。検出応答の例
{
"event": {
"header": {
"namespace": "Alexa.Discovery",
"name": "Discover.Response",
"payloadVersion": "3",
"messageId": "一意の識別子、バージョン4 UUIDが望ましい"
},
"payload": {
"endpoints": [{
"endpointId": "エンドポイントの一意のID",
"manufacturerName": "サンプルメーカー",
"description": "Alexaアプリに表示される説明",
"friendlyName": "Alexaアプリに表示されるデバイス名",
"displayCategories": ["CAMERA", "DOORBELL"],
"additionalAttributes": {
"manufacturer": "サンプルメーカー",
"model": "サンプルモデル",
"serialNumber": "デバイスのシリアル番号",
"firmwareVersion": "デバイスのファームウェアバージョン",
"softwareVersion": "デバイスのソフトウェアバージョン",
"customIdentifier": "デバイスのカスタム識別子"
},
"cookie": {},
"capabilities": [{
"type": "AlexaInterface",
"interface": "Alexa.DoorbellEventSource",
"version": "3",
"proactivelyReported": true
},
{
"type": "AlexaInterface",
"interface": "Alexa.EndpointHealth",
"version": "3.1",
"properties": {
"supported": [{
"name": "connectivity"
}],
"proactivelyReported": true,
"retrievable": true
}
},
{
"type": "AlexaInterface",
"interface": "Alexa",
"version": "3"
}
]
}]
}
}
}
ディレクティブとイベント
Alexa.DoorbellEventSourceインターフェースはディレクティブを定義しません。
DoorbellPressイベント
デバイスでドアベルが押されたことを検知するたびに、DoorbellPressイベントをAlexaイベントゲートウェイに送信します。詳細については、イベントゲートウェイにイベントを送信するを参照してください。
スキルがDoorbellPressイベントを出力したら、同じデバイスに対して別のDoorbellPressイベントを送信する前に、30秒以上待機する必要があります。
DoorbellPressイベントの例
以下は、DoorbellPressイベントの例です。
{
"context": { },
"event": {
"header": {
"messageId": "一意の識別子、バージョン4 UUIDが望ましい",
"namespace" : "Alexa.DoorbellEventSource",
"name": "DoorbellPress",
"payloadVersion": "3"
},
"endpoint": {
"scope": {
"type": "BearerToken",
"token": "access-token-from-Amazon"
},
"endpointId": "appliance-001"
},
"payload" : {
"cause": {
"type": "PHYSICAL_INTERACTION"
},
"timestamp": "2018-06-09T23:23:23.23Z"
}
}
}
DoorbellPressイベントのペイロード
| プロパティ | 説明 | 型 | 必須 |
|---|---|---|---|
|
|
このイベントが発生した原因です。 |
|
◯ |
|
|
エンドポイントがイベントを検出した時刻です。 |
文字列 |
◯ |
変更レポート
エンドポイントの状態の変化をプロアクティブにレポートするために、ChangeReportイベントを送信します。プロアクティブにレポートするプロパティは検出応答で特定します。変更レポートの詳細については、状態および変更レポートについてを参照してください。
Alexa.DoorbellEventSourceインターフェースでは、プロアクティブに出力可能なプロパティを定義しません。ただし、スキルに実装しているほかのインターフェースについて変更レポートを送信する必要があります。関連トピック
最終更新日: 2024 年 12 月 06 日