智能家居模式特征架构

action.devices.traits.Modes - 此特征涵盖设备的所有可用模式和特定于模式的设置。

此特征属于具有任意数量“双向”模式的任何设备，其中每种模式的模式和设置对于各种设备或设备类型而言都是任意的。每种模式都可能有多个设置，但一次只能选择一项；烘干机不能同时处于“柔软”“正常”和“重”模式。只需开启或关闭开关的设置就属于切换开关特征。

例如，洗衣机可以设置洗衣机的尺寸和温度。这两种模式都是相互独立的，但它们一次只能处于一种状态。用户可以使用“将洗衣机的温度设为冷”等命令明确设置温度等模式。

某些模式是有序的，也可以随着向上/向下、增加/减少详细程度进行调整。例如，负载大小（小、中、大）和温度明确排序（请注意，与其他设备一样，温度不是数字目标的实际温控器），但负载类型（精致、正常、毛料等）可能并不排序。

此特征涵盖用户可以设置的一种或多种模式。一般来说，这些模式应该用于与其他设备行为解除关联的功能。关联的行为（例如开启或关闭设备本身）应使用更具体的特征（例如，特征 TemperatureSetting 中的 thermostatMode）。

设备属性

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

属性	类型	说明
availableModes	数组	必填。 可用模式的列表。
[item, ...]	对象	可用模式。
name	String	必填。 模式的内部名称，将在命令和状态中使用。这种做法可能会不适合用户浏览，并且会跨所有语言分享。
name_values	数组	必填。 每种受支持语言的模式的同义词。
[item, ...]	对象	给定语言的模式的同义词。
name_synonym	数组	必填。 模式的同义词。此列表中的第一个字符串将用作该语言的级别规范名称。
[item, ...]	String	同义词。
lang	String	必填。 语言代码 (ISO 639-1)。请参阅支持的语言。
settings	数组	必填。 此模式支持的设置。
[item, ...]	对象	支持的设置。 至少需要 2 个菜单项。
setting_name	String	必填。 模式设置的内部名称，将在命令和状态中使用。这种做法可能会不适合用户浏览，并且会跨所有语言分享。
setting_values	数组	必填。 设置在每种支持的语言对应的同义词。
[item, ...]	对象	指定语言的设置同义词。
setting_synonym	数组	必填。 相应设置的同义词。此列表中的第一个字符串将用作该语言的级别规范名称。
[item, ...]	String	同义词。
lang	String	必填。 语言代码 (ISO 639-1)。请参阅支持的语言。
ordered	Boolean	（默认：false） 如果将此属性设置为 true，则会按照设置数组的顺序（增加）应用额外的增减逻辑语法。
commandOnlyModes	Boolean	（默认：false） 指示设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态，请将此属性设为 true。
queryOnlyModes	Boolean	（默认：false） 如果设备支持仅执行查询，则必须提供。此属性指示设备是否只能查询状态信息，且无法控制。

示例

设备具有多个模式和设置。

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

具有纯命令模式的设备。

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

设备状态

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

州	类型	说明
currentModeSettings	对象	必填。 键值对，使用设备的模式 name 作为键，使用当前的 setting_name 作为值。
<string>	String	目前气温为 setting_name。

示例

设备处于什么模式？

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

设备命令

具有此特征的设备可能会在 EXECUTE 操作中响应以下命令。如需详细了解如何处理 EXECUTE intent，请参阅 intent 执行方式。

action.devices.commands.SetModes

更新模式设置。

参数

参数	类型	说明
updateModeSettings	对象	必填。 键值对，使用设备的模式 name 作为键，并使用新的 setting_name 作为值。
<string>	String	新增了 setting_name。

示例

设置为大负载。

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

示例话语

de-DE

• Stelle den Staubsauger auf Ruhemodus

en-US

• set the vacuum to energy saver mode

es-ES

• pon la lavadora en modo frío

fr-FR

• mets l'aspirateur en silencieux

hi-IN

• वैक्यूम पर कार्पेट मोड लगाएं

it-IT

• imposta l'aspirapolvere su silenzioso

ja-JP

• 掃除機 を 静音 モードに設定して

ko-KR

• 세탁기 세탁량 많음 으로 설정해

pt-BR

• acionar a função autolimpeza do aspirador
• ligar o modo de aquecimento

设备错误

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