智慧門鎖解鎖傳統結構定義
action.devices.traits.LockUnlock
- 這個特性代表任何支援鎖定和解鎖的裝置,以及/或是回報鎖定狀態。
裝置屬性
無。
裝置狀態
具有這個特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求。
州 | 類型 | 說明 |
---|---|---|
isLocked |
布林 |
裝置目前是否已鎖定。 |
isJammed |
布林 |
裝置是否處於登入狀態,因此無法判斷鎖定狀態。 |
範例
已鎖定的裝置
{ "isLocked": true }
卡住的裝置
{ "isJammed": true }
裝置指令
具有此特性的裝置可能會回應 EXECUTE
作業中的下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求。
action.devices.commands.LockUnlock
鎖定或解鎖裝置。
參數
參數 | 類型 | 說明 |
---|---|---|
lock |
布林 |
必要。 當指令鎖定時為 True,傳回 false。 |
followUpToken |
String |
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 |
String |
必要。 原始 EXECUTE 要求中提供的權杖。 |
status |
String |
必要。 要求的結果。 支援的值:
|
isLocked |
布林 |
必要。 指出裝置是否已鎖定。 |
失敗
欄位 | 類型 | 說明 |
---|---|---|
followUpToken |
String |
必要。 原始 EXECUTE 要求中提供的權杖。 |
status |
String |
必要。 要求的結果。 支援的值:
|
errorCode |
String |
必要。 這個值可以是這項特徵的任何錯誤代碼,例如 |
範例
鎖上前門。(後續案件的後續回覆)
{ "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