智能家居 OpenClose 特征架构

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

设备属性

具有此特征的设备可以在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性	类型	说明
discreteOnlyOpenClose	Boolean	（默认：false） 当设置为 true 时，表示设备必须完全打开或完全关闭（也就是说，不支持介于 0% 到 100% 之间的值）。
openDirection	数组	设备可打开或关闭的受支持路线列表。如果设备支持多个方向打开和关闭，请添加此属性。
[item, ...]	String	支持的方向。 支持的值： UP DOWN LEFT RIGHT IN OUT
commandOnlyOpenClose	Boolean	（默认：false） 指示设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态，请将此属性设为 true。
queryOnlyOpenClose	Boolean	（默认：false） 指示设备是否只能查询状态信息且无法控制。只能报告打开状态的传感器应设置此字段。

示例

简单的开合设备。

{
  "discreteOnlyOpenClose": true
}

自下而上的设备。可在任一方向打开。

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

纯命令设备。

{
  "commandOnlyOpenClose": false
}

设备状态

具有此特征的实体可以在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent，请参阅 intent 执行方式。

载荷包含下列各项之一：

单向开合

州	类型	说明
openPercent	编号	必填。 表示设备已打开的百分比，其中 0 表示关闭，100 则表示完全打开。

多方向开合

州	类型	说明
openState	数组	必填。 每个支持的打开方向的状态列表。
[item, ...]	对象	指定打开方向的当前状态。
openPercent	编号	必填。 表示设备已打开的百分比，其中 0 表示关闭，100 则表示完全打开。
openDirection	String	必填。 设备的打开方向。 支持的值： UP DOWN LEFT RIGHT IN OUT

示例

简单的开合设备。

{
  "openPercent": 100
}

打开设备向下 30% 和向上 50%。

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "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	必填。 该值可以是此特征的任何错误代码，例如 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

示例话语

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%

设备错误

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