Smart Home LockUnlock trait 架构

action.devices.traits.LockUnlock - 此特征属于支持锁定和解锁和/或报告锁定状态的所有设备。

设备属性

无。

设备状态

具有此 trait 的实体可能会在 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

后续回复

具有此 trait 的设备可能会在 EXECUTE 操作中返回以下后续响应载荷。如需详细了解如何实现后续响应，请参阅智能家居 Action 的通知。

载荷包含以下任一项：

成功：已锁定

字段 类型 说明
followUpToken String

必填。

原始 EXECUTE 请求中提供的令牌。
status String

必填。

请求的结果。

支持的值：

SUCCESS
isLocked 布尔值

必填。

指示设备是否已锁定。

失败

字段 类型 说明
followUpToken String

必填。

原始 EXECUTE 请求中提供的令牌。
status String

必填。

请求的结果。

支持的值：

FAILURE
errorCode String

必填。

此值可以是此 trait 的任何错误代码，例如 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

设备错误

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