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

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

このトレイトは、任意の数の「n 方向」モードを持つ任意のデバイスに属します。各モードのモードと設定は任意で、各デバイスまたはデバイスタイプに固有のものです。各モードには複数の設定がありますが、一度に選択できる設定は 1 つだけです。乾燥機を「デリケート」、「標準」、「ヘビーデューティ」モードに同時に設定することはできません。単にオン / オフの切り替えができる設定は、Toggles トレイトに含まれます。

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

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

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

デバイスの属性

このトレイトを持つデバイスは、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 ブール値

(デフォルト: false

true に設定した場合、設定配列の順序(昇順)で増減ロジックの文法が適用されます。

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> 文字列

現在の気温: setting_name

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

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

デバイスのコマンド

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

action.devices.commands.SetModes

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

パラメータ

パラメータ タイプ 説明
updateModeSettings 温度計

必須。

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

<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

デバイスエラー

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