Schemat cech funkcji Smart Home EnergyStorage

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

Urządzenia – ATTRIBUTES

Urządzenia z tą cechą mogą zgłaszać te problemy jako część operacji SYNC. Aby się uczyć więcej informacji o obsłudze intencji SYNC znajdziesz tutaj Realizacja intencji.

Atrybuty	Typ	Opis
queryOnlyEnergyStorage	Wartość logiczna	Wymagane. Prawda, jeśli to urządzenie obsługuje tylko zapytania o poziom zmagazynowanej energii i opcjonalnie stan aktywnego ładowania (zależnie od atrybutu isRechargeable), ale nie obsługuje rozpoczynania ani zatrzymywania ładowania.
energyStorageDistanceUnitForUX	String	(Domyślnie: "KILOMETERS") Będzie używane w odpowiedziach wysyłanych do użytkowników. Obsługiwane wartości: KILOMETERS MILES
isRechargeable	Wartość logiczna	(Domyślnie: false) Ustaw wartość Prawda, jeśli to urządzenie można ponownie ładować. Oznacza to, że urządzenie może zgłaszać stan capacityUntilFull, isCharging i opcjonalnie isPluggedIn oraz zaakceptować polecenie Charge.

Przykłady

Urządzenie wielokrotnego ładowania

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

Urządzenie akumulatorowe, 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
}

Urządzenie STATES

Jednostki o tej cechie mogą zgłaszać: stanów w ramach operacji QUERY. Aby się uczyć więcej informacji o obsłudze intencji QUERY znajdziesz tutaj Realizacja intencji.

Stany	Typ	Opis
descriptiveCapacityRemaining	String	Wymagane. Jakościowy opis poziomu pojemności energetycznej. Pamiętaj, że ma to zastosowanie, gdy nie ma wartości liczbowych dotyczących pojemności. 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 opisowymi danymi. 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 mil przejechał moje urządzenie <device> obecnie lub W jakim procentie jest ładowane urządzenie <device>? zawierają
[item, ...]	Obiekt.	Pozostała pojemność w parze jednostki i wartości.
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ść przechowuje informacje o pojemności do momentu pełnego naładowania urządzenia. Na przykład: Ile czasu zostało do <device> jest w pełni naładowana.
[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	Wskazuje, czy urządzenie się ładuje.
isPluggedIn	Wartość logiczna	Wskazuje, czy urządzenie jest obecnie podłączone. 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 akumulatorowe, 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 na urządzeniu

Urządzenia z tą cechą mogą reagować na: w ramach operacji EXECUTE. Aby się uczyć więcej informacji o obsłudze intencji EXECUTE znajdziesz tutaj Realizacja intencji.

action.devices.commands.Charge

Rozpocznij lub zatrzymaj ładowanie.

To polecenie wymaga następujących atrybutów:

{
  "isRechargeable": true
}

Parametry

Parametry	Typ	Opis
charge	Wartość logiczna	Wymagane. Ustaw wartość True, aby rozpocząć ładowanie, false, aby zatrzymać ładowanie.

Przykłady

Polecenie ładowania

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

Polecenie zatrzymania ładowania

{
  "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ł naładować urządzenie, które nie jest podłączone do zasilania.