Schemat funkcji przechowywania energii w inteligentnym domu

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

Urządzenie ATTRIBUTES

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

Atrybuty	Typ	Opis
queryOnlyEnergyStorage	Wartość logiczna	Wymagane. Wartość to „prawda”, jeśli urządzenie obsługuje tylko zapytania o poziomy zgromadzonych energii i opcjonalnie aktywnego stanu ładowania (w zależności od atrybutu isRechargeable), ale nie obsługuje uruchamiania ani zatrzymywania ładowania.
energyStorageDistanceUnitForUX	String	(Domyślnie: "KILOMETERS") Będzie używana w odpowiedziach udzielanych przez użytkownika. Obsługiwane wartości: KILOMETERS MILES
isRechargeable	Wartość logiczna	(Domyślnie: false) Ustaw na „prawda”, jeśli urządzenie można ponownie naładować. Oznacza to, że urządzenie może zgłaszać stany capacityUntilFull, isCharging i opcjonalnie isPluggedIn i może przyjmować polecenie Charge.

Przykłady

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

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

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

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

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

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

Urządzenie STATES

Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule o realizacji intencji.

Stany	Typ	Opis
descriptiveCapacityRemaining	String	Wymagane. Opis jakościowy poziomu energii. Pamiętaj, że dzieje się tak, gdy nie ma liczbowych danych dotyczących wydajności. Jeśli dostępne są również numeryczne dane o pojemności, w miarę możliwości będą preferowane zamiast opisowe. Obsługiwane wartości: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Tablica	Tablica par jednostka/wartość, w których przechowywane są informacje o mocy energetycznej urządzenia. Na przykład: Ile mil ma obecnie urządzenie <device> lub Jaki jest procent naładowania urządzenia <device>?
[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ść, w której przechowywane są informacje o pojemności do chwili pełnego naładowania urządzenia. Na przykład: czas do pełnego naładowania urządzenia <device>.
[item, ...]	Obiekt	Pojemność do chwili ł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	Określa, czy urządzenie aktualnie się ładuje.
isPluggedIn	Wartość logiczna	Określa, czy urządzenie jest obecnie podłączone do zasilania. Urządzenie może być podłączone do zasilania, 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 do ładowania, 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 ładowarki, które obsługuje tylko raportowanie bieżącego poziomu naładowania baterii

{
  "descriptiveCapacityRemaining": "LOW"
}

CommandS na urządzeniu

Urządzenia z tą cechą mogą reagować na podane niżej 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 tych atrybutów:

{
  "isRechargeable": true
}

Parametry

Parametry	Typ	Opis
charge	Wartość logiczna	Wymagane. Prawda, aby rozpocząć ładowanie, false, aby zakończyć ładowanie.

Przykłady

Rozpocznij ładowanie

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

Polecenie zakończenia ł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.