スマートホームの Fill トレイトのスキーマ
action.devices.traits.Fill
- このトレイトは、浴槽など、充填可能なデバイスに適用されます。
デバイスの属性
このトレイトを持つデバイスは、SYNC
オペレーションの一部として次の属性をレポートできます。SYNC
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
availableFillLevels |
温度計 |
デバイスのさまざまな充填レベルを示します。 |
levels |
配列 |
必須。 レベル名と言語固有の同義語のリスト。 |
[item, ...] |
温度計 |
レベル名と言語固有の同義語。 |
level_name |
文字列 |
必須。 レベルの内部名。これは、ユーザー フレンドリーな名前とは限らず、すべての言語に共通です。 |
level_values |
配列 |
必須。 サポートされている各言語におけるレベルの同義語。 |
[item, ...] |
温度計 |
特定の言語でのレベルの同義語。 |
level_synonym |
配列 |
必須。 レベルの同義語。このリストの最初の文字列が、その言語のレベルの正規名として使用されます。 |
[item, ...] |
文字列 |
同義名。 |
lang |
文字列 |
必須。 言語コード(ISO 639-1)。サポートされている言語をご覧ください。 |
ordered |
ブール値 |
必須。 true の場合、デバイスは |
supportsFillPercent |
ブール値 |
(デフォルト: 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 |
文字列 |
|
currentFillPercent |
番号 |
|
例
「バスタブにお湯は入ってる?」
{ "isFilled": true }
お風呂はいっぱいですか?(レベルあり)。
{ "isFilled": true, "currentFillLevel": "half_level" }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
action.devices.commands.Fill
デバイスを注入または排水します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
fill |
ブール値 |
必須。 塗りつぶす場合は true、ドレインする場合は false です。 |
fillLevel |
文字列 |
設定する |
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" } }