スマートホーム ロックガイド
action.devices.types.LOCK
- ロックは、ロック状態とロック解除状態をロックし、ロック状態を報告できます。
このタイプは、デバイスに鍵アイコン、および関連する類義語とエイリアスがあることを示します。
デバイスの機能
サービスがサポートする属性や状態、EXECUTE レスポンスや QUERY レスポンスの作成方法など、実装の詳細については、対応するトレイトのドキュメントをご覧ください。
必要なトレイト
これらのトレイトとコマンドは、デバイスに応じて必要です。
品質要件
- レイテンシ: 2000 ミリ秒 以下でなければなりません。
- 信頼性: 97% 以上である必要があります。
デバイスの例: シンプルなロック
このセクションでは、上記のデバイスタイプとトレイトに基づく共通の「ロック」を表すインテント ペイロードの例について説明します。実装でトレイトを追加または削除する場合は、その変更を反映するようにレスポンスを修正してください。
SYNC レスポンスの例
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.LOCK", "traits": [ "action.devices.traits.LockUnlock" ], "name": { "name": "Simple lock" }, "willReportState": true, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
QUERY レスポンスの例
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "isLocked": true, "isJammed": false } } } }
EXECUTE コマンドの例
LockUnlock
コマンド パラメータの詳細については、
action.devices.traits.LockUnlock
リファレンスをご覧ください。
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.LockUnlock", "params": { "lock": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isLocked": true, "isJammed": false } } ] } }