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

action.devices.traits.Fill - この特性は、浴槽など、充填をサポートするデバイスに適用されます。

デバイスの属性

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

属性 タイプ 説明
availableFillLevels 温度計

デバイスのさまざまな充填レベルを示します。

levels 配列

必須。

レベル名と言語固有の類義語のリスト。

[item, ...] 温度計

レベルの名前とその言語固有の類義語。

level_name String

必須。

レベルの内部名。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。

level_values 配列

必須。

サポートされている各言語のレベルの同義語。

[item, ...] 温度計

特定の言語のレベルと同義。

level_synonym 配列

必須。

レベルの類義語。このリストの最初の文字列は、その言語のレベルの正規名として使用されます。

[item, ...] String

同義名。

lang String

必須。

言語コード(ISO 639-1)。サポートされている言語をご覧ください。

ordered ブール値

必須。

true の場合、デバイスは levels 配列で表される増減ロジック(半レベルなど)を処理して追加の文法を処理します。

supportsFillPercent ブール値

(デフォルト: false

true の場合、レベルをパーセンテージに調整するコマンドを受け入れます。

個別の充填レベルをサポートしていない基本的な充填 / 排出機能を備えたデバイス。

{}

個別のフィルレベルをサポートするデバイス。

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

デバイスのステータス

このトレイトを使用するエンティティは、QUERY オペレーションの一部として次の状態を報告できます。QUERY インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

状態 タイプ 説明
isFilled ブール値

必須。

デバイスがレベルに達している場合は True。デバイスが完全にドレインされている場合は False です。

currentFillLevel String

availableFillLevels 属性が設定されている場合は必須です。デバイスが入っている availableFillLevels 属性の現在の level_name を示します。

currentFillPercent 番号

supportsFillPercent 属性が設定されている場合は必須です。現在の広告掲載率の割合を示します。

「バスタブにお湯は入ってる?」

{
  "isFilled": true
}

浴槽はいっぱいになっていますか?(レベルによる)。

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

デバイスのコマンド

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

action.devices.commands.Fill

デバイスを充填または排水します。

パラメータ

パラメータ タイプ 説明
fill ブール値

必須。

true に設定すると、false でドレインされます。

fillLevel String

設定する availableFillLevels 属性の level_name を示します。指定しない場合は、デフォルトのレベルまで充填されます。

fillPercent 番号

リクエストされたレベルの割合を示します。

浴槽に湯を入れます。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

浴槽を排水します。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

「バスタブに半分までお湯を入れて。」

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

バスタブの塗りつぶしレベルを 1 つ上げます(ordered 属性は true にする必要があります)。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

デバイスエラー

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