Intencje inteligentnego domu to proste obiekty komunikacyjne, które opisują działanie smart home, takie jak włączenie światła lub przesyłanie dźwięku na głośnik.
Wszystkie intencje smart home znajdują się w przestrzeni nazw action.devices
i musisz je zrealizować. Za każdym razem, gdy element Google Assistant wysyła intencję do realizacji, w nagłówku autoryzacji jest przekazywany token dostępu OAuth 2 innej firmy.
Oto intencje smart home obsługiwane:
SYNC
Intencja action.devices.SYNC
służy do wysyłania próśb o listę urządzeń smart home połączonych przez użytkownika i których można używać.
Gdy użytkownik skonfiguruje swoje urządzenia z Google Home app (GHA), także zostanie uwierzytelniony w Twojej infrastrukturze w chmurze. Następnie Assistant otrzymuje token OAuth2. Na tym etapie Assistant wysyła intencję action.devices.SYNC
do Twojej realizacji, aby pobrać początkową listę urządzeń i możliwości użytkowników z Twojej infrastruktury chmurowej.

Aby uniknąć rozłączenia i ponownego połączenia konta użytkownika, możesz wysłać prośbę o synchronizację na konto Assistant. Spowoduje to wysłanie do realizacji intencji action.devices.SYNC
, aby zsynchronizować listę urządzeń i funkcji. Więcej informacji znajdziesz w artykule Implementowanie synchronizacji żądań.

Podczas konfiguracji lokalnej realizacji platforma Google Home sprawdza odpowiedź SYNC
z realizacji akcji w chmurze akcji smart home. Więcej informacji o zmienianiu odpowiedzi SYNC
na obsługę lokalnej realizacji zamówień znajdziesz w artykule Aktualizowanie odpowiedzi SYNC w realizacji w chmurze.
ZAPYTANIE
Intencja action.devices.QUERY
jest używana do wysyłania zapytań dotyczących bieżącego stanu urządzeń smart home.
Gdy użytkownicy sprawdzają stan urządzenia, aby znaleźć odpowiedź na pytanie takie jak OK Google, jakie światła w kuchni są włączone?.
Assistant wysyła intencję action.devices.QUERY
do Twojej realizacji.

Aby wszystko działało jak najlepiej, musisz wdrożyć stan raportowania, aby aktywnie przekazywać informacje o bieżącym stanie urządzeń użytkowników bezpośrednio do Google Home Graph. Dzięki temu Assistant może na przykład sprawdzić, czy użytkownik włączył inteligentne oświetlenie z przełącznikiem światła.

WYKONAJ
Intencja action.devices.EXECUTE
służy do wykonywania poleceń na urządzeniach z smart home.
Gdy użytkownicy wysyłają polecenia do urządzeń z Assistant, Twoja realizacja otrzymuje intencję action.devices.EXECUTE
opisującą działanie i urządzenia, na których ma działać. Użytkownik może wykonać działanie na urządzeniu za pomocą polecenia takiego jak OK Google, włącz światło w salonie.

ODŁĄCZ
Intencja action.devices.DISCONNECT
jest powiadamiana, gdy użytkownik odłączył konto aplikacji od konta Assistant.
Po odebraniu intencji action.devices.DISCONNECT
nie należy zgłaszać stanu urządzeń tego użytkownika.