Interfejs Nearby Messages API to interfejs typu publikowanie-subskrypcja, który umożliwia przesyłanie małych binarnych danych 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.
Udostępnianie w pobliżu korzysta z Bluetooth Low Energy do przesyłania 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 położonego w pobliżu urządzenia, wysyła go do serwera Nearby Messages w celu weryfikacji i sprawdzenia, czy są jakieś wiadomości do dostarczenia w przypadku 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 przedstawia zdarzenia prowadzące do wymiany wiadomości:
Aplikacja do publikowania wysyła żądanie o powiązanie binarnego ładunku (wiadomości) z unikatowym 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 umożliwić wykrycie tokena przez urządzenia w pobliżu. Urządzenie publikujące korzysta też z Bluetooth Low Energy, aby skanować tokeny z innych urządzeń.
Aplikacja subskrybowana łączy subskrypcję z tokenem i korzysta z Bluetooth Low Energy, aby wysłać token do wydawcy i wykryć jego token.
Gdy jedna ze stron wykryje token drugiej strony, przekazuje tę informację na serwer.
Serwer ułatwia wymianę wiadomości między 2 urządzeniami, gdy oba są powiązane z wspólnym tokenem, a klucze interfejsu API używane przez aplikacje wywołujące są powiązane z tym samym projektem w Konsoli programistów Google.
Gdy używasz pakietu SDK Usługi Google Play w pobliżu, gromadzone są statystyki dotyczące korzystania z tej usługi, aby zapewnić lepsze wrażenia.
- Dane o skuteczności: podczas korzystania z pakietu SDK Nearby są zbierane dane 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 z danymi o wydajności, aby umożliwić identyfikację przekrojów regionalnych i urządzeniowych.
- Wymiana wiadomości z urządzeniami w pobliżu publikuje: dane publikowane za pomocą funkcji Wymiana wiadomości z urządzeniami w pobliżu są przechowywane przez Google do momentu, gdy wiadomość przestanie być publikowana. Te dane są udostępniane subskrybentom znajdującym się w pobliżu urządzenia.
Użytkownicy mogą zezwolić na gromadzenie danych lub zablokować to gromadzenie, klikając Ustawienia > Google > Użytkowanie i diagnostyka.