Smart Home LockLock 特性
action.devices.traits.LockUnlock
- 這個屬性適用於任何支援鎖定和解鎖和/或回報鎖定狀態的裝置。
裝置屬性
無。
裝置狀態:STATE
具有此特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
isLocked |
布林 |
裝置目前是否處於鎖定狀態。 |
isJammed |
布林 |
無法判斷裝置目前是否卡住,因此無法判斷鎖定狀態。 |
範例
裝置已鎖定
{ "isLocked": true }
卡住了的裝置
{ "isJammed": true }
裝置指令
具有此特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求一文。
action.devices.commands.LockUnlock
鎖定或解除鎖定裝置。
參數
參數 | 類型 | 說明 |
---|---|---|
lock |
布林 |
必填。 當指令為鎖定時,值為 True,解鎖 False 則為 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