Nearby Messages API to interfejs API typu publish-subscribe, który umożliwia przesyłanie małych binarnych ładunków między urządzeniami z Androidem i iOS połączonymi z internetem. Urządzenia nie muszą być w tej samej sieci, ale muszą być połączone z internetem.
Nearby używa Bluetooth Low Energy do komunikowania unikalnego kodu parowania między urządzeniami. 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 Nearby Messages w celu weryfikacji i sprawdzenia, czy są jakieś wiadomości do dostarczenia w ramach bieżącego zestawu subskrypcji aplikacji.
Nearby Messages nie wymaga uwierzytelniania ani konta Google.
Dokładny mechanizm wymiany danych może się różnić w zależności od wersji. Poniższa sekwencja przedstawia zdarzenia prowadzące do wymiany wiadomości:
Aplikacja publikująca wysyła żądanie powiązania binarnego ładunku (wiadomości) z unikalnym kodem parowania (tokenem). Serwer tworzy tymczasowe powiązanie między ładunkiem wiadomości a tokenem.
Urządzenie publikujące używa Bluetooth Low Energy, aby token był wykrywalny przez urządzenia w pobliżu. Urządzenie publikujące używa też Bluetooth Low Energy do skanowania tokenów z innych urządzeń.
Aplikacja subskrybująca łączy swoją subskrypcję z tokenem i używa Bluetooth Low Energy, aby wysłać swój token do wydawcy i wykryć jego token.
Gdy jedna ze stron wykryje token drugiej strony, zgłasza to do serwera.
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 wywołujące są powiązane z tym samym projektem w Google Developers Console.
Gdy używasz pakietu SDK usług Google Play W pobliżu, zbieramy dane analityczne dotyczące użytkowania, aby poprawić jakość usług.
- Dane o skuteczności: gdy używasz pakietu Nearby SDK, zbieramy dane o czasie trwania publikacji i subskrypcji oraz o liczbie otrzymanych wiadomości.
- Informacje o urządzeniu: zbieramy informacje o modelu urządzenia, kraju, wersji kompilacji i nazwie pakietu aplikacji oraz łączymy je z danymi o skuteczności, aby identyfikować segmenty regionalne i specyficzne dla urządzenia.
- Publikacje Nearby Messages: dane publikowane za pomocą Nearby Messages są przechowywane przez Google do momentu, aż 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 odmówić, otwierając Ustawienia > Google > Użytkowanie i diagnostyka.