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

デバイスエラー

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