スマートホームの Modes トレイトのスキーマ
action.devices.traits.Modes - このトレイトは、デバイスで利用可能なすべてのモードとモード固有の設定に対応します。
このトレイトは、任意の数の「n 方向」モードを持つ任意のデバイスに属します。各モードのモードと設定は任意で、各デバイスまたはデバイスタイプに固有のものです。各モードには複数の設定がありますが、一度に選択できる設定は 1 つだけです。乾燥機を「デリケート」、「標準」、「ヘビーデューティ」モードに同時に設定することはできません。単にオン / オフの切り替えができる設定は、Toggles トレイトに含まれます。
たとえば、洗濯機には洗濯物の量と温度の設定があります。 これらは互いに独立しているため、どちらもモードになりますが、それぞれが一度に 1 つの状態にしかなりません。ユーザーは「洗濯機の温度を低温にして」といったコマンドを使って、温度などのモードを明示的に設定できます。
一部のモードは「順序付け」されており、上げる / 下げる、増やす / 減らすといった言い回しで調節することもできます。たとえば、洗濯物の重さ（小、中、大）と温度は明確に順序付けされています（他のデバイスのような、温度は数値目標がある本物のサーモスタットではありません）。洗濯物の種類（デリケート、普通、ウールなど）は順序付けされていません。
この特性は、ユーザーが設定できる 1 つ以上の独立したモードに対応しています。一般に、これらのモードは、デバイスの他の動作からリンクされていない機能に使用するべきです。デバイス自体のオン / オフなどのリンクされた動作では、より具体的なトレイトを使用する必要があります（例: トレイト TemperatureSetting の thermostatMode）。
デバイスの属性
このトレイトを持つデバイスは、SYNC オペレーションの一部として次の属性をレポートできます。SYNC インテントの処理方法については、インテントのフルフィルメントをご覧ください。
| 属性 | タイプ | 説明 |
|---|---|---|
availableModes |
配列 |
必須。 使用可能なモードのリスト。 |
[item, ...] |
温度計 |
利用可能なモードです。 |
name |
文字列 |
必須。 モードの内部名。コマンドと状態で使用されます。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。 |
name_values |
配列 |
必須。 サポートされている各言語におけるモードの類義語。 |
[item, ...] |
温度計 |
各言語のモードの類義語。 |
name_synonym |
配列 |
必須。 モードの類義語。このリストの最初の文字列が、その言語のレベルの正規名として使用されます。 |
[item, ...] |
文字列 |
同義名。 |
lang |
文字列 |
必須。 言語コード（ISO 639-1）。サポートされている言語をご覧ください。 |
settings |
配列 |
必須。 このモードでサポートされている設定。 |
[item, ...] |
温度計 |
サポートされている設定です。 少なくとも 2 つのアイテムが必要です。 |
setting_name |
文字列 |
必須。 モード設定の内部名。コマンドと状態で使用されます。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。 |
setting_values |
配列 |
必須。 サポートされている各言語における設定の同義語。 |
[item, ...] |
温度計 |
各言語での設定の類義語。 |
setting_synonym |
配列 |
必須。 設定の類義語。このリストの最初の文字列が、その言語のレベルの正規名として使用されます。 |
[item, ...] |
文字列 |
同義名。 |
lang |
文字列 |
必須。 言語コード（ISO 639-1）。サポートされている言語をご覧ください。 |
ordered |
ブール値 |
（デフォルト: true に設定した場合、設定配列の順序（昇順）で増減ロジックの文法が適用されます。 |
commandOnlyModes |
ブール値 |
（デフォルト: デバイスが一方向（true）または双方向（false）の通信の使用をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。 |
queryOnlyModes |
ブール値 |
（デフォルト: デバイスが問い合わせのみの実行をサポートしている場合、必須。この属性は、デバイスが状態情報の照会のみが可能で、制御はできないかどうかを示します。 |
例
マルチモードとマルチ設定に対応したデバイス
{
"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 インテントの処理方法については、インテントのフルフィルメントをご覧ください。
| 状態 | タイプ | 説明 |
|---|---|---|
currentModeSettings |
温度計 |
必須。 デバイスのモード |
<string> |
文字列 |
現在の気温: |
例
デバイスはどのようなモードになっていますか？
{
"currentModeSettings": {
"load_mode": "small_load",
"temp_mode": "cold_temp"
}
}
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE オペレーションの一部として次のコマンドに応答できます。EXECUTE インテントの処理方法については、インテントのフルフィルメントをご覧ください。
action.devices.commands.SetModes
モードの設定を更新します。
パラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
updateModeSettings |
温度計 |
必須。 デバイスのモード |
<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