智能家居 LockUnlock 特征架构

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

设备错误

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