Autoriser les interactions entre les utilisateurs et les appareils situés à proximité

Avec les API Nearby, vos utilisateurs peuvent travailler et jouer plus facilement ensemble lorsqu'ils sont proches les uns des autres (environ 30 mètres de distance). Configurez facilement des jeux multijoueurs, des groupes ad hoc, des sessions de partage et de collaboration, etc.

Pourquoi ça fonctionne

Les capacités uniques de localisation et d'interopérabilité multiplate-forme de la fonctionnalité À proximité vous permettent de concevoir des expériences qui paraîtront tout simplement magiques lorsque les utilisateurs se trouvent à proximité les uns des autres. Les fonctionnalités reposant sur la technologie À proximité vous permettront ainsi de fidéliser vos utilisateurs et leur donneront envie de recommander votre application.

Principales fonctionnalités

  • API Messaging : envoyez et recevez des messages pour permettre aux utilisateurs d'interagir et de collaborer de manière extensive, par exemple avec des jeux multijoueurs, la collaboration en temps réel, la création d'un groupe, la diffusion d'une ressource ou le partage de contenu.
  • API Nearby Connections : découvrez d'autres appareils sur le même réseau local et créez des connexions pour offrir des expériences impliquant plusieurs appareils en temps réel. Un appareil joue le rôle de l'hôte, et les appareils à proximité peuvent demander une connexion pour partager des tableaux collaboratifs, jouer à des jeux multijoueurs locaux ou à des jeux multi-écrans.
  • Notifications de proximité : recevez des messages émis par des balises Eddystone et ajoutez des informations basées sur la zone géographique à vos applications et vos jeux. Les messages peuvent contenir un lien vers une URL HTTPS : lorsque l'utilisateur appuie sur la notification, l'URL s'ouvre dans le navigateur. Autrement, les messages peuvent déclencher un intent pour lancer une application et effectuer une action spécifique, ou rediriger l'utilisateur vers le Play Store s'il n'a pas encore installé l'application.

Bonnes pratiques

  • Utilisez les fonctionnalités À proximité avec parcimonie et seulement lorsqu'elles sont nécessaires, afin d'économiser la batterie. En effet, les API Nearby font un usage intensif du signal radio et des capteurs, ce qui contribue à décharger la batterie jusqu'à 3,5 fois plus vite qu'en temps normal.
  • Utilisez une commande explicite pour lancer À proximité : un bouton, un bouton ON/OFF ou un écran spécial. Fournissez à l'utilisateur une indication visuelle, une animation par exemple, qui lui permettra de voir si la fonctionnalité À proximité est en train de transmettre ou de recevoir des données. Utilisez le logo À proximité que vous trouverez à l'adresse developers.google.com/nearby.
  • Veillez à ce que l'utilisateur comprenne quelles données sont dévoilées aux autres utilisateurs situés à proximité avant d'utiliser les fonctionnalités À proximité de votre application.
  • Cessez toutes les opérations de publication ou d'abonnement en cours si l'application ne nécessite plus la fonctionnalité À proximité, ou si l'utilisateur quitte l'application. Envoyez pour cela des requêtes unpublish() et unsubscribe() dans la méthode onStop().
  • Pour limiter la portée des fonctionnalités À proximité, utilisez uniquement le modem à ultrasons en indiquant Strategy.setDistanceType(DISTANCE_TYPE_EARSHOT). Cette action permet de limiter la portée à environ deux mètres, de sorte que seuls les appareils situés dans une même pièce puissent "voir" l'initiateur de la transmission.
  • Accélérez l'échange de données si un côté ne permet que la publication et l'autre ne permet que l'abonnement. Pour cela, utilisez Strategy.setDiscoveryMode(DISCOVERY_MODE_BROADCAST) du côté de la publication et DISCOVERY_MODE_SCAN pour l'abonnement. La publication et l'abonnement sont des composantes indépendantes du mode de recherche (l'éditeur peut rechercher et l'abonné peut publier, ou vice-versa).

Exemples

Premiers pas

À proximité