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:

SUCCESS
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:

FAILURE
errorCode String

Wymagane.

Wartością może być dowolny kod błędu tej cechy, na przykład deviceStuck.

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"
  }
}

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.