L'API Nearby Messages è un'API di pubblicazione-sottoscrizione che consente di trasferire piccoli payload binari tra dispositivi Android e iOS connessi a internet. I dispositivi non devono essere sulla stessa rete, ma devono essere connessi a internet.
Nearby utilizza Bluetooth Low Energy per comunicare un codice di accoppiamento univoco nel tempo tra i dispositivi. Il server facilita lo scambio di messaggi tra i 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 Nearby Messages per la convalida e per verificare se ci sono messaggi da recapitare per l'insieme corrente di sottoscrizioni dell'applicazione.
Nearby Messages non è autenticato e non richiede un Account Google.
Il meccanismo esatto per lo scambio di dati può variare da release a release. 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 nel tempo (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 utilizza anche Bluetooth Low Energy per cercare i token di altri dispositivi.
Un'app di sottoscrizione associa la sottoscrizione a un token e utilizza Bluetooth Low Energy per inviare il token all'editore e per rilevare il token dell'editore.
Quando una delle due parti rileva il token dell'altra, 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 chiamanti sono associate allo stesso progetto nella console Google Developers.
Quando utilizzi l'SDK Nearby di Google Play Services, vengono raccolte analisi sull'utilizzo per migliorare l'esperienza.
- Metriche delle prestazioni: quando utilizzi l'SDK Nearby, vengono raccolte la durata delle pubblicazioni e delle sottoscrizioni e il numero di messaggi ricevuti.
- Informazioni sul dispositivo: vengono raccolti e associati alle metriche delle prestazioni il modello del dispositivo, il paese, la versione della build e il nome del pacchetto dell'applicazione per identificare le suddivisioni regionali e specifiche del dispositivo.
- Pubblicazioni di Nearby Messages: i dati pubblicati tramite Nearby Messages 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 andando su Impostazioni > Google > Utilizzo e diagnostica.