Obsługa wykrywania urządzeń

Lokalna ścieżka realizacji jest tworzona, gdy Google pasuje do urządzenia kontrolowanego lokalnie na urządzenie zwrócone w aplikacji SYNC odpowiedź dzięki realizacji w chmurze.

Aby umożliwić Google wykrycie urządzenia w sieci lokalnej i ustanowienie lokalnej ścieżki realizacji, musisz dodać informacje o odkrywaniu w Konsoli Actions. Musisz też zaktualizować odpowiedź SYNC w swojej usłudze w chmurze, aby umożliwić Google wie o urządzeniu sterowanym lokalnie.

Skonfiguruj informacje o konfiguracji skanowania

Aby określić informacje o wykrywaniu, wykonaj te czynności:

  1. Otwórz projekt inteligentnego domu w Konsoli Actions.
  2. W panelu nawigacyjnym po lewej stronie kliknij Działania.
  3. W sekcji Skonfiguruj lokalny domowy pakiet SDK (opcjonalnie) > Dodaj konfigurację skanowania urządzenia, kliknij Nowa konfiguracja skanowania.
  4. Wybierz z menu typ protokołu skanowania i wpisz wartości Google do przeskanowania.

W tabelach poniżej znajdziesz atrybuty, które możesz dodać na podstawie protokołów ma służyć Google do skanowania w poszukiwaniu Twojego urządzenia:

mDNS
Atrybut Opis Przykładowa wartość
Nazwa usługi Wymagane. Nazwa usługi opublikowana przez urządzenie w formacie service.domain _http._tcp.local
Nazwa

Wymagane. Odfiltruj unikalną instancję usługi w format: instance.service.domain.

Platforma traktuje tę wartość jako wyrażenie regularne i zwraca dowolne pasujących urządzeń. 		my-device-[0-9]{4}\._http\._tcp\.local
.
UPnP
Atrybut Opis Przykładowa wartość
Typ usługi Wymagane. Pełny identyfikator usługi UPnP w formacie domain:service:type:version schemas-upnp-org:service:SwitchPower:1
identyfikator OUI

Opcjonalnie: Unikalny identyfikator organizacji.

24-bitowa wartość identyfikująca producenta urządzenia. Zazwyczaj są to trzy pierwsze oktety adresu MAC urządzenia. 		1A:2B:3C
.
UDP
Atrybut Opis Przykładowa wartość
Adres rozgłoszeniowy Wymagane. Docelowy adres IP dla transmisji UDP. 255.255.255.255
Port transmisji Wymagane. Port docelowy dla transmisji UDP. 5555
Port nasłuchiwania Wymagane. Port nasłuchujący odpowiedzi wykrywania UDP. 5556
Pakiet wykrywania

Wymagane. Ładunek do wysłania w transmisji UDP.

Sformatowana jako zakodowany szesnastkowo ciąg bajtów. 		48454C4C4F

Aktualizacja odpowiedzi SYNC w ramach realizacji w chmurze

Zamiar SYNC przekazuje Asystent, którymi urządzeniami steruje użytkownik i jakie ma możliwości.

W celu obsługi lokalnej realizacji zamówień platforma lokalnej strony głównej sprawdza odpowiedź SYNC za pomocą realizacji w chmurze Twojego inteligentnego domu i próbuje dopasować urządzenie identyfikatory w polu otherDeviceIds na identyfikator weryfikacji zwrócony przez funkcję Moduł obsługi IDENTIFY. Wpisy urządzeń bez pola otherDeviceIds są wykluczone z lokalnej realizacji.

W otherDeviceIds w odpowiedzi SYNC, musisz ustawić identyfikatory urządzeń inteligentnego domu urządzeniami, którymi można sterować lokalnie. Pole pojawia się na poziomie: device w odpowiedzi. Google może utworzyć lokalną ścieżkę realizacji zamówienia na dowolnym urządzeniu o podanym identyfikatorze.

W polu customData możesz określić dodatkowe dane, których Google potrzebuje podłącz do samodzielnego urządzenia lub kieruj reklamy na urządzenia końcowe za pomocą koncentratora (na przykład numer portu i inne informacje zależne od protokołu).

Przykład

Z tego fragmentu kodu dowiesz się, jak możesz utworzyć moduł obsługi SYNC.

Osobno/centrala
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [{
      "id": "123",
      "type": "action.devices.types.OUTLET",
      "traits": [
        "action.devices.traits.OnOff"
      ],
      "name": {
        "name": "Night light"
      },
      "willReportState": false,
      "otherDeviceIds": [{
        "deviceId": "local-device-id"
      }],
      "customData": {
        "port": 5555,
        "authToken": "..."
      }
    }]
  }
}
Wstecz
Przegląd
Dalej
Wdrażanie lokalnej aplikacji do realizacji zamówień