智能家居 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

必填。

请求的结果。

支持的值：

SUCCESS
isLocked 布尔值

必填。

表示设备是否已锁定。

失败

字段 类型 说明
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

设备错误

请参阅完整的 错误和异常列表。