スマートホームの EnergyStorage トレイトのスキーマ

action.devices.traits.EnergyStorage - このトレイトは、バッテリーにエネルギーを蓄えて再充電できる可能性のあるデバイス、または別のデバイスを充電できるデバイスに使用します。

デバイスの属性

このトレイトを持つデバイスは、以下をレポートすることがあります。 SYNC オペレーションの一部として使用できます。学習内容 SYNC インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

属性 タイプ 説明
queryOnlyEnergyStorage ブール値

必須。

このデバイスが、保存されたエネルギー レベルと、オプションでアクティブな充電状態（isRechargeable 属性に依存）に関するクエリのみをサポートしているが、充電の開始と停止をサポートしていない場合は true。
energyStorageDistanceUnitForUX String

（デフォルト: "KILOMETERS"）。

ユーザーへの応答で使用されます。

サポートされている値:

KILOMETERS
MILES
isRechargeable ブール値

（デフォルト: false）。

このデバイスが充電式の場合は true に設定します。これは、デバイスが capacityUntilFull、isCharging、および必要に応じて isPluggedIn 状態を報告し、Charge コマンドを受け入れることができることを示します。

例

充電式デバイス

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

現在の充電レベルをマイルで表示する充電式デバイス

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

現在の充電レベルの報告しかサポートしていない非充電式デバイス

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

デバイスのステータス

このトレイトを持つエンティティは、以下を報告する場合があります。 複数の状態を QUERY オペレーションの一部として呼び出します。学習内容 QUERY インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

州 タイプ 説明
descriptiveCapacityRemaining String

必須。

エネルギー容量レベルの定性的記述。これは、数値容量データがない場合のためです。数値による容量データも利用可能な場合は、可能であれば記述データよりもそのデータが優先されます。

サポートされている値:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining 配列

デバイスが現在保持しているエネルギー容量に関する情報を保持する単位と値のペアの配列。例: <デバイス> の走行距離は？現在充電されていますか？<device> のバッテリー残量はどのくらいですか？持っている
[item, ...] オブジェクト

ユニットと値のペアで表された残りの容量。
rawValue 整数

必須。

容量の値。
unit String

必須。

容量単位。

サポートされている値:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull 配列

デバイスが完全に充電されるまでの容量に関する情報を保持する単位と値のペアの配列。例: <デバイス> までの所要時間フル充電されている。
[item, ...] オブジェクト

充電までの容量。
rawValue 整数

必須。

容量の値。
unit String

必須。

容量単位。

サポートされている値:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
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: コンセントにつながれていないデバイスを充電しようとしました。