智能家居 OpenClose 特征架构

action.devices.traits.OpenClose - 此特征属于支持打开和关闭的设备，在某些情况下，还支持部分打开和关闭，或者支持以多个方向打开和关闭。

设备属性

具有此特征的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅意图实现。

属性 类型 说明
discreteOnlyOpenClose 布尔值

（默认值：false）

如果设置为 true，则表示设备必须完全打开或完全关闭（即不支持介于 0% 和 100% 之间的值）。
openDirection 数组

设备可打开或关闭的受支持方向的列表。如果设备支持以多个方向打开和关闭，请添加此属性。
[item, ...] String

支持的方向。

支持的值：

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose 布尔值

（默认值：false）

指示设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态，请将此属性设置为 true。
queryOnlyOpenClose 布尔值

（默认值：false）

表示设备是否只能查询状态信息，而无法控制。只能报告打开状态的传感器应将此字段设置为 true。

示例

简单的开合设备。

{
  "discreteOnlyOpenClose": true
}

自上而下、自下而上的设备。可双向打开。

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

仅限命令的设备。

{
  "commandOnlyOpenClose": false
}

设备状态

具有此特征的实体可能会在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent，请参阅意图实现。

载荷包含以下内容之一：

单向打开/关闭

州 类型 说明
openPercent 编号

必填。

表示设备的打开百分比，其中 0 表示关闭，100 表示完全打开。
targetOpenPercent 编号

表示设备因位置持续变化而将要或正在移动到的打开百分比。

多方向开合

州 类型 说明
openState 数组

必填。

每个支持的打开方向的状态列表。
[item, ...] 对象

指定打开方向的当前状态。
openPercent 编号

必填。

表示设备的打开百分比，其中 0 表示关闭，100 表示完全打开。
targetOpenPercent 编号

表示设备因位置持续变化而将要或正在移动到的打开百分比。
openDirection String

必填。

设备打开的方向。

支持的值：

UP
DOWN
LEFT
RIGHT
IN
OUT

示例

简单的开合设备。

{
  "openPercent": 100
}

简单的开合设备，目前正在打开到新位置。

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

将设备向下打开 30%，向上打开 50%。

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

向下方向打开设备 30%，向上方向打开设备 50%，当前向上方向打开到 80%。

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

设备命令

具有此特征的设备可能会响应以下命令，作为 EXECUTE 操作的一部分。如需详细了解如何处理 EXECUTE intent，请参阅意图实现。

action.devices.commands.OpenClose

设置设备的开合状态。

参数

参数 类型 说明
openPercent 编号

必填。

表示设备的打开百分比，其中 0 表示关闭，100 表示完全打开。
openDirection String

打开方向。仅当设备支持多个方向（如 openDirection 属性所示）且用户指定了方向时才存在。

支持的值：

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Google 提供的用于后续响应的令牌。

示例

打开设备。

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

将设备打开到 50% 的位置。

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

设置设备的打开/关闭状态时出错。

支持的值：

lockedState
deviceJammingDetected

后续回答

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

载荷包含以下内容之一：

成功

字段 类型 说明
followUpToken String

必填。

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

必填。

请求的结果。

支持的值：

SUCCESS
openPercent 编号

必填。

表示设备的展开百分比，其中 0 表示关闭，100 表示完全展开。

失败

字段 类型 说明
followUpToken String

必填。

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

必填。

请求的结果。

支持的值：

FAILURE
errorCode String

必填。

该值可以是相应特征的任何错误代码，例如 lockedState。

示例

打开车库门。（成功案例的后续回答）

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

打开车库门。（失败情况下的后续响应）

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

根据当前状态调整设备的打开/关闭状态。只有当 discreteOnlyOpenClose 设为 false 时，此命令才可用。

此命令需要以下属性： 
{
  "discreteOnlyOpenClose": false
}

参数

参数 类型 说明
openRelativePercent 编号

必填。

用于更改打开/关闭状态的确切百分比。模糊的相对指令将转换为确切的百分比参数（例如，“将百叶窗再打开一点”与“将百叶窗打开 5%”）。
openDirection String

打开方向。仅当设备支持多个方向（如 openDirection 属性所示）且用户指定了方向时才存在。

支持的值：

UP
DOWN
LEFT
RIGHT
IN
OUT

示例

将设备打开得稍微大一些

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

将设备再合上 10%

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

将设备向下打开 50%。

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

设置设备的打开/关闭状态时出错。

支持的值：

lockedState
deviceJammingDetected

示例话语

de-DE

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25 % schliessen
  • Ist die Jalousie zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Are the blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más la ventana
  • está abierta la puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce que la porte d'entrée est ouverte
  • ferme les stores
  • ferme un peu les stores
  • ouvre les stores
  • ouvre les stores de la chambre de 25%
  • ouvre les stores à 25%

hi-IN

  • कृपया 25% पर्दे को खुला रखो
  • क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
  • पर्दे को 25% बंद करोगे
  • पर्दे खोलो
  • ब्लाइंड 25% खुले पर सेट कर दीजिए
  • ब्लाइंड को थोड़ा और बंद कर दिजिए
  • ब्लाइंड बंद करें

it-IT

  • abbassa un po' di più le tapparelle
  • apri la serranda
  • apri la tapparella al 30%
  • apri le serrande del 30%
  • chiudi le serrande
  • chiudi le tende del 25%
  • è aperta la porta d'ingresso

ja-JP

  • 25% に ブラインド を開けて
  • 25% ブラインド を閉めてください
  • 25% ブラインド 開けて
  • ブラインド 閉めて
  • ブラインド 開けて
  • 少し ブラインド を閉じて
  • 玄関のドア は開いてますか

ko-KR

  • 문 살짝만 닫아 줘
  • 블라인드 25% 열어 줘
  • 블라인드 25% 까지 열어 줘
  • 블라인드 30프로 닫아
  • 블라인드 닫아 줘
  • 블라인드 열어 줘
  • 안방 문 열렸어

nl-NL

  • doe de gordijnen 25% open
  • doe de jaloezieën voor 25% dicht
  • doe het raam ietsje meer dicht
  • is de voordeur open
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • As cortinas estão abertas?
  • Fecha a persiana toda
  • Fechar a janela 10%
  • a cortina do quarto está aberta?
  • abra a persiana até 30%
  • abre as cortinas
  • abre as cortinas a 50%
  • abrir as cortinas
  • abrir as cortinas na sala em 30%
  • fecha a persiana por favor
  • fecha um bocado a janela
  • fechar as cortinas em 25%
  • fechar um pouco mais as cortinas

sv-SE

  • Dra upp persiennerna
  • Dra upp persiennerna till 25%
  • stäng persiennen i mitt rum 25%
  • stäng persiennerna
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

设备错误

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