Richtlinien für Entwickler

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

Nutzerdaten schützen

  • Erkläre dem Nutzer, welche Daten deine App für Nutzer in der Nähe freigibt.

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

Explizite vom Nutzer initiierte Aktion zum Starten von Nearby erforderlich

  • Nutzer sollen nicht überrascht werden. Der Nutzer muss eine explizite Aktion ausführen (z. B. auf eine Schaltfläche tippen, einen bestimmten Bereich in Ihrer App aufrufen oder einen speziellen Schalter betätigen), um Nearby zu aktivieren.

  • Sowohl unter iOS als auch unter Android wird beim ersten Aufrufen von Nearby ein Berechtigungsdialogfeld von Nearby angezeigt. Wenn Sie warten, bis der Nutzer eine explizite Aktion ausführt, bevor Sie Nearby aufrufen, kann er den Dialog besser einordnen und mit der auf Nähe basierenden Funktion Ihrer App in Verbindung bringen.

Akkunutzung berücksichtigen

Durch die Verwendung von Funkmodulen und Sensoren durch Nearby verbraucht Ihre App 2,5- bis 3,5-mal so viel Akku wie normal. Beachten Sie die folgenden Empfehlungen, um den Akkuverbrauch zu reduzieren.

  • Wenn Sie auf Android-Geräten mit Nicht-BLE-Geräten veröffentlichen oder abonnieren, rufen Sie die Nearby Messages API nur über eine Aktivität auf und lassen Sie diese Aktivität nur laufen, wenn der Bildschirm eingeschaltet ist und Ihre App im Vordergrund ausgeführt wird. Übergeben Sie dazu die Aktivität als Argument an den Parameter Context von Nearby.getMessagesClient(). Das Aufrufen von Nearby über einen Dienst wird nur unterstützt, wenn Sie BLE-Beacon-Nachrichten abonnieren.

  • Rufen Sie unter Android im Activity.onStop()-Callback Ihrer App Nearby.getMessagesClient(Activity).unpublish() und Nearby.getMessagesClient(Activity).unsubscribe() für alle aktiven Veröffentlichungen oder Abonnements auf. Unter iOS ist keine Aktion erforderlich, da dies automatisch erfolgt.

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

  • Es ist untersagt, im Hintergrund Inhalte zu veröffentlichen oder Abos abzuschließen, ohne dass der Nutzer davon weiß.

Verwenden Sie das richtige Branding.

  • Wir haben eine Reihe von Standard-Assets bereitgestellt, die Sie verwenden können, um Nearby in Ihrer App darzustellen. Verwenden Sie nur die folgenden genehmigten Symbole, wenn Sie sich auf Nearby beziehen.

  • PNG-Assets

  • SVG-Assets