スマートホームの 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