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 |
energyStorageDistanceUnitForUX |
Ciąg |
(domyślnie: Będzie on używany w odpowiedziach użytkownika. Obsługiwane wartości:
|
isRechargeable |
Wartość logiczna |
(domyślnie: Ustaw wartość „true”, jeśli urządzenie można doładować. Oznacza to, że urządzenie może raportować stan |
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:
|
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:
|
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:
|
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.