智能家居 OpenClose 特征架构

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

设备属性

具有此特征的设备可能会报告以下内容 作为 SYNC 操作的一部分。学习内容 有关处理 SYNC intent 的更多信息，请参阅 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 的更多信息，请参阅 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 的更多信息，请参阅 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

必填。

该值可以是此 trait 的任何错误代码，例如 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

根据当前状态调整设备的开合状态。仅当 commandOnlyOpenClose 设置为 false 时，此命令才可用。

此命令需要以下属性： 
{
  "commandOnlyOpenClose": 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

示例话语

<ph type="x-smartling-placeholder">

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%

设备错误

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