Aperçu

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 ne doivent pas nécessairement se trouver sur le même réseau, mais ils doivent être connectés à Internet.

La fonctionnalité À proximité 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 des 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 à distribuer pour l'ensemble d'abonnements actuel de l'application.

L'application Nearby Messages n'est pas authentifiée 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 ayant entraîné 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 à temps (jeton). Le serveur établit 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 Low Energy 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 lorsque les deux sont 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 Developers 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, 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 de build 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 propres à l'appareil.
  • Publication dans 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 dans Paramètres > Google > Utilisation et diagnostics.