Panoramica

L'API Nearby Messages è un'API publish-subscribe che 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 funzione Qui vicino utilizza la tecnologia 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 associazione da un dispositivo nelle vicinanze, invia il codice di associazione al server Nearby Messaggi per la convalida e per verificare se sono presenti messaggi da recapitare per l'insieme attuale di abbonamenti dell'applicazione.

La funzionalità Messaggi nelle vicinanze 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:

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

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

  3. Un'app in abbonamento associa l'abbonamento a un token e utilizza Bluetooth Low Energy per inviare il token all'editore e rilevare quello dell'editore.

  4. Quando una delle 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 di chiamata sono associate allo stesso progetto in Google Developers Console.

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

  • Metriche sul rendimento:quando utilizzi l'SDK Nearby vengono raccolti la durata di pubblicazioni e sottoscrizioni e il numero di messaggi ricevuti.
  • Informazioni sul dispositivo: vengono raccolti modello del dispositivo, paese, versione della build e nome del pacchetto dell'applicazione, che vengono associati alle metriche sulle 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 fino a quando il messaggio non viene più pubblicato. Questi dati vengono condivisi con gli abbonati che si trovano vicino al dispositivo.

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