スマートホーム 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