Schemat cechy Smart Home EnergyStorage

action.devices.traits.EnergyStorage – ta cecha dotyczy urządzeń, które mogą przechowywać energię w baterii i potencjalnie ją ładować, lub urządzeń, które mogą ładować inne urządzenia.

ATRYBUTY urządzenia

Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
queryOnlyEnergyStorage Wartość logiczna

Wymagane.

Wartość „true”, jeśli to urządzenie obsługuje tylko zapytania o poziomy zmagazynowanej energii i opcjonalnie o stan aktywnego ładowania (zależny od atrybutu isRechargeable), ale nie obsługuje rozpoczynania i zatrzymywania ładowania.
energyStorageDistanceUnitForUX String

(Domyślnie: "KILOMETERS")

Będzie używana w odpowiedziach dla użytkownika.

Obsługiwane wartości:

KILOMETERS
MILES
isRechargeable Wartość logiczna

(Domyślnie: false)

Ustaw wartość „true”, jeśli urządzenie można ładować. Oznacza to, że urządzenie może raportować stan capacityUntilFull, isCharging i opcjonalnie isPluggedIn oraz może akceptować polecenie Charge.

Przykłady

Urządzenie z możliwością ładowania

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

Urządzenie z akumulatorem, które wyświetla aktualny poziom naładowania w milach

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

Urządzenie bez możliwości ładowania, które obsługuje tylko raportowanie bieżącego poziomu naładowania

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

Stany urządzenia

Podmioty z tą cechą mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
descriptiveCapacityRemaining String

Wymagane.

Opis jakościowy poziomu pojemności energetycznej. Dotyczy sytuacji, gdy nie ma danych liczbowych dotyczących pojemności. Jeśli dostępne są też dane liczbowe dotyczące pojemności, będą one preferowane w miarę możliwości.

Obsługiwane wartości:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Tablica

Tablica par jednostka/wartość zawierających informacje o aktualnej pojemności energetycznej urządzenia. Na przykład: Ile kilometrów ma obecnie mój <device> lub Jaki jest poziom naładowania mojego <device>
[item, ...] Obiekt

Pozostała pojemność w parze jednostka i wartość.
rawValue Liczba całkowita

Wymagane.

Wartość rozmiaru.
unit String

Wymagane.

Jednostka pojemności.

Obsługiwane wartości:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Tablica

Tablica par jednostka/wartość, która zawiera informacje o pojemności do momentu pełnego naładowania urządzenia. Na przykład: Ile czasu zostało do pełnego naładowania <urządzenia>.
[item, ...] Obiekt

Pojemność do momentu naładowania.
rawValue Liczba całkowita

Wymagane.

Wartość rozmiaru.
unit String

Wymagane.

Jednostka pojemności.

Obsługiwane wartości:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Wartość logiczna

Czy urządzenie się obecnie ładuje.
isPluggedIn Wartość logiczna

Czy urządzenie jest obecnie podłączone do zasilania. Urządzenie może być podłączone, ale nie musi się aktywnie ładować.

Przykłady

Urządzenie z możliwością ładowania

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Urządzenie z akumulatorem, które wyświetla aktualny poziom naładowania w milach

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Urządzenie bez możliwości ładowania, które obsługuje tylko raportowanie bieżącego poziomu naładowania

{
  "descriptiveCapacityRemaining": "LOW"
}

Polecenia dotyczące urządzenia

Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.Charge

Rozpocznij lub zatrzymaj ładowanie.

To polecenie wymaga tych atrybutów: 
{
  "isRechargeable": true
}

Parametry

Parametry Typ Opis
charge Wartość logiczna

Wymagane.

Wartość „true” oznacza rozpoczęcie ładowania, a „false” – zakończenie ładowania.

Przykłady

Polecenie rozpoczęcia ładowania

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

Polecenie zatrzymania ładowania

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

BŁĘDY urządzenia

Zobacz pełną listę błędów i wyjątków.

deviceUnplugged: użytkownik próbował naładować urządzenie, które nie było podłączone do zasilania.