Vue d'ensemble

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

Nearby utilise le Bluetooth à basse consommation pour communiquer un code d'association unique en temps réel 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 le valider et vérifier s'il y a des messages à distribuer pour l'ensemble d'abonnements actuel de l'application.

Nearby Messages n'est pas authentifié et ne nécessite 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 conduisent à 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 crée une association temporaire entre la charge utile du message et le jeton.

  2. L'appareil de publication 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 les jetons d'autres appareils.

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

  4. Lorsque l'un des côtés détecte le jeton de l'autre, il 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 Google Play Console.

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

  • Métriques de performances:la durée des publications et des abonnements et 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 de compilation et le nom du package de l'application sont collectés et associés aux métriques de performances afin d'identifier les tranches régionales et spécifiques à l'appareil.
  • Publication de Nearby Messages: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 qui se trouvent à proximité de l'appareil.

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