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 |
energyStorageDistanceUnitForUX |
String |
(Domyślnie: Będzie używana w odpowiedziach udzielanych przez użytkownika. Obsługiwane wartości:
|
isRechargeable |
Wartość logiczna |
(Domyślnie: Ustaw na „prawda”, jeśli urządzenie można ponownie naładować. Oznacza to, że urządzenie może zgłaszać stany |
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:
|
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:
|
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:
|
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.