Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Schemat inteligentnego domu – RunCycle

action.devices.traits.RunCycle – to cecha dowolnego urządzenia, które przez określony czas działa w sposób objęty zapytaniem.

Urządzenia tego typu podają łączną liczbę cykli na początku działania i każdy cykl, w którym aktualnie jest. Dzięki temu użytkownik może wysyłać zapytania, na przykład:

  • W jakim cyklu jest suszarka?
  • Ile cykli pozostało zmywarka?
  • Czym zajmuje się suszarka?
  • Kiedy mycie zostanie wykonane?

Niektóre urządzenia mają czas trwania określony w formacie niecyklicznym. Każde urządzenie, które działa przez określony czas, może zgłaszać pozostały czas bez żadnych cykli. Funkcja ta sprawdza się też w przypadkach, w których cykle mogą być niespójne (np. zmywarki nie zawsze korzystają z pełnej wersji cykli). Użytkownik może na przykład zapytać Jak długo będzie działać odkurzacz?, co spowoduje zwrócenie informacji o czasie w jednostkach proporcjonalnych do pozostałego czasu. Dotyczy to też wymienionych powyżej urządzeń. Jak długo będzie suszyć moje ubrania?.

Urządzenia mogą zwrócić to, co wiedzą, a odpowiedź Asystenta TTS to najlepsza odpowiedź na podstawie dostępnych danych (np. zmywarka jest uruchomiona i zakończy działanie w ciągu 20 minut).

RunCycle jest obecnie funkcją tylko do odczytu – nie ma poleceń, tylko stany do wysłania zapytania. W przyszłości mogą istnieć mechanizmy ponownego uruchamiania cykli ponownego skanowania lub pominięcia.

ATRYBUTY urządzenia

Brak.

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
currentRunCycle Tablica

Wymagany.

Zawiera synonimy bieżącego cyklu w każdym obsługiwanym języku.

[item, ...] Obiekt

Nazwy synonimów cyklu.

currentCycle Ciąg

Wymagany.

Bieżący cykl.

nextCycle Ciąg

Opcjonalnie. Następny cykl do wykonania.

lang Ciąg

Wymagany.

Kod języka dla podanych nazw cykli. Zobacz Obsługiwane języki.

currentTotalRemainingTime Liczba całkowita

Wymagany.

Czas trwania operacji w sekundach.

currentCycleRemainingTime Liczba całkowita

Wymagany.

Czas pozostały do bieżącego cyklu (w sekundach).

Przykłady

Urządzenie będzie w trybie płukania jeszcze przez 5 minut i zakończy się w ciągu 20 minut.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

Urządzenie przechodzi do płukania jeszcze przez 5 minut, a potem wiruje.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

Polecenie urządzenia

Brak.

POWIADOMIENIA O URZĄDZENIACH

W przypadku zmiany stanu urządzenia urządzenia z tą cechą mogą zwracać ładunek powiadomień. Więcej informacji o wdrażaniu powiadomień znajdziesz w artykule Powiadomienia dotyczące inteligentnych działań w domu.

Pola Typ Opis
RunCycle

Wymagany.

Ładunek powiadomienia.

Obsługuje jedną z tych opcji:
0 Obiekt

Sukces

priority Liczba całkowita

Wymagany.

Określa poziom powiadomienia. Obecnie obsługiwana wartość to 0, co oznacza, że powiadomienie powinno być odczytywane na głos.

status Ciąg

Wymagany.

Wynik operacji.

Obsługiwane wartości:

SUCCESS
currentCycleRemainingTime Liczba całkowita

Wymagany.

Czas pozostały do bieżącego cyklu (w sekundach).

1 Obiekt

Niepowodzenie

priority Liczba całkowita

Wymagany.

Określa poziom powiadomienia. Obecnie obsługiwana wartość to 0, co oznacza, że powiadomienie powinno być odczytywane na głos.

status Ciąg

Wymagany.

Wynik operacji.

Obsługiwane wartości:

FAILURE
errorCode Ciąg

Wymagany.

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

Przykłady

Urządzenie przestało działać.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

Podczas wykonywania 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.