Schemat cechy EnergyStorage dla inteligentnego domu

action.devices.traits.EnergyStorage – ta cecha należy do urządzeń, które mogą gromadzić energię w baterii i potencjalnie ładować się lub ładować inne urządzenie.

ATRYBUTY URZĄDZENIA

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

Atrybuty Typ Opis
queryOnlyEnergyStorage Wartość logiczna

Wymagany.

Wartość True (prawda), jeśli to urządzenie obsługuje tylko zapytania dotyczące poziomów energii i opcjonalnie aktywnego stanu ładowania (zależnego od atrybutu isRechargeable), ale nie obsługuje uruchamiania i zatrzymywania ładowania.
energyStorageDistanceUnitForUX String

(wartość domyślna: "KILOMETERS")

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

Obsługiwane wartości:

KILOMETERS
MILES
isRechargeable Wartość logiczna

(Domyślnie: false)

Ustaw na Prawda, jeśli urządzenie jest akumulatorowe. Oznacza to, że urządzenie może raportować stan capacityUntilFull, isCharging i opcjonalnie isPluggedIn oraz może przyjmować polecenie Charge.

Przykłady

Urządzenie wielokrotnego ł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
}

Nienaładowalne urządzenie, które obsługuje tylko raportowanie bieżącego poziomu naładowania

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

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY. Więcej informacji o obsługiwaniu intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
descriptiveCapacityRemaining String

Wymagany.

jakościowy opis poziomu pojemności energii; Pamiętaj, że dotyczy to sytuacji, gdy nie ma danych liczbowych dotyczących pojemności. Jeśli dostępne są też dane liczbowe o mocy obliczeniowej, w miarę możliwości będą one preferowane w stosunku do danych opisowych.

Obsługiwane wartości:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Tablica

Tablica par jednostka/wartość zawierająca informacje o pojemności energii posiadanej obecnie przez urządzenie. Na przykład: Ile kilometrów przejechało moje urządzenie <device> lub Ile procent naładowania ma moje urządzenie <device>
[item, ...] Obiekt

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

Wymagane.

Wartość pojemności.
unit String

Wymagane.

Jednostka pojemności.

Obsługiwane wartości:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Tablica

Tablica par jednostka/wartość, które zawierają informacje o pojemności do czasu pełnego naładowania urządzenia. Na przykład: Ile czasu zajmie pełne naładowanie urządzenia <device>.
[item, ...] Obiekt

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

Wymagane.

Wartość pojemności.
unit String

Wymagane.

Jednostka pojemności.

Obsługiwane wartości:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Wartość logiczna

czy urządzenie jest w tej chwili ładowane.
isPluggedIn Wartość logiczna

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

Przykłady

Urządzenie wielokrotnego ł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
}

Nienaładowalne urządzenie, które obsługuje tylko raportowanie bieżącego poziomu naładowania

{
  "descriptiveCapacityRemaining": "LOW"
}

Polecenia 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 o realizacji intencji.

action.devices.commands.Charge

Rozpocznij lub zatrzymaj ładowanie.

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

Parametry

Parametry Typ Opis
charge Wartość logiczna

Wymagane.

Prawda – aby rozpocząć ładowanie, fałsz – aby je zatrzymać.

Przykłady

Polecenie ł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 jest podłączone.