Smart Home LockUnlock 特征架构
action.devices.traits.LockUnlock
- 此特征属于支持锁定和解锁和/或报告锁定状态的所有设备。
设备属性
无。
设备状态
具有此特征的实体可能会报告以下内容
QUERY
操作包含的指定状态。学习内容
有关处理 QUERY
intent 的更多信息,请参阅
intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
isLocked |
布尔值 |
设备当前是否处于锁定状态。 |
isJammed |
布尔值 |
无法确定设备当前是否被卡住并因此而被锁定为锁定状态。 |
示例
设备已锁定
{ "isLocked": true }
设备卡住
{ "isJammed": true }
设备命令
具有此特征的设备可能会响应以下内容
作为 EXECUTE
操作的一部分。学习内容
有关处理 EXECUTE
intent 的更多信息,请参阅
intent 执行方式。
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
操作的一部分的后续响应载荷。学习内容
有关实施跟进回复的详情,请参阅
智能家居 Action 的通知。
载荷包含以下内容之一:
成功:已锁定
字段 | 类型 | 说明 |
---|---|---|
followUpToken |
String |
必填。 原始 EXECUTE 请求中提供的令牌。 |
status |
String |
必填。 请求的结果。 支持的值:
|
isLocked |
布尔值 |
必填。 指示设备是否已锁定。 |
失败
字段 | 类型 | 说明 |
---|---|---|
followUpToken |
String |
必填。 原始 EXECUTE 请求中提供的令牌。 |
status |
String |
必填。 请求的结果。 支持的值:
|
errorCode |
String |
必填。 该值可以是此 trait 的任何错误代码,例如 |
示例
锁上前门。(针对成功案例的跟进响应)
{ "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" } } }
示例话语
<ph type="x-smartling-placeholder">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