Schemat cechy Smart Home RunCycle
action.devices.traits.RunCycle
– ta cecha reprezentuje dowolne urządzenie, które ma ciągły czas działania, które może być objęte zapytaniem.
Po rozpoczęciu pracy urządzenia takie jak to podają całkowitą liczbę cykli i w każdym cyklu, w którym obecnie działa urządzenie. Dzięki temu użytkownik może tworzyć zapytania, na przykład:
- W jakim cyklu działa suszarka?
- Ile cykli zostało do końca zmywarki?
- Co robi suszarka?
- Kiedy będzie pranie?
Niektóre urządzenia mają czas trwania w formacie niecyklicznym. Dowolne urządzenie która działa przez określony czas, może podawać w raportach czas do końca, bez cykliczną. Dotyczy to też przypadków, gdy cykle mogą nie być spójne (na przykład zmywarki mogą czasem nie włączać wszystkich cykli). Użytkownik może na przykład zapytać: Jak Czy odkurzacz będzie działał dłużej?, co zwróci ilość czasu w jednostkach. proporcjonalne do pozostałego czasu. Dotyczy to również urządzeń z listy powyżej; Jak długo moje ubrania będą suszyć, funkcja zwróci czas w minutach.
Urządzenia mogą zwracać swoją wiedzę, a odpowiedzi na zamianę tekstu na mowę w Asystencie tworzą Użyj dostępnych danych, by wybrać najlepszą odpowiedź (na przykład Zmywarka jest uruchomiona i zajmie około 20 minut).
RunCycle to obecnie cecha tylko do odczytu – nie zawiera poleceń, a tylko stany zapytania. W przyszłości mogą istnieć mechanizmy ponownego uruchamiania cykli lub pomijania cykli (dobrze sprawdza się zraszacz, źle sprawdza się w pralkach).
Urządzenia – ATTRIBUTES
Brak.
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 |
---|---|---|
currentRunCycle |
Tablica |
Wymagane. Zawiera synonimy bieżącego cyklu w każdym obsługiwanym języku. |
[item, ...] |
Obiekt. |
Przełącz nazwy synonimów. |
currentCycle |
String |
Wymagane. Wykonuję teraz cykl. |
nextCycle |
String |
Opcjonalnie: Następny cykl do wykonania. |
lang |
String |
Wymagane. Kod języka dla podanych nazw cykli. Zobacz Obsługiwane języki. |
currentTotalRemainingTime |
Liczba całkowita |
Wymagane. Czas pozostały do końca operacji w sekundach. |
currentCycleRemainingTime |
Liczba całkowita |
Wymagane. Czas do końca bieżącego cyklu (w sekundach). |
Przykłady
Urządzenie będzie płukane przez kolejne 5 minut i skończy się za 20 minut.
{ "currentRunCycle": [ { "currentCycle": "rinse", "lang": "en" } ], "currentTotalRemainingTime": 1200, "currentCycleRemainingTime": 300 }
Urządzenie będzie płukane przez kolejne 5 minut, zanim zacznie się kręcić.
{ "currentRunCycle": [ { "currentCycle": "rinse", "nextCycle": "spin", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300 }
Polecenia na urządzeniu
Brak.
POWIADOMIENIA NA urządzeniu
Urządzenia z tą cechą mogą zwracać te wartości: ładunek powiadomień w ramach zmiany stanu urządzenia. Aby się uczyć więcej o implementowaniu powiadomień, zobacz Powiadomienia dotyczące działań inteligentnego domu.
Pola | Typ | Opis |
---|---|---|
RunCycle |
Wymagane. Dane powiadomień. |
|
Obsługuje jeden z tych formatów: | ||
0
|
Obiekt. |
Sukces |
priority |
Liczba całkowita |
Wymagane. Reprezentuje poziom powiadomień. Obecnie obsługiwana wartość to 0, co oznacza, że powiadomienie powinno być wypowiadane na głos. |
status |
String |
Wymagane. Wynik operacji. Obsługiwane wartości:
|
currentCycleRemainingTime |
Liczba całkowita |
Wymagane. Czas do końca bieżącego cyklu (w sekundach). |
1
|
Obiekt. |
Niepowodzenie |
priority |
Liczba całkowita |
Wymagane. Reprezentuje poziom powiadomień. Obecnie obsługiwana wartość to 0, co oznacza, że powiadomienie powinno być wypowiadane na głos. |
status |
String |
Wymagane. Wynik operacji. Obsługiwane wartości:
|
errorCode |
String |
Wymagane. Wartością może być dowolny kod błędu tej cechy, na przykład |
Przykłady
Urządzenie przestało działać.
{ "RunCycle": { "priority": 0, "status": "SUCCESS", "currentCycleRemainingTime": 0 } }
Podczas zakończenia bieżącego cyklu wystąpił błąd.
{ "RunCycle": { "priority": 0, "status": "FAILURE", "errorCode": "deviceStuck" } }