スマートホーム Toggles トレイトのスキーマ

action.devices.traits.Toggles - このトレイトは、2 つの状態のいずれか一方のみに存在する設定を持つデバイスに使用します。

これらの設定は、オン / オフまたはアクティブ / 非アクティブを切り替える物理的なボタン、HTML のチェックボックス、その他の有効 / 無効を切り替える要素を表すことができます。設定に 3 つ以上の状態がある場合、または どちらのバイナリオプションも選択されていない場合は、 Modes トレイト（複数の状態のダイヤルに対応） ラジオボタン（物理または HTML）、または明示的に指定されていないバイナリ状態 オン/オフ（「AM/FM」、「ホット/コールド」など）。

このトレイトは、ユーザーが設定できる 1 つ以上の独立したトグルに対応しています。一般に、これらのトグルは、デバイスの他の動作からリンクされていない機能に使用するべきです。デバイス自体を回転させるなどのリンクされた動作 より具体的なトレイト（thermostatMode （トレイト TemperatureSetting 内）。

デバイスの属性

このトレイトを持つデバイスは、以下をレポートすることがあります。 SYNC オペレーションの一部として使用できます。学習内容 SYNC インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

属性 タイプ 説明
availableToggles 配列

必須。

使用可能な切り替えのリスト。
[item, ...] オブジェクト

有効の切り替え。
name String

必須。

切り替えの内部名。コマンドと状態で使用されます。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。
name_values 配列

必須。

サポートされている各言語における切り替えボタンと同義。
[item, ...] オブジェクト

特定の言語におけるトグルと同義。
name_synonym 配列

必須。

切り替えボタンと同義。このリストの最初の文字列が、その言語のレベルの正規名として使用されます。
[item, ...] String

類義語名。
lang String

必須。

言語コード（ISO 639-1）。サポートされている言語をご確認ください。
commandOnlyToggles ブール値

（デフォルト: false）。

デバイスが一方向（true）または双方向（false）の通信の使用をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。
queryOnlyToggles ブール値

（デフォルト: false）。

デバイスが問い合わせのみの実行をサポートしている場合、必須。この属性は、デバイスの状態情報の照会のみ可能で、制御はできないかどうかを示します。

例

複数の切り替えスイッチがあるデバイス。

{
  "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 オブジェクト

必須。

デバイスのトグル name をキー、現在の状態を値として持つ Key-Value ペア。
<string> ブール値

現在の切り替え状態。

例

消毒はオンになっていますか？

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

デバイスのコマンド

このトレイトを持つデバイスは、以下の動作に反応します。 コマンドを EXECUTE オペレーションの一部として使用できます。学習内容 EXECUTE インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

action.devices.commands.SetToggles

特定の切り替え状態を設定します。

パラメータ

パラメータ タイプ 説明
updateToggleSettings オブジェクト

必須。

デバイスのトグル name をキー、新しい状態を値として持つ Key-Value ペア。
<string> ブール値

新しい切り替え状態

例

省エネをオンにします。

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

フィルタをオフにします。

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

サンプル音声

<ph type="x-smartling-placeholder">

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

デバイスエラー

詳しくは、 エラーと例外をご覧ください。