智能家居锁解锁特征架构
action.devices.traits.LockUnlock
- 此特征属于支持锁定和解锁和/或报告锁定状态的所有设备。
设备属性
无。
设备状态
具有此特征的实体可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
isLocked |
Boolean |
设备当前是否已锁定。 |
isJammed |
Boolean |
设备当前是否受阻,因此无法确定其锁定状态。 |
示例
设备已锁定
{ "isLocked": true }
设备卡住
{ "isJammed": true }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.LockUnlock
锁定或解锁设备。
参数
参数 | 类型 | 说明 |
---|---|---|
lock |
Boolean |
必填。 命令处于锁定状态时为 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
操作中返回以下后续响应载荷。如需详细了解如何实现后续响应,请参阅智能家居 Action 通知。
载荷包含以下其中一项:
成功:已锁定
字段 | 类型 | 说明 |
---|---|---|
followUpToken |
String |
必填。 原始 EXECUTE 请求中提供的令牌。 |
status |
String |
必填。 请求的结果。 支持的值:
|
isLocked |
Boolean |
必填。 指示设备是否处于锁定状态。 |
失败
字段 | 类型 | 说明 |
---|---|---|
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