Intencje dotyczące inteligentnego domu to proste obiekty służące do przesyłania wiadomości, które opisują, jakie działanie smart home ma wykonać, np. włączyć światło lub przesłać dźwięk na głośnik.
Wszystkie intencje smart home znajdują się w przestrzeni nazw action.devices
i musisz zapewnić ich realizację. Za każdym razem, gdy Google Assistant wysyła intencję do realizacji, zewnętrzny token dostępu OAuth 2 użytkownika jest przekazywany w nagłówku Authorization.
Oto obsługiwane intencje smart home:
SYNC
Intencja action.devices.SYNC
służy do żądania listy smart home urządzeń, które użytkownik połączył i są dostępnych do użycia.
Gdy użytkownik skonfiguruje swoje urządzenia przy użyciu Google Home app (GHA), zostanie też uwierzytelniony w Twojej infrastrukturze w chmurze. Następnie Assistant otrzymuje token OAuth2. Na tym etapie Assistant wysyła do Twojej realizacji intencję action.devices.SYNC
, aby pobrać początkową listę urządzeń i możliwości użytkowników z Twojej infrastruktury w chmurze.

Aby uniknąć rozłączania i ponownego łączenia konta użytkownika, możesz wysłać prośbę o synchronizację do Assistant. Spowoduje to wysłanie do realizacji intencji action.devices.SYNC
w celu zsynchronizowania listy urządzeń i funkcji. Więcej informacji znajdziesz w artykule o implementowaniu synchronizacji żądań.

Podczas konfiguracji realizacji lokalnej platforma lokalna strona główna sprawdza odpowiedź SYNC
z realizacji transakcji smart home w chmurze. Więcej informacji o tym, jak zmodyfikować odpowiedź SYNC
pod kątem obsługi lokalnej realizacji, znajdziesz w artykule Aktualizowanie odpowiedzi SYNC w realizacji w chmurze.
ZAPYTANIE
Intencja action.devices.QUERY
służy do wysyłania zapytań dotyczących bieżącego stanu urządzeń smart home.
gdy użytkownicy pytają o stan urządzenia, odpowiadają na przykład na OK Google, jakie światła świecą się w kuchni?,
Assistant wysyła intencję action.devices.QUERY
do realizacji.

Aby zadbać o wygodę użytkowników, warto zaimplementować stan raportu, aby aktywnie raportować bieżący stan urządzeń użytkownika bezpośrednio do usługi Google Home Graph. Dzięki temu Assistant może na przykład wiedzieć, czy użytkownik włączył inteligentne oświetlenie za pomocą fizycznego przełącznika światła.

ZREALIZUJ
Intencja action.devices.EXECUTE
służy do udostępniania poleceń do wykonywania na urządzeniach z smart home.
Gdy użytkownicy wysyłają polecenia do urządzeń z Assistant, Twoja realizacja otrzymuje intencję action.devices.EXECUTE
do realizacji zamówienia, która zawiera opis działania i urządzeń, na których ma wykonać działanie. Użytkownik może wykonać działanie na urządzeniu, używając polecenia, np. OK Google, włącz światło w salonie.

ODŁĄCZ
Intencja action.devices.DISCONNECT
jest aktywowana, aby poinformować Cię o odłączeniu konta w aplikacji od konta Assistant.
Po otrzymaniu intencji action.devices.DISCONNECT
nie należy raportować stanu urządzeń tego użytkownika.