スマートホームの EnergyStorage トレイトのスキーマ
action.devices.traits.EnergyStorage
- このトレイトは、バッテリーにエネルギーを蓄えて再充電できるデバイス、または別のデバイスを充電できるデバイスに使用します。
デバイスの属性
このトレイトを持つデバイスは、SYNC
オペレーションの一部として次の属性をレポートできます。SYNC
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
属性 | 種類 | 説明 |
---|---|---|
queryOnlyEnergyStorage |
ブール値 |
必須 このデバイスが、蓄積されたエネルギー レベルと、任意でアクティブな充電状態( |
energyStorageDistanceUnitForUX |
文字列 |
(デフォルト: ユーザーへの回答で使用されます。 サポートされている値:
|
isRechargeable |
ブール値 |
(デフォルト: このデバイスが再充電可能な場合は true に設定します。これは、デバイスが |
例
充電式デバイス
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
現在の充電レベルがマイル単位で表示される充電式デバイス
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
現在の充電レベルの報告のみをサポートする充電式ではないデバイス
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
デバイスのステータス
このトレイトを持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
状態 | 種類 | 説明 |
---|---|---|
descriptiveCapacityRemaining |
文字列 |
必須 エネルギー容量レベルの定性的表現。これは、数値容量データがない場合に使用します。数値容量のデータも利用できる場合は、可能であれば説明よりもデータを優先します。 サポートされている値:
|
capacityRemaining |
配列 |
デバイスが現在保持しているエネルギー容量に関する情報を保持する、単位と値のペアの配列。例: <device> の現在のバッテリー残量 または <device> のバッテリー残量 |
[item, ...] |
温度計 |
ユニットと値のペアの残りの容量。 |
rawValue |
整数 |
必須 容量の値。 |
unit |
文字列 |
必須 容量の単位。 サポートされている値:
|
capacityUntilFull |
配列 |
デバイスがフル充電されるまでの容量に関する情報を保持する単位と値のペアの配列。(例: 「<デバイス> がフル充電されるまでの時間」)。 |
[item, ...] |
温度計 |
充電されるまでの容量。 |
rawValue |
整数 |
必須 容量の値。 |
unit |
文字列 |
必須 容量の単位。 サポートされている値:
|
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
: コンセントにつながれていないデバイスを充電しようとしました。