Realizacja zamówień lokalnych

Pakiet SDK do domu lokalnego usprawnia integrację inteligentnego domu z Asystentem Google, dodając lokalną ścieżkę realizacji, która kieruje użytkowników do inteligentnych intencji domu.

Pakiet SDK umożliwia pisanie lokalnej aplikacji do realizacji zamówień za pomocą TypeScriptu lub JavaScriptu, która zawiera funkcję inteligentnego domu. Urządzenia Google Home lub Google Nest mogą wczytywać i uruchamiać Twoją aplikację na urządzeniu. Aplikacja komunikuje się bezpośrednio z Twoimi urządzeniami przez Wi-Fi w sieci lokalnej (LAN), aby wykonywać polecenia użytkowników na podstawie istniejących protokołów.

Integracja pakietu SDK zapewnia lepsze działanie inteligentnego domu, takie jak krótsze czasy oczekiwania i większa niezawodność. Lokalna realizacja jest obsługiwana w przypadku wszystkich typów urządzeń i cech ich urządzeń oprócz tych, które korzystają z dodatkowej weryfikacji użytkownika.

Zacznij tworzyć Zobacz przykład

Jak to działa

Gdy otrzymasz odpowiedź SYNC z Twojej realizacji w chmurze, lokalna platforma lokalna skanuje sieć lokalną użytkownika za pomocą mDNS, transmisji UDP lub UPnP, aby znaleźć inteligentne urządzenia połączone z Asystentem.

Platforma wysyła intencję IDENTIFY, aby określić, czy można sterować lokalnie urządzeniem, porównując identyfikator urządzenia w odpowiedzi IDENTIFY z odpowiedziami zwróconymi przez wcześniejszą odpowiedź SYNC. Jeśli wykryte urządzenie to centrala lub most, platforma wysyła intencję REACHABLE_DEVICES i traktuje centrum jako urządzenie pośredniczące w celu komunikacji lokalnej.

Po otrzymaniu odpowiedzi potwierdzającej urządzenie lokalne platforma określa lokalną ścieżkę realizacji na urządzeniu Google Home lub Google Nest użytkownika, a następnie przekierowuje polecenia użytkownika do realizacji lokalnego zamówienia.

Gdy użytkownik wywoła działanie inteligentnego domu, które ma lokalną ścieżkę realizacji, Asystent wyśle intencję EXECUTE lub intencję QUERY do urządzenia Google Home lub Google Nest, a nie do realizacji w chmurze. Następnie urządzenie uruchomi aplikację służącą do realizacji zamówień, aby zrealizować jej cel.

Ilustracja przedstawiająca proces wykonania lokalnej realizacji zamówień. Ścieżka wykonania rejestruje intencję użytkownika z telefonu z Asystentem Google, a następnie przetwarza intencję użytkownika przez Google Cloud, a następnie jest uruchamiana lokalnie na urządzeniu Google Home i polecana jest bezpośrednio w centrum lub bezpośrednio na urządzeniu. Chmura dla deweloperów jest dostępna jako chmura zastępcza.
Ilustracja 1. Dodawanie lokalnej ścieżki do realizacji w ramach działania inteligentnego domu.

Platforma lokalna nie określa jednoznacznie, które urządzenie Google Home czy Google Nest ma wywołać polecenie. Intencje EXECUTE i QUERY mogą pochodzić z dowolnego urządzenia Google Home lub Google Nest zdefiniowanego w tej samej strukturze Home Graph co urządzenie docelowe.

Lokalna aplikacja do realizacji zamówień

Aplikacja służąca do realizacji zamówień zawiera logikę biznesową, przetwarzającą intencje przesyłane z platformy lokalnej i uzyskując dostęp do urządzenia za pomocą sieci lokalnej. Nie oczekuje się modyfikacji sprzętu w ramach lokalnej realizacji zamówień. Aplikacja realizuje żądania inteligentnego działania, wysyłając polecenia sterowania do inteligentnego urządzenia za pomocą protokołów warstwy aplikacji, takich jak HTTP, TCP lub UDP. Jeśli lokalna ścieżka realizacji zakończy się niepowodzeniem, używana będzie Twoja realizacja w chmurze jako zastępcza ścieżka wykonania.

Pakiet SDK Google Home obsługuje 2 główne klasy:

  • DeviceManager: udostępnia metody komunikacji z urządzeniami za pomocą TCP, gniazd UDP lub żądań HTTP.
  • App: udostępnia metody dołączania modułów obsługi intencji, które Google wysyła po wykryciu urządzeń możliwych do sterowania lokalnie (IDENTIFY, REACHABLE_DEVICES). Ta klasa wykonuje też polecenia użytkownika (EXECUTE) i odpowiada na zapytania użytkowników dotyczące bieżącego stanu urządzenia (QUERY).

Podczas programowania możesz skompilować i przetestować aplikację, wczytując ją na własnym serwerze hostingowym lub na lokalnym komputerze. W wersji produkcyjnej Google hostuje Twoją aplikację w bezpiecznym środowisku piaskownicy JavaScriptu na urządzeniu Google Home lub Google Nest użytkownika.

Interfejs Report State nie jest obecnie obsługiwany w przypadku lokalnej realizacji zamówień. Google przetwarza te żądania zgodnie z Twoją realizacją w chmurze.

Cykl życia aplikacji

Twoja aplikacja służąca do realizacji zamówień jest wczytywana na żądanie, gdy platforma lokalna wykryje nowe urządzenia lokalne pasujące do konfiguracji skanowania projektu lub czeka na dostarczenie treści powiązanych z wcześniej zidentyfikowanym urządzeniem.

Urządzenia Google Home lub Google Nest mają ograniczoną pamięć, a lokalna aplikacja realizacji zamówień może zostać w dowolnym momencie zamknięta z powodu wykorzystania pamięci systemu. Może się tak zdarzyć, jeśli aplikacja zaczyna zużywać zbyt dużo pamięci albo system potrzebuje miejsca na inną aplikację. Platforma lokalna ponownie uruchamia aplikację tylko wtedy, gdy ma ona nowe zamiary, a jednocześnie wystarczy jej zasobów pamięci do uruchomienia.

Gdy lokalny użytkownik odłączy swoje konto lub gdy przestaną być na nim obsługiwane urządzenia obsługujące stronę lokalną i powiązane z agentUserId, platforma lokalna wyładuje aplikację po upływie limitu czasu bezczynności.

Obsługiwane urządzenia

Platforma lokalna wykonuje lokalną aplikację do realizacji zamówień na obsługiwanych urządzeniach Google Home lub Google Nest. W tabeli poniżej znajdziesz listę obsługiwanych urządzeń oraz informacje o czasie działania na poszczególnych urządzeniach. Więcej informacji o wymaganiach dotyczących środowiska wykonawczego znajdziesz w artykule o środowisku wykonawczym.

Urządzenie Typ Środowisko
Google Home Prelegent Chrome
Google Home Mini Prelegent Chrome
Google Home Max Prelegent Chrome
Nest Mini, Prelegent Chrome
Nest Hub Sieć reklamowa Chrome
Nest Hub Max Sieć reklamowa Chrome
Nest Wifi Router Node.js
Punkt Chrome

Środowisko wykonywania

Środowisko wykonawcze lokalnej aplikacji do realizacji zamówień zależy od urządzenia. Platforma lokalna obsługuje następujące środowiska wykonawcze:

  • Chrome: lokalna aplikacja do realizacji zamówień jest uruchamiana w kontekście przeglądarki Chrome window z zainstalowanym systemem Chrome M80 lub nowszym z obsługą wersji ECMAScript ES2018.
  • Node.js: lokalna aplikacja do realizacji zamówień jest uruchamiana jako skrypt w ramach procesu Node.js korzystającego z węzła v10.x LTS lub nowszego z obsługą wersji ECMAScript ES2018.

Struktura kodu źródłowego

Zalecamy połączenie zależności w jeden plik JavaScript za pomocą konfiguracji pakietów dostępnych w lokalnym pakiecie SDK pakietu Home i spakowanie kodu źródłowego w postaci wywołania funkcji błyskawicznych (IIFE).

Ścieżka implementacji

Aby używać inteligentnego pakietu SDK do domu domowego w ramach integracji inteligentnego domu, musisz wykonać te czynności:

1 Skonfiguruj konfigurację skanowania Skonfiguruj w Konsoli Actions niezbędne parametry, które umożliwi Asystentowi wykrywanie urządzeń sterowanych lokalnie.
2 Zaktualizuj odpowiedź SYNC w realizacji w chmurze W realizacji w chmurze zmień moduł obsługi żądania SYNC, aby obsługiwał pole otherDeviceIds używane przez platformę do utworzenia lokalnej ścieżki realizacji. W tym polu określ identyfikatory urządzeń, które można kontrolować lokalnie.
3 Implementowanie lokalnej aplikacji do realizacji zamówień Za pomocą pakietu SDK Home Home utwórz aplikację JavaScript do obsługi intencji IDENTIFY, EXECUTE i QUERY. W przypadku urządzeń pośredniczących lub mostowych serwerów proxy musisz też obsłużyć intencję REACHABLE_DEVICES.
4 Testowanie i debugowanie aplikacji Sprawdź integrację (lub samodzielną certyfikację) za pomocą Google Home Test Suite.

Zanim zaczniesz

Dalej
Obsługa wykrywania urządzeń