Zum Hauptinhalt springen

So integrieren Sie sich mit Reach RX2

In dieser Anleitung wird erklärt, wie Sie Reach-RX2-Empfänger mit Ihrer Android- oder iOS-App über Bluetooth Classic für Echtzeit-Positionsstreaming integrieren.

Übersicht​

Reach RX2 unterstützt die Integration mit Android- und iOS-Apps über Bluetooth Classic und bietet zwei Optionen, je nachdem, wie viele Metadaten Sie benötigen:

  • Direkter Zugriff auf den NMEA-Stream.
  • Reach RX2 als Standortquelle verwenden.

Weitere Informationen finden Sie in den folgenden Abschnitten.

Verbinden Sie Ihr Mobilgerät mit Reach RX2​

Um eine Verbindung zu Ihrem Reach RX2 herzustellen, müssen Sie ihn mit Ihrem iOS- oder Android-Gerät koppeln. Gehen Sie folgendermaßen vor:

  1. Schalten Sie Ihren Reach RX2 ein.
  2. Gehen Sie zu den Bluetooth-Einstellungen Ihres Geräts.
  3. Suchen Sie den Reach RX2 in der Liste der verfügbaren Geräte und wählen Sie ihn aus, um die Kopplung zu starten.
  4. Warten Sie, bis die Kopplung Ihres Geräts mit Reach RX2 abgeschlossen ist.

Integrierung mit Reach RX2​

Nachdem Sie Ihr iOS- oder Android-Gerät mit Reach RX2 gekoppelt haben, können Sie es integrieren, um die Position von Reach in Ihrer App in Echtzeit abzulesen. Die Integrationsmethode hängt von der Reach-RX2-Revision ab und kann auf zwei Arten durchgeführt werden:

Direkter Zugriff auf den NMEA-Stream​

Wenn Sie weitere Metadaten über die Position, die Positionsqualität oder den Empfänger benötigen, müssen Sie direkt auf den NMEA-Stream zugreifen und ihn analysieren. Dies ist für beide Plattformen möglich:

  • Für iOS-Geräte kann dies mithilfe Apples [External Accessory framework] (https://developer.apple.com/documentation/externalaccessory/) erfolgen. Mit dieser API können Sie sowohl den NMEA-Stream lesen als auch Korrekturen an den Reach RX2 MFi senden. Um den NMEA-Stream zu lesen, müssen Sie ein spezielles Protokoll verwenden: com.emlid.nmea.
  • Bei Android-Geräten kann dies mit der Standard-Bluetooth-Kommunikation über das Bluetooth Serial Port Profile (SPP) erfolgen. Die Bluetooth-API von Android ermöglicht den direkten Zugriff auf den NMEA-Stream und das Senden von RTK-Korrekturen, ohne dass spezielle Protokollnamen erforderlich sind. Die API verwaltet die Verbindung und die Datenübertragung.
tipp

Weitere Informationen über den NMEA-Stream finden Sie in der NMEA-Spezifikation.

Reach RX2 als Standortquelle verwenden​

Dank der MFi-Unterstützung des Reach RX2 ist die einfachste Art der Integration die Verwendung als Standortquelle. Das iOS-Gerät erkennt den Datenstrom von Reach RX2 und verwendet den Standort aus dem Datenstrom anstelle der internen GPS-Einheit. Diese Technik wird auch als „Virtueller Standort“ bezeichnet.

Sobald die Verbindung hergestellt ist, meldet die standardmäßige iOS Core Location API den Standort des Reach-RX2-MFi-Empfängers anstelle der internen GNSS-Einheit des iPhone oder iPad. Wenn Sie sich bisher auf das Framework Core Location verlassen haben, ist keine Entwicklung erforderlich.

Für Android-Geräte können Sie mit Android Virtueller Standort die Integration ohne Code aktivieren. Weitere Informationen finden Sie in der Anleitung [Reach-Koordinaten auf Android-Geräten über Bluetooth abrufen] (../../integration/mock-location).

Einrichten von Korrekturstreams​

Um in RTK mit hochgenauer Positionierung zu arbeiten, müssen Sie dem Gerät RTK-Korrekturen zur Verfügung stellen. Sie können Korrekturen an Reach RX2 auf folgende Weise senden:

  • Für iOS-Geräte können Sie Korrekturen innerhalb der Emlid-Flow-App konfigurieren und im Hintergrund an Ihre App senden.
  • Alternativ für iOS- und Android-Geräte können Sie die Ntrip-Client-Funktionalität auch in Ihre App implementieren. In diesem Fall müssen Sie das com.emlid.corrections-Protokoll implementieren, das zur Übermittlung von Korrekturdaten an Reach-Empfänger verwendet wird. Die Implementierung dieses Protokolls gewährleistet volle Kompatibilität und zuverlässigen Betrieb mit Reach-Geräten.

Nachdem Sie den Korrekturstream auf Ihrem Reach RX2 eingerichtet haben, ist die Integration abgeschlossen.

tipp

Im Artikel [RTK-Korrekturen und Ntrip-Caster] (rtk-corrections-and-casters.mdx) finden Sie Einzelheiten zum Einrichten eines Korrekturstreams, der von Ihrem Gerät an den Empfänger gesendet wird.

Vor der Veröffentlichung der App​

Wenn Sie Ihren Reach RX2 in eine iOS-App integrieren und bereit sind, die App zur Überprüfung einzureichen, kontaktieren Sie uns bitte unter [email protected] und geben Sie Ihre App-Bundle-ID an. Als Zubehörhersteller werden wir Ihre App in die Whitelist aufnehmen.

Wir stellen Ihnen auch eine spezielle Zubehör-PPID zur Verfügung, die Sie in die Metadaten Ihrer App aufnehmen können. Das sollte ausreichen, um Ihre App mit der Reach-RX2-Unterstützung im App Store zu veröffentlichen.