Übersicht

Die Nearby Messages API ist eine Publish/Subscribe-API, mit der Sie kleine binäre Nutzlasten zwischen internetfähigen Android- und iOS-Geräten übertragen können. Die Geräte müssen nicht mit demselben Netzwerk verbunden sein, aber sie müssen mit dem Internet verbunden sein.

Nearby verwendet Bluetooth Low Energy, um einen einmaligen Pairing-Code zwischen Geräten zu übertragen. Der Server ermöglicht den Nachrichtenaustausch zwischen Geräten, die denselben Pairing-Code erkennen. Wenn ein Gerät einen Kopplungscode von einem Gerät in der Nähe erkennt, wird der Kopplungscode zur Validierung an den Nearby Messages-Server gesendet. Außerdem wird geprüft, ob Nachrichten für die aktuelle Gruppe von Abos der Anwendung zugestellt werden müssen.

Nearby Messages ist nicht authentifiziert und erfordert kein Google-Konto.

Das genaue Verfahren für den Datenaustausch kann sich von Version zu Version unterscheiden. Die folgende Sequenz zeigt die Ereignisse, die zum Nachrichtenaustausch führen:

  1. Eine Veröffentlichungs-App sendet eine Anfrage, um eine binäre Nutzlast (die Nachricht) mit einem zeitlich eindeutigen Pairing-Code (Token) zu verknüpfen. Der Server stellt eine temporäre Verbindung zwischen der Nutzlast der Nachricht und dem Token her.

  2. Das Veröffentlichungsgerät verwendet Bluetooth Low Energy, um das Token für Geräte in der Nähe erkennbar zu machen. Das Veröffentlichungsgerät verwendet außerdem Bluetooth Low Energy, um nach Tokens von anderen Geräten zu suchen.

  3. Eine abonnierende App verknüpft ihr Abo mit einem Token und verwendet Bluetooth Low Energy, um ihr Token an den Verlag oder Webpublisher zu senden und das Token des Verlags oder Webpublishers zu erkennen.

  4. Wenn eine der beiden Seiten das Token der anderen erkennt, wird es an den Server gemeldet.

  5. Der Server ermöglicht den Nachrichtenaustausch zwischen zwei Geräten, wenn beide einem gemeinsamen Token zugeordnet sind und die von den aufrufenden Apps verwendeten API-Schlüssel demselben Projekt in der Google Developers Console zugeordnet sind.

Wenn Sie das Google Play-Dienste Nearby SDK verwenden, werden Nutzungsanalysen erhoben, um die Nutzerfreundlichkeit zu verbessern.

  • Leistungsmesswerte:Bei der Verwendung des Nearby SDK werden die Dauer von Veröffentlichungen und Abos sowie die Anzahl der empfangenen Nachrichten erfasst.
  • Geräteinformationen:Gerätemodell, Land, Build-Version und der Paketname der Anwendung werden erfasst und den Leistungsmesswerten zugeordnet, um regionale und gerätespezifische Segmente zu identifizieren.
  • Veröffentlichungen über Nearby Messages:Daten, die über Nearby Messages veröffentlicht werden, werden von Google gespeichert, bis die Nachricht nicht mehr veröffentlicht wird. Diese Daten werden mit Abonnenten geteilt, die sich in der Nähe des Geräts befinden.

Endnutzer können diese Erhebung zulassen oder ablehnen, indem sie zu „Einstellungen“ > „Google“ > „Nutzung & Diagnose“ gehen.