スマートホーム 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 |
配列 |
デバイスが現在保持しているエネルギー容量に関する情報を保持する単位と値のペアの配列。例: 現在の <デバイス> の距離は何マイルですか? |
[item, ...] |
温度計 |
ユニットと値のペアの残りの容量。 |
rawValue |
Integer |
必須。 容量の値。 |
unit |
String |
必須。 容量の単位。 サポートされる値:
|
capacityUntilFull |
配列 |
デバイスが完全に充電されるまでの容量に関する情報を保持するユニットと値のペアの配列。(例: <デバイス> が完全に充電されるまでの時間)。 |
[item, ...] |
温度計 |
充電可能 |
rawValue |
Integer |
必須。 容量の値。 |
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
: コンセントにつながれていないデバイスを充電しようとしました。