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.