Richtlinien für Entwickler

Die folgenden Richtlinien helfen dir, hochwertige Anwendungen mit der Nearby Messages API und der Nearby Connections API zu erstellen.

Datenschutz respektieren

  • Erkläre dem Nutzer, welche Daten deine App Nutzern in der Nähe zugänglich macht.

  • Veröffentlichen Sie keine vertraulichen Informationen wie Passwörter und Kreditkartennummern. Geben Sie stattdessen Autorisierungstokens oder Transaktions-IDs an.

Zum Starten von Nearby eine explizite, vom Nutzer initiierte Aktion verlangen

  • Überraschen Sie den Nutzer nicht. Erzwingen, dass der Nutzer eine explizite Aktion ausführt (z. B. das Tippen auf eine Schaltfläche, das Aufrufen eines Bereichs in Ihrer App oder einen speziellen Schalter), um Nearby zu aktivieren

  • Auf iOS- und Android-Geräten wird beim ersten Aufrufen von Nearby ein Berechtigungsdialogfeld von Nearby ausgelöst. Das Warten auf eine explizite Nutzeraktion vor dem Aufrufen von Nearby hilft dem Nutzer, das Dialogfeld zu kontextbezogenen und mit der umgebungsbasierten Funktion Ihrer App zu verknüpfen.

Achte auf den Akkuverbrauch

Die Nutzung von Funkschnittstellen und Sensoren in der Nähe belastet den Akku deiner App mit dem 2,5- bis 3,5-Fachen der normalen Geschwindigkeit. Beachten Sie die folgenden Empfehlungen, um den Akku zu schonen.

  • Auf Android-Geräten solltest du beim Veröffentlichen oder Abonnieren mit Nicht-BLE-Geräten die Nearby Messages API nur über eine Aktivität aufrufen und diese Aktivität nur dann ausführen, wenn der Bildschirm eingeschaltet ist und deine App im Vordergrund ausgeführt wird. Übergeben Sie dazu die Aktivität als Argument an den Parameter Context von Nearby.getMessagesClient(). Der Aufruf von Nearby über einen Service wird nur beim Abonnieren von BLE-Nachrichten (Bluetooth Low Energy) unterstützt.

  • Auf Android-Geräten kannst du im Activity.onStop()-Callback deiner App Nearby.getMessagesClient(Activity).unpublish() und Nearby.getMessagesClient(Activity).unsubscribe() für alle aktiven Veröffentlichungen oder Abos aufrufen. Unter iOS ist keine Aktion erforderlich, da dies automatisch erledigt wird.

  • Mach es dem Nutzer leicht, aktive Veröffentlichungen und Abos zu beenden.

  • Veröffentlichen und abonnieren Sie die App nicht ohne Wissen des Nutzers.

Das richtige Branding verwenden

  • Wir haben eine Reihe von Standard-Assets bereitgestellt, mit denen du Nearby in deiner App darstellen kannst. Verwende nur die folgenden genehmigten Symbole, wenn du auf Nearby verweist.

  • PNG-Assets

  • SVG-Assets