Schemat inteligentnego domu EnergyStorage

action.devices.traits.EnergyStorage – ten atrybut należy do urządzeń, które mogą przechowywać energię w baterii i mogą się naładować.

ATRYBUTY urządzenia

W ramach operacji SYNC urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w sekcji Realizacja intencji.

Atrybuty	Typ	Opis
queryOnlyEnergyStorage	Wartość logiczna	Wymagany. Wartość to „prawda”, jeśli urządzenie obsługuje tylko zapytania o zapisany poziom energii i opcjonalnie stan ładowania aktywnego (zależnie od atrybutu isRechargeable), ale nie obsługuje rozpoczynania i zatrzymywania ładowania.
energyStorageDistanceUnitForUX	Ciąg	(domyślnie: "KILOMETERS") Będzie on używany w odpowiedziach użytkownika. Obsługiwane wartości: KILOMETERS MILES
isRechargeable	Wartość logiczna	(domyślnie: false) Ustaw wartość „true”, jeśli urządzenie można doładować. Oznacza to, że urządzenie może raportować stan capacityUntilFull, isCharging i opcjonalnie isPluggedIn, a także akceptować polecenie Charge.

Przykłady

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

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

Urządzenie z możliwością ładowania, które pokazuje aktualny poziom naładowania w milach

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

Urządzenie, którego nie można ponownie naładować, obsługujące wyłącznie raportowanie bieżącego poziomu naładowania

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

Urządzenie STATES

W ramach operacji QUERY encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany	Typ	Opis
descriptiveCapacityRemaining	Ciąg	Wymagany. Wysokiej jakości opis poziomu energii. Dotyczy to sytuacji, gdy nie ma żadnych danych liczbowych. Jeśli dostępne są również dane liczbowe dotyczące pojemności, w miarę możliwości będą miały pierwszeństwo przed opisami. Obsługiwane wartości: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Tablica	Tablica par jednostki/wartości, które zawierają informacje o zdolności energetycznej urządzenia. Na przykład: Ile mil korzysta obecnie z urządzenia <device> lub Jakie procent naładowania baterii ma <device>?
[item, ...]	Obiekt	Pozostały rozmiar w parze jednostki i wartości.
rawValue	Liczba całkowita	Wymagany. Wartość pojemności.
unit	Ciąg	Wymagany. Jednostka pojemności. Obsługiwane wartości: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Tablica	Tablica par jednostki/wartości przechowujących 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 <device>.
[item, ...]	Obiekt	Wydajność do naładowania.
rawValue	Liczba całkowita	Wymagany. Wartość pojemności.
unit	Ciąg	Wymagany. Jednostka pojemności. Obsługiwane wartości: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Wartość logiczna	Określa, czy urządzenie się ładuje.
isPluggedIn	Wartość logiczna	Wskazuje, czy urządzenie jest podłączone. Urządzenie można podłączyć, ale się nie ładuje.

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 możliwością ładowania, które pokazuje 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, którego nie można ponownie naładować, obsługujące wyłącznie raportowanie bieżącego poziomu naładowania

{
  "descriptiveCapacityRemaining": "LOW"
}

Polecenie urządzenia

W ramach operacji EXECUTE urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji 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	Wymagany. Prawda, aby rozpocząć ładowanie, fałsz, aby zatrzymać ładowanie

Przykłady

Rozpocznij ładowanie polecenia

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

Zatrzymaj ładowanie polecenia

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

Urządzenie ERRORS

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

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