Aperçu

L'API Nearby Messages est une API de publication/abonnement qui vous permet de transmettre de petites charges utiles binaires entre des appareils Android et iOS connectés à Internet. Les appareils ne doivent pas nécessairement être sur le même réseau, mais ils doivent être connectés à Internet.

Nearby utilise le Bluetooth à basse consommation pour communiquer un code d'association unique dans le temps entre les appareils. Le serveur facilite l'échange de messages entre les appareils qui détectent le même code d'association. Lorsqu'un appareil détecte un code d'association à partir d'un appareil à proximité, il l'envoie au serveur Nearby Messages pour validation et pour vérifier s'il existe des messages à envoyer pour l'ensemble actuel d'abonnements de l'application.

Les messages à proximité ne sont pas authentifiés et ne nécessitent pas de compte Google.

Le mécanisme exact d'échange de données peut varier d'une version à l'autre. La séquence suivante montre les événements qui mènent à l'échange de messages:

  1. Une application de publication envoie une requête pour associer une charge utile binaire (le message) à un code d'association unique dans le temps (jeton). Le serveur établit une association temporaire entre la charge utile du message et le jeton.

  2. L'appareil émetteur utilise le Bluetooth à basse consommation pour rendre le jeton détectable par les appareils à proximité. L'appareil de publication utilise également le Bluetooth basse consommation pour rechercher des jetons provenant d'autres appareils.

  3. Une application d'abonnement associe son abonnement à un jeton et utilise le Bluetooth à basse consommation pour envoyer son jeton à l'éditeur et pour détecter le jeton de l'éditeur.

  4. Lorsqu'une des parties détecte le jeton de l'autre, elle le signale au serveur.

  5. Le serveur facilite l'échange de messages entre deux appareils lorsqu'ils sont tous deux associés à un jeton commun et que les clés API utilisées par les applications appelantes sont associées au même projet dans la console pour les développeurs Google.

Lorsque vous utilisez le SDK Nearby des services Google Play, des données analytiques sur l'utilisation sont collectées pour améliorer l'expérience.

  • Métriques de performances:la durée des publications et des abonnements, ainsi que le nombre de messages reçus sont collectés lorsque vous utilisez le SDK Nearby.
  • Informations sur l'appareil:le modèle de l'appareil, le pays, la version du build et le nom du package de l'application sont collectés et associés aux métriques de performances pour identifier les segments régionaux et spécifiques à l'appareil.
  • Nearby Messages publie les éléments suivants:les données publiées via Nearby Messages sont stockées par Google jusqu'à ce que le message ne soit plus publié. Ces données sont partagées avec les abonnés à proximité de l'appareil.

Les utilisateurs finaux peuvent autoriser ou refuser cette collecte en accédant à Paramètres > Google > Utilisation et diagnostics.