スマートホーム Toggles トレイトのスキーマ
action.devices.traits.Toggles
- このトレイトは、2 つの状態のいずれかしか存在しない設定を持つデバイスに使用します。
これらの設定は、オン / オフまたはアクティブ / 非アクティブを切り替える物理的なボタン、HTML のチェックボックス、その他の有効 / 無効を切り替える要素を表すことができます。設定に 3 つ以上の状態がある場合や、バイナリ オプションがいずれも選択されていない状態の場合は、Modes トレイトとして表すことをおすすめします。これは、マルチステート ダイヤル、ラジオボタン(物理ボタンまたは HTML)、明示的にオン/オフのないバイナリ状態(「AM/FM」や「ホット/コールド」など)に相当します。
このトレイトは、ユーザーが設定できる 1 つ以上の独立したトグルに対応しています。一般に、これらのトグルは、デバイスの他の動作からリンクされていない機能に使用するべきです。デバイス自体のオン / オフなどのリンクされた動作では、より具体的なトレイト(たとえば、トレイト TemperatureSetting の thermostatMode
)を使用する必要があります。
デバイスの属性
このトレイトを持つデバイスは、SYNC
オペレーションの一部として次の属性をレポートできます。SYNC
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
availableToggles |
配列 |
必須。 使用可能な切り替えボタンのリスト。 |
[item, ...] |
温度計 |
切り替え可能なボタンです。 |
name |
文字列 |
必須。 切り替えの内部名。コマンドと状態で使用されます。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。 |
name_values |
配列 |
必須。 サポートされている各言語における切り替えボタンの類義語。 |
[item, ...] |
温度計 |
特定の言語における切り替えボタンの類義語。 |
name_synonym |
配列 |
必須。 切り替えの類義語。このリストの最初の文字列が、その言語のレベルの正規名として使用されます。 |
[item, ...] |
文字列 |
同義名。 |
lang |
文字列 |
必須。 言語コード(ISO 639-1)。サポートされている言語をご覧ください。 |
commandOnlyToggles |
ブール値 |
(デフォルト: デバイスが一方向(true)または双方向(false)の通信の使用をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。 |
queryOnlyToggles |
ブール値 |
(デフォルト: デバイスが問い合わせのみの実行をサポートしている場合、必須。この属性は、デバイスが状態情報の照会のみが可能で、制御はできないかどうかを示します。 |
例
複数の切り替えボタンがあるデバイス。
{ "availableToggles": [ { "name": "sterilization_toggle", "name_values": [ { "name_synonym": [ "Clean", "Bio clean" ], "lang": "en" } ] }, { "name": "energysaving_toggle", "name_values": [ { "name_synonym": [ "Energy saving", "Eco" ], "lang": "en" } ] } ] }
コマンドのみの切り替え機能を備えたデバイス。
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
クエリのみの切り替え機能を備えたデバイス。
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
デバイスのステータス
このトレイトを持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
currentToggleSettings |
温度計 |
必須。 デバイスの切り替え |
<string> |
ブール値 |
現在の切り替え状態。 |
例
不妊手術はオンになっていますか?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
action.devices.commands.SetToggles
特定の切り替え状態を設定します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
updateToggleSettings |
温度計 |
必須。 デバイスの切り替え |
<string> |
ブール値 |
新しい切り替え状態 |
例
省エネ機能をオンにします。
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
フィルタをオフにします。
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
サンプル音声
de-DE
- Bitte schalte Power Cool am Kühlschrank aus
- stelle den Kühlschrank auf Power Cool
en-US
- activate power freeze for the freezer
- cancel power cool for the kitchen fridge
es-ES
- pon el enfriamiento rápido en la nevera
- quita el enfriamiento rápido
fr-FR
- mets le mode power cool sur le réfrigérateur
- Éteins le mode power freeze du réfrigérateur .
hi-IN
- रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
- रेफ़्रिजरेटर में पावर कूल मोड चालू करो
it-IT
- disattiva il power freeze del freezer
- imposta la funzione power freeze del surgelatore
ja-JP
- 冷蔵庫 の 急速冷凍 つけて
- 冷蔵庫 の 急速冷凍 を切ってくれる
ko-KR
- 냉장고 급속 냉장 해제해
- 냉장고 모드 급속 냉장 으로 바꿔
nl-NL
- Zet de power cool uit op de koelkast
- zet de koelkast op superkoelen
pt-BR
- Ativa a função power freeze no congelador .
- Desativa o bloqueio infantil do forno .
- desligar o power cool da geladeira
- iniciar o modo power freeze do freezer
sv-SE
- Stäng av power cool i kylskåpet
- sätt på power freeze på frysen