スマートホームの LockUnlock トレイトのスキーマ
action.devices.traits.LockUnlock
- このトレイトは、ロックとロック解除をサポートする、および/またはロック状態を報告できるデバイスに使用します。
デバイスの属性
なし。
デバイスのステータス
このトレイトを持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
isLocked |
ブール値 |
デバイスが現在ロックされているかどうか。 |
isJammed |
ブール値 |
デバイスが現在故障していて、ロック状態を判断できないかどうか。 |
例
ロックされているデバイス
{ "isLocked": true }
故障したデバイス
{ "isJammed": true }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
action.devices.commands.LockUnlock
デバイスをロックまたはロック解除します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
lock |
ブール値 |
必須。 コマンドがロックの場合は true、ロック解除の場合は false。 |
followUpToken |
文字列 |
フォローアップ レスポンス用の Google 提供のトークン。 |
例
正面玄関のドアをロックして。
{ "command": "action.devices.commands.LockUnlock", "params": { "lock": true, "followUpToken": "123" } }
玄関のドアのロックを解除して。
{ "command": "action.devices.commands.LockUnlock", "params": { "lock": false, "followUpToken": "567" } }
関連エラー
デバイスのロックまたはロック解除中にエラーが発生しました。
サポートされている値:
remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked
フォローアップの回答
このトレイトを持つデバイスは、EXECUTE
オペレーションの一部として次のフォローアップ レスポンス ペイロードを返すことができます。フォローアップ レスポンスの実装について詳しくは、スマートホーム アクションの通知をご覧ください。
ペイロードには、次のいずれかが含まれています。
成功: ロックしました
フィールド | タイプ | 説明 |
---|---|---|
followUpToken |
文字列 |
必須。 元の EXECUTE リクエストで提供されたトークン。 |
status |
文字列 |
必須。 リクエストの結果。 サポートされている値:
|
isLocked |
ブール値 |
必須。 デバイスがロックされているかどうかを示します。 |
失敗
フィールド | タイプ | 説明 |
---|---|---|
followUpToken |
文字列 |
必須。 元の EXECUTE リクエストで提供されたトークン。 |
status |
文字列 |
必須。 リクエストの結果。 サポートされている値:
|
errorCode |
文字列 |
必須。 値には、このトレイトの任意のエラーコード( |
例
正面玄関のドアをロックし、(成功例に対するフォローアップの回答)
{ "LockUnlock": { "priority": 0, "followUpResponse": { "status": "SUCCESS", "isLocked": true, "followUpToken": "1234" } } }
正面玄関のドアのロックを解除し、(成功例に対するフォローアップの回答)
{ "LockUnlock": { "priority": 0, "followUpResponse": { "status": "SUCCESS", "isLocked": false, "followUpToken": "1234" } } }
正面玄関のドアをロックし、(失敗の場合のフォローアップ対応)
{ "LockUnlock": { "priority": 0, "followUpResponse": { "status": "FAILURE", "errorCode": "deviceJammingDetected", "followUpToken": "1234" } } }
サンプル音声
de-DE
- Bitte Eingangstür abschließen
- Bitte schließ die Eingangstür auf
en-US
- lock my doors
- unlock study room
es-ES
- cierra la puerta con llave
- quitar el cerrojo de la puerta de entrad a
fr-FR
- déverrouille la porte d'entrée
- verrouille la porte d'entrée
hi-IN
- फ़्रंट डोर अनलॉक करो
- सामने के दरवाजे को लॉक करो
it-IT
- apri la porta d'ingresso
- puoi chiudere la porta d'ingresso a chiave
ja-JP
- 玄関のドア を施錠して
- 玄関 開錠して
ko-KR
- 도어락 잠가 줘
- 현관 도어락 열어 줄래
nl-NL
- Ontgrendel de voordeur
- doe de voordeur op slot
pt-BR
- Tranca a porta do quarto .
- destranca a porta da cozinha
- destrancar a porta da frente
- trancar a porta da frente
sv-SE
- lås upp ytterdörren
- lås ytterdörren