So integrieren Sie sich mit Reach RX MFi
In dieser Anleitung wird erklärt, wie Sie Reach-RX-Empfänger mit Ihrer Android- oder iOS-App über Bluetooth Classic für Echtzeit-Positionsstreaming integrieren.
Übersicht
Alle Reach-RX-Versionen sind mit Android-Apps über Bluetooth Classic kompatibel; allerdings unterstützt nur die zweite Version von Reach RX, die MFi-zertifiziert ist, die Bluetooth-Classic-Verbindung mit Apple-Geräten.
Um zu überprüfen, ob Ihr Reach RX MFi-zertifiziert ist, prüfen Sie Folgendes:
- die MFi-Kennzeichnung auf der Verpackung
- die MFi-Kennzeichnung auf der Unterseite des Geräts
- die letzten vier Ziffern der Seriennummer sind größer als 2414
Wie Sie die Seriennummer Ihres Reach RX überprüfen können, erfahren Sie in der Anleitung So finden Sie die Seriennummer.
Verbinden Sie Ihr Mobilgerät mit Reach RX
Um eine Verbindung zu Ihrem Reach RX herzustellen, müssen Sie ihn mit Ihrem iOS- oder Android-Gerät koppeln. Gehen Sie folgendermaßen vor:
- Schalten Sie Ihren Reach RX ein.
- Gehen Sie zu den Bluetooth-Einstellungen Ihres Geräts.
- Suchen Sie den Reach RX in der Liste der verfügbaren Geräte und wählen Sie ihn aus, um die Kopplung zu starten.
- Warten Sie, bis die Kopplung Ihres Geräts mit Reach RX abgeschlossen ist.
Integrierung mit Reach RX
Nachdem Sie Ihr iOS- oder Android-Gerät mit Reach RX 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-RX-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 erfolgen. Mit dieser API können Sie sowohl den NMEA-Stream lesen als auch Korrekturen an den Reach RX 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.
Weitere Informationen über den NMEA-Stream finden Sie in der NMEA-Spezifikation.
Reach RX MFi als Standortquelle verwenden
Für Reach RX MFi ist die einfachste Art der Integration die Verwendung als Standortquelle. Das iOS-Gerät erkennt den Datenstrom von Reach RX 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-RX-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.
Bei Android-Geräten können Sie die No-Code-Integration mit Androids virtuellem Standort und einer Drittanbieter-App wie Lefebure aktivieren. Weitere Informationen finden Sie in der Anleitung Reach-Koordinaten auf Android-Geräten über Bluetooth abrufen.
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 RX 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.
Nachdem Sie den Korrekturstream auf Ihrem Reach RX eingerichtet haben, ist die Integration abgeschlossen.
Im Artikel RTK-Korrekturen und Ntrip-Caster 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 RX MFi in eine iOS-App integrieren und bereit sind, die App zur Überprüfung einzureichen, kontaktieren Sie uns bitte unter developers@emlid.com 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-RX-Unterstützung im App Store zu veröffentlichen.