Consignes destinées aux développeurs

Les consignes suivantes vous aideront à créer des applications de haute qualité avec l'API Nearby Messages et l'API Nearby Connections.

Respecter la confidentialité des utilisateurs

  • Aidez l'utilisateur à comprendre quelles données votre application sera exposée aux utilisateurs à proximité.

  • Ne publiez pas d'informations sensibles telles que des mots de passe et des numéros de carte de crédit. Transmettez plutôt des jetons d'autorisation ou des identifiants de transaction.

Exiger une action explicite de l'utilisateur pour lancer Nearby

  • Ne surprenez pas l'utilisateur. Exigez que l'utilisateur effectue une action explicite (un appui sur un bouton, une section dans votre application, un contacteur spécial, etc.) pour activer la fonctionnalité À proximité.

  • Sur iOS et Android, lorsque vous appelez Nearby pour la première fois, une boîte de dialogue d'autorisation s'ouvre. En attendant une action explicite de l'utilisateur avant d'invoquer Nearby, l'utilisateur contextualise la boîte de dialogue et l'associe à la fonctionnalité de proximité de votre application.

Faites attention à la consommation de la batterie

En utilisant des signaux radio et des capteurs à proximité, votre appli consomme de la batterie à 2,5-3,5 fois la fréquence normale. Pour réduire l'utilisation de la batterie, suivez les recommandations suivantes.

  • Sur Android, lors de la publication ou de l'abonnement d'appareils non BLE, n'appelez l'API Nearby Messages qu'à partir d'une activité et assurez-vous que cette activité reste en cours d'exécution lorsque l'écran est allumé et que votre application est exécutée au premier plan. Pour ce faire, transmettez l'activité en tant qu'argument au paramètre Context de Nearby.getMessagesClient(). L'appel de la fonctionnalité À proximité depuis un service n'est possible que si vous êtes abonné aux messages de la balise Bluetooth à basse consommation (BLE).

  • Sur Android, dans le rappel Activity.onStop() de votre application, appelez Nearby.getMessagesClient(Activity).unpublish() et Nearby.getMessagesClient(Activity).unsubscribe() sur toutes les publications ou tous les abonnements actifs. Sur iOS, aucune action n'est requise, car l'opération est gérée automatiquement.

  • Permettez à l'utilisateur d'arrêter facilement les publications et abonnements actifs.

  • N'effectuez pas de publication ni d'abonnement en arrière-plan à l'insu de l'utilisateur.

Utilisez le branding adéquat

  • Nous avons fourni un ensemble d'assets standards que vous pouvez utiliser pour représenter Nearby dans votre application. N'utilisez que les icônes approuvées suivantes lorsque vous faites référence à Nearby.

  • Éléments PNG

  • Assets SVG