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

设备出错

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