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

必填。

请求的结果。

支持的值：

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

示例话语

<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

设备错误

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