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

action.devices.traits.Modes - このトレイトは、デバイスで利用可能なすべてのモードとモード固有の設定に対応しています。

このトレイトは、n 通りの設定があるモードを任意の数持ったデバイスに使用します。モードとそのモードの設定は、任意で、デバイスまたはデバイスタイプごとに異なります。各モードには複数の設定がありますが、同時に選択できるのは 1 つだけです。たとえば、乾燥機の設定には「デリケート」、「標準」、「ヘビー デューティー」などのモードがありますが、これらを同時に設定することはできません。単にオン / オフを切り替える設定の場合は Toggles トレイトを使用します。

たとえば洗濯機には、洗濯物の重さと温度の設定を使用できます。これらは互いに独立しているので両方ともモードになりますが、それぞれ一度に 1 つの状態しかとれません。ユーザーは「洗濯機の温度を低温にして」といったコマンドを使って、温度などのモードを明示的に設定できます。

一部のモードは「順序付け」されており、上げる / 下げる、増やす / 減らすといった言い回しで調節することもできます。たとえば、洗濯物の重さ（小、中、大）と温度は明確に順序付けされています（他のデバイスのような、温度は数値目標がある本物のサーモスタットではありません）。洗濯物の種類（デリケート、普通、ウールなど）は順序付けされていません。

この特性は、ユーザーが設定できる 1 つ以上の独立したモードに対応しています。一般に、これらのモードは、デバイスの他の動作からリンクされていない機能に使用するべきです。デバイス自体の電源をオンあるいはオフにするなどのリンクされた動作では、より限定的なトレイトを使用する必要があります（たとえば、TemperatureSetting トレイトの thermostatMode）。

デバイスの属性

このトレイトを持つデバイスは、SYNC オペレーションの一部として次の属性を報告できます。SYNC インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

属性 タイプ 説明
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 ブール値

（デフォルト: false）

これが true に設定されている場合、増減のロジックのための文法が適用されます。settings 配列の順序（昇順）になります。
commandOnlyModes ブール値

（デフォルト: false）

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

（デフォルト: false）

デバイスが問い合わせのみの実行をサポートしている場合、必須。デバイスが、ステータス情報の問い合わせができるだけで、制御はできないかどうかを示します。

例

複数のモードと設定があるデバイス。

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

必須。

デバイスのモード name をキーとして、現在の setting_name を値とする Key-Value ペア。
<string> String

現在の気温: setting_name

例

デバイスはどのモードになっていますか？

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

デバイスのコマンド

このトレイトを持つデバイスは、EXECUTE オペレーションの一部として次のコマンドに応答する場合があります。EXECUTE インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

action.devices.commands.SetModes

更新モードの設定を更新します。

パラメータ

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

必須。

デバイスのモード name をキーとして、新しい setting_name を値とする Key-Value ペア。
<string> String

新しい setting_name。

例

負荷が大きい場合に設定します。

{
  "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

デバイスエラー

エラーと例外の全リストをご覧ください。