スマートホームの 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 |
Number |
|
例
「バスタブにお湯は入ってる?」
{ "isFilled": true }
浴槽はいっぱいになっていますか?(レベルによる)。
{ "isFilled": true, "currentFillLevel": "half_level" }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一環として次のコマンドに応答できます。EXECUTE
インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。
action.devices.commands.Fill
デバイスを充填または排水します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
fill |
ブール値 |
必須。 true に設定すると、false でドレインされます。 |
fillLevel |
文字列 |
設定する |
fillPercent |
Number |
リクエストされたレベルの割合を示します。 |
例
浴槽に湯を入れます。
{ "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" } }