Przegląd

Interfejs Nearby Messages API to interfejs API typu publikowanie-subskrypcja, który umożliwia przesyłanie niewielkich ładunków binarnych między urządzeniami z Androidem i urządzeniami z iOS połączonymi z internetem. Urządzenia nie muszą być w tej samej sieci, ale muszą być połączone z internetem.

Funkcja W pobliżu używa technologii Bluetooth Low Energy do przesyłania między urządzeniami unikalnego kodu parowania. Serwer ułatwia wymianę wiadomości między urządzeniami, które wykrywają ten sam kod parowania. Gdy urządzenie wykryje kod parowania z urządzenia w pobliżu, wysyła go do serwera Wiadomości w pobliżu w celu weryfikacji i sprawdzenia, czy są jakieś wiadomości do dostarczenia dla bieżącego zestawu subskrypcji aplikacji.

Wiadomości w pobliżu nie wymagają uwierzytelniania ani konta Google.

Dokładny mechanizm wymiany danych może się różnić w zależności od wersji. Poniższa sekwencja pokazuje zdarzenia prowadzące do wymiany wiadomości:

  1. Aplikacja publikująca wysyła żądanie powiązania ładunku binarnego (wiadomości) z unikalnym w czasie kodem parowania (tokenem). Serwer tworzy tymczasowe powiązanie między ładunkiem wiadomości a tokenem.

  2. Urządzenie publikujące używa Bluetooth Low Energy, aby token był wykrywalny przez urządzenia w pobliżu. Urządzenie publikujące również używa Bluetooth Low Energy do skanowania w poszukiwaniu tokenów z innych urządzeń.

  3. Aplikacja subskrybująca wiąże swoją subskrypcję z tokenem i używa technologii Bluetooth Low Energy, aby wysłać swój token do wydawcy i wykryć token wydawcy.

  4. Gdy jedna ze stron wykryje token drugiej, zgłasza to serwerowi.

  5. Serwer ułatwia wymianę wiadomości między 2 urządzeniami, gdy oba są powiązane ze wspólnym tokenem, a klucze interfejsu API używane przez aplikacje do dzwonienia są powiązane z tym samym projektem w Google Developers Console.

Gdy korzystasz z pakietu SDK usług Google Play dla urządzeń w pobliżu, zbierane są statystyki użytkowania, aby ulepszać działanie usługi.

  • Wskaźniki skuteczności: podczas korzystania z pakietu SDK Nearby zbierane są informacje o czasie trwania publikacji i subskrypcji oraz o liczbie otrzymanych wiadomości.
  • Informacje o urządzeniu: model urządzenia, kraj, wersja kompilacji i nazwa pakietu aplikacji są zbierane i powiązane ze wskaźnikami wydajności, aby można było identyfikować fragmenty danych dotyczące regionu i urządzenia.
  • Publikowanie wiadomości w pobliżu: dane publikowane za pomocą Wiadomości w pobliżu są przechowywane przez Google do momentu, gdy wiadomość przestanie być publikowana. Te dane są udostępniane subskrybentom, którzy znajdują się w pobliżu urządzenia.

Użytkownicy mogą zezwolić na zbieranie tych danych lub je zablokować, wybierając kolejno Ustawienia > Google > Użytkowanie i diagnostyka.