スマートホームの EnergyStorage トレイトのスキーマ
action.devices.traits.EnergyStorage
- このトレイトは、バッテリーにエネルギーを蓄えて再充電できる可能性のあるデバイス、または別のデバイスを充電できるデバイスに使用します。
デバイスの属性
このトレイトを持つデバイスは、以下をレポートすることがあります。
SYNC
オペレーションの一部として使用できます。学習内容
SYNC
インテントの処理の詳細については、以下をご覧ください。
インテント フルフィルメント。
属性 | タイプ | 説明 |
---|---|---|
queryOnlyEnergyStorage |
ブール値 |
必須。 このデバイスが、保存されたエネルギー レベルと、オプションでアクティブな充電状態( |
energyStorageDistanceUnitForUX |
String |
(デフォルト: ユーザーへの応答で使用されます。 サポートされている値:
|
isRechargeable |
ブール値 |
(デフォルト: このデバイスが充電式の場合は true に設定します。これは、デバイスが |
例
充電式デバイス
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
現在の充電レベルをマイルで表示する充電式デバイス
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
現在の充電レベルの報告しかサポートしていない非充電式デバイス
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
デバイスのステータス
このトレイトを持つエンティティは、以下を報告する場合があります。
複数の状態を QUERY
オペレーションの一部として呼び出します。学習内容
QUERY
インテントの処理の詳細については、以下をご覧ください。
インテント フルフィルメント。
州 | タイプ | 説明 |
---|---|---|
descriptiveCapacityRemaining |
String |
必須。 エネルギー容量レベルの定性的記述。これは、数値容量データがない場合のためです。数値による容量データも利用可能な場合は、可能であれば記述データよりもそのデータが優先されます。 サポートされている値:
|
capacityRemaining |
配列 |
デバイスが現在保持しているエネルギー容量に関する情報を保持する単位と値のペアの配列。例: <デバイス> の走行距離は?現在充電されていますか?<device> のバッテリー残量はどのくらいですか?持っている |
[item, ...] |
オブジェクト |
ユニットと値のペアで表された残りの容量。 |
rawValue |
整数 |
必須。 容量の値。 |
unit |
String |
必須。 容量単位。 サポートされている値:
|
capacityUntilFull |
配列 |
デバイスが完全に充電されるまでの容量に関する情報を保持する単位と値のペアの配列。例: <デバイス> までの所要時間フル充電されている。 |
[item, ...] |
オブジェクト |
充電までの容量。 |
rawValue |
整数 |
必須。 容量の値。 |
unit |
String |
必須。 容量単位。 サポートされている値:
|
isCharging |
ブール値 |
デバイスが現在充電中かどうか。 |
isPluggedIn |
ブール値 |
デバイスが現在コンセントにつながれているかどうか。デバイスは電源に接続されていますが、アクティブに充電されていません。 |
例
充電式デバイス
{ "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "rawValue": 36000, "unit": "SECONDS" }, { "rawValue": 90, "unit": "PERCENTAGE" } ], "capacityUntilFull": [ { "rawValue": 120, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
現在の充電レベルをマイルで表示する充電式デバイス
{ "descriptiveCapacityRemaining": "CRITICALLY_LOW", "capacityRemaining": [ { "rawValue": 12, "unit": "MILES" } ], "capacityUntilFull": [ { "rawValue": 6000, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
現在の充電レベルの報告のみをサポートする非充電式デバイス
{ "descriptiveCapacityRemaining": "LOW" }
デバイスのコマンド
このトレイトを持つデバイスは、以下の動作に反応します。
コマンドを EXECUTE
オペレーションの一部として使用できます。学習内容
EXECUTE
インテントの処理の詳細については、以下をご覧ください。
インテント フルフィルメント。
action.devices.commands.Charge
充電を開始または停止する。
このコマンドには、次の属性が必要です。{ "isRechargeable": true }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
charge |
ブール値 |
必須。 充電を開始する場合は true、充電を停止する場合は false。 |
例
充電開始コマンド
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
充電停止コマンド
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
デバイスエラー
詳しくは、 エラーと例外をご覧ください。deviceUnplugged
: コンセントにつながれていないデバイスを充電しようとしました。