Panoramica

L'API Nearby Messages è un'API di pubblicazione/sottoscrizione che ti consente di trasmettere 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.

Nelle vicinanze utilizza il 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 altro dispositivo nelle vicinanze, lo invia al server di Messaggi nelle vicinanze per la convalida e per verificare se ci sono messaggi da inviare per l'attuale insieme di iscrizioni dell'applicazione.

Messaggi nelle vicinanze non è autenticato e non richiede un Account Google.

Il meccanismo esatto per lo scambio di dati può variare da una versione all'altra. La seguente sequenza mostra gli eventi che portano allo scambio di messaggi:

  1. Un'app di pubblicazione invia una richiesta per associare un payload binario (il messaggio) con un codice di accoppiamento univoco nel tempo (token). Il server effettua un'associazione temporanea tra il payload del messaggio e il token.

  2. Il dispositivo di pubblicazione utilizza il Bluetooth Low Energy per rendere il token rilevabile dai dispositivi nelle vicinanze. Il dispositivo di pubblicazione utilizza anche il Bluetooth Low Energy per cercare i token di altri dispositivi.

  3. Un'app che si iscrive associa il proprio abbonamento a un token e utilizza Bluetooth Low Energy per inviare il token all'editore e rilevare il token dell'editore.

  4. Quando una delle due parti rileva il token dell'altra, lo segnala al server.

  5. 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 in Google Developers Console.

Quando utilizzi l'SDK Nearby di Google Play Services, vengono raccolti dati e analisi sull'utilizzo per migliorare l'esperienza.

  • Metriche sul rendimento: la durata delle pubblicazioni e delle iscrizioni e il numero di messaggi ricevuti vengono raccolti quando si utilizza l'SDK Nearby.
  • Informazioni sul dispositivo: il modello di dispositivo, il paese, la versione build e il nome del pacchetto dell'applicazione vengono raccolti e associati alle metriche sul rendimento per identificare segmenti regionali e specifici per dispositivo.
  • Nearby Messages pubblica: i dati pubblicati tramite Nearby Messages vengono memorizzati da Google finché il messaggio non viene più pubblicato. Questi dati vengono condivisi con gli abbonati nelle vicinanze del dispositivo.

Gli utenti finali possono consentire o negare questa raccolta andando a Impostazioni > Google > Utilizzo e diagnostica.