智能家居锁解锁特征架构

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	必填。 请求的结果。 支持的值： SUCCESS
isLocked	Boolean	必填。 指示设备是否处于锁定状态。

失败

字段	类型	说明
followUpToken	String	必填。 原始 EXECUTE 请求中提供的令牌。
status	String	必填。 请求的结果。 支持的值： FAILURE
errorCode	String	必填。 该值可以是此特征的任何错误代码，例如 deviceJammingDetected。

示例

锁上前门。（成功案例的跟进回复）

{
  "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

设备出错

查看错误和异常的完整列表。