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.