智能家居模式特征架构
action.devices.traits.Modes
- 此特征涵盖设备的所有可用模式和特定于模式的设置。
此特征属于具有任意数量的“n 向”模式的任何设备,其中每种模式的模式和设置是任意的,并且对于每种设备或设备类型都是唯一的。每种模式都有多种可能的设置,但一次只能选择一种设置;烘干机不能同时处于“精细”“正常”和“重型”模式。简单地可以开启或关闭的设置属于 Toggles 特征。
例如,洗衣机可以有衣物大小和温度设置。它们都是模式,因为它们相互独立,但它们一次只能处于一种状态。用户可以使用将洗衣机的温度设为冷色调之类的命令明确设置温度等模式。
一些模式是“有序的”,也可以使用向上/向下、增加/减少措辞进行调整。例如,负载大小(小、中、大)和温度明确有序(请注意,温度不是像在其他设备上那样具有数字目标值的实际热热调节值),但负载类型(柔软、普通、羊毛等)则不然。
此特征涵盖用户可以设置的一种或多种个人模式。通常,这些模式应该用于与其他设备行为解除关联的功能。关联的行为(例如开启或关闭设备本身)应使用更具体的特征(例如,特征 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 |
(默认值: 如果此设置为 true,系统会按照设置数组的顺序(升序)应用增/减逻辑的其他语法。 |
commandOnlyModes |
Boolean |
(默认值: 指明设备是否支持使用单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态,请将此属性设为 true。 |
queryOnlyModes |
Boolean |
(默认值: 如果设备支持仅执行查询,则为必需。此属性指示设备是否只能查询状态信息,且无法控制。 |
示例
具有多种模式和设置的设备。
{ "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 |
对象 |
必填。 键/值对,其中模式 |
<string> |
String |
目前气温为 |
示例
设备处于哪种模式?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
设备命令
具有此特征的设备可能会在 EXECUTE
操作过程中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.SetModes
更新模式设置。
参数
参数 | 类型 | 说明 |
---|---|---|
updateModeSettings |
对象 |
必填。 以设备的模式 |
<string> |
String |
新增了 |
示例
设为大加载。
{ "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