L'API Nearby Messages è un'API di pubblicazione-sottoscrizione che ti consente di passare piccoli payload binari tra dispositivi Android e iOS connessi a internet. I dispositivi non devono necessariamente essere sulla stessa rete, ma devono essere connessi a Internet.
La funzionalità Nearby utilizza Bluetooth Low Energy per comunicare un codice di accoppiamento univoco tra i dispositivi. Il server facilita lo scambio di messaggi tra dispositivi che rilevano lo stesso codice di accoppiamento. Quando un dispositivo rileva un codice di accoppiamento da un dispositivo nelle vicinanze, lo invia al server di Nearby Messages per la convalida e per controllare se ci sono messaggi da consegnare per l'insieme di abbonamenti corrente dell'applicazione.
La funzionalità Nearby Messages non è autenticata e non richiede un Account Google.
Il meccanismo esatto per lo scambio di dati può variare da una release all'altra. La seguente sequenza mostra gli eventi che portano allo scambio di messaggi:
Un'app di pubblicazione invia una richiesta per associare un payload binario (il messaggio) a un codice di accoppiamento univoco (token). Il server crea un'associazione temporanea tra il payload del messaggio e il token.
Il dispositivo di pubblicazione utilizza Bluetooth Low Energy per rendere il token rilevabile dai dispositivi nelle vicinanze. Il dispositivo di pubblicazione usa inoltre Bluetooth Low Energy per cercare i token di altri dispositivi.
Un'app in abbonamento associa il proprio abbonamento a un token e utilizza Bluetooth Low Energy per inviare il proprio token all'editore e rilevare il token dell'editore.
Quando una delle parti rileva il token dell'altro, lo segnala al server.
Il server facilita lo scambio di messaggi tra due dispositivi quando entrambi sono associati a un token comune, e le chiavi API utilizzate dalle app di chiamata sono associate allo stesso progetto in Google Developers Console.
Quando utilizzi l'SDK nelle vicinanze di Google Play Services, vengono raccolte analisi sull'utilizzo per migliorare l'esperienza.
- Metriche sul rendimento:quando si utilizza l'SDK Nearby vengono raccolti la durata di pubblicazioni e iscrizioni e il numero di messaggi ricevuti.
- Informazioni del dispositivo: il modello del dispositivo, il paese, la versione della build e il nome del pacchetto dell'applicazione vengono raccolti e associati alle metriche delle prestazioni per identificare sezioni specifiche per regione e dispositivo.
- Pubblicazione di Messaggi nelle vicinanze:i dati pubblicati tramite Messaggi nelle vicinanze vengono archiviati da Google finché il messaggio non viene più pubblicato. Questi dati vengono condivisi con gli abbonati che si trovano nelle vicinanze del dispositivo.
Gli utenti finali possono consentire o negare questa raccolta da Impostazioni > Google > Utilizzo e diagnostica.