Zusammenfassung
XREAL One Pro führt die eigene Anwendung nicht selbst aus. Die App wird in Unity auf einem Computer erstellt, als Android-APK auf XREAL Beam Pro oder einem anderen unterstützten Android-Host-Gerät installiert und dann über die One-Pro-Brille angezeigt. Dieses Host-Geräte-Modell ist der wichtigste Punkt, den Entwickler vor dem Start verstehen müssen.
Die Einrichtung folgt einem klaren Ablauf: Beam Pro vorbereiten, Unity mit Android-Unterstützung installieren, das XREAL SDK hinzufügen, das HelloMR-Beispiel öffnen und testen, die APK erstellen, sie per ADB auf Beam Pro installieren, die One Pro anschließen und die App über MyGlasses starten. Für Unternehmen erleichtert diese Architektur die Entwicklung und das Testen eigener XREAL-Workflows mit vertrauten Android- und Unity-Werkzeugen, während die Anwendungslogik auf einem separaten Host-Gerät bleibt, das sich verwalten, aktualisieren und in bestehende Unternehmenssysteme integrieren lässt.
Der Fehler, den Sie vermeiden sollten: Planen Sie kein Projekt, bei dem die APK direkt auf der [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) installiert wird. Die APK wird auf dem Android-Host-Gerät installiert.
Was ist XREAL One Pro?
XREAL One Pro ist ein kabelgebundenes AR-Display mit 57 Grad Sichtfeld, Sony-Micro-OLED-Displays und XREALs räumlichem Verarbeitungschip X1. Der X1-Chip bietet natives 3DoF, sodass der Bildschirm an seinem Platz bleibt, wenn Sie den Kopf drehen, und seit SDK 3.1.0 unterstützt die One-Serie nach einem Firmware-Update mit der optionalen XREAL-Eye-Kamera auch 6DoF-Head-Tracking. Nichts davon macht die Brille zu einem eigenständigen Android-Computer.
Bei der Entwicklung eigener Anwendungen mit dem XREAL SDK übernimmt der angeschlossene Android-Host die Anwendung. Die One Pro ist das tragbare Display und der Tracking-Endpunkt.
Was Sie für diese Anleitung benötigen
· Einen Windows- oder macOS-Computer.
· XREAL Beam Pro oder ein von XREAL getestetes Samsung-Flaggschiff-Smartphone: das Galaxy S24 mit Android 14 oder das Galaxy S25 mit Android 15. XREAL unterstützt ausschließlich Samsung-Flaggschiffe und bittet Entwickler, keine auf Android 16 aktualisierten Smartphones zu verwenden, solange der entsprechende Kompatibilitätshinweis gilt. Beam Pro ist der Host, der in den Hauptschritten verwendet wird.
· Ein USB-C-Kabel, um die One Pro mit Beam Pro zu verbinden.
· Unity Hub und eine unterstützte Unity-LTS-Version mit Android Build Support. (Anleitung im Artikel)
· Das aktuelle XREAL SDK für Unity von der Entwickler-Downloadseite von XREAL. (Anleitung im Artikel)
· Android Debug Bridge (ADB), um die APK auf Beam Pro zu installieren. (Anleitung im Artikel)
So entwickeln Sie Ihre erste App für XREAL One Pro
Schritt 1: Beam Pro vorbereiten – das Gerät, auf dem die App läuft
Beginnen Sie mit Beam Pro, denn hier wird die fertige Android-App installiert. Beam Pro ist ein physisches Handgerät, nichts, was man herunterlädt.
1. XREAL Beam Pro besorgen. Kaufen Sie die Beam-Pro-Hardware bei XREAL oder einem autorisierten Händler. Sie ist von der One-Pro-Brille getrennt.
2. Einschalten und mit dem WLAN verbinden. Führen Sie auf Beam Pro die normale Ersteinrichtung von Android/nebulaOS durch.
3. MyGlasses auf Beam Pro öffnen. MyGlasses ist die XREAL-App zur Verwaltung der Brille, die auf Beam Pro verwendet wird.
4. Beam Pro und MyGlasses bei Aufforderung aktualisieren. SDK 3.1.0 gehört zu MyGlasses 1.11.0. Laut den Release Notes von XREAL sollten Sie zuerst MyGlasses aktualisieren und dann die Brille anschließen, wodurch deren Firmware-Update automatisch ausgelöst wird. Beam Pro läuft mit nebulaOS auf Basis von Android 14, daher gilt die Android-16-Warnung von XREAL für Smartphones, nicht für Beam Pro.
5. One Pro einmal mit Beam Pro verbinden. Verwenden Sie das USB-C-Kabel der Brille. Falls ein Firmware-Update für die Brille angezeigt wird, schließen Sie es vor der Entwicklung ab.
****
Schritt 2: Unity Hub auf dem Entwicklungscomputer installieren
1. Unity-Website auf dem Computer öffnen. Laden Sie Unity Hub für Windows oder macOS herunter.
2. Unity Hub installieren und öffnen. Unity Hub ist ein separates Desktop-Programm, mit dem der Unity Editor installiert wird.
3. Bei Aufforderung anmelden oder ein Unity-Konto erstellen. Damit erhält Unity Hub Zugriff auf die Editor-Installation und den Lizenzierungsablauf
Schritt 3: Eine Unity-Editor-Version mit Android-Unterstützung installieren
Das XREAL SDK läuft innerhalb von Unity, daher muss der Unity Editor installiert sein, bevor das SDK importiert werden kann.
1. Unity Hub > Installs öffnen. Wählen Sie Install Editor.
2. Eine unterstützte LTS-Version wählen. XREAL unterstützt Unity 2021.3.X, 2022.3.X und 6000.0.X LTS. Verwenden Sie eine unterstützte Version, die in der aktuellen XREAL-Dokumentation aufgeführt ist.
3. Android Build Support auswählen. XREAL setzt mindestens Android-SDK-API-Level 31 (Android 12) oder höher voraus, was das mitgelieferte SDK abdeckt.
4. Installation abschließen. Warten Sie, bis Unity Hub den Editor unter Installs anzeigt.
Weiter mit Schritt 4, wenn: der Unity Editor installiert und Android Build Support enthalten ist.
Schritt 4: Das XREAL SDK auf den Computer herunterladen
Das XREAL SDK ist eine Datei, die später in Unity importiert wird. Versuchen Sie nicht, es auf Beam Pro oder der Brille zu installieren.
1. Die Downloadseite für XREAL-Entwickler öffnen. Rufen Sie auf dem Entwicklungscomputer developer.xreal.com/download auf.
2. XREAL SDK for Unity suchen. Akzeptieren Sie die XREAL-API-Bedingungen und laden Sie das aktuelle SDK herunter.
3. Die heruntergeladene Datei aufbewahren. Das Paket wird als Datei geliefert, etwa com.xreal.xr.tar.gz.
Weiter mit Schritt 5, wenn: die XREAL-SDK-Datei auf dem Computer gespeichert ist. Öffnen Sie die tar.gz-Datei nicht manuell.
Schritt 5: Das Unity-Projekt erstellen
Erstellen Sie nun mit Unity Hub das Projekt, aus dem später die auf Beam Pro installierte Android-App wird.
1. Unity Hub > Projects öffnen. Wählen Sie New project.
2. Eine normale 3D-Vorlage wählen. Geben Sie dem Projekt einen einfachen Namen wie XREAL-One-Pro-Test und wählen Sie den Speicherort.
3. Projekt erstellen. Warten Sie, bis sich der Unity Editor öffnet.
4. Das Projekt auf Android umstellen. Öffnen Sie im Unity Editor File > Build Settings. Wählen Sie Android und klicken Sie auf Switch Platform. Verwenden Sie in Unity 6 File > Build Profiles, falls dieses Menü angezeigt wird.
Weiter mit Schritt 6, wenn: Android die aktive Build-Plattform in Unity ist.
Schritt 6: Das von XREAL benötigte Unity-Paket installieren
Bleiben Sie im Unity Editor. Die nächsten Werkzeuge werden demselben Projekt hinzugefügt.
1. Window > Package Manager öffnen. Stellen Sie im Package-Manager-Fenster die Paketquelle auf Unity Registry. Dort werden die von Unity bereitgestellten Pakete angezeigt.
2. XR Interaction Toolkit suchen. Wählen Sie es aus und klicken Sie auf Install. XREAL führt die Versionen 2.5.x und 3.0.x als unterstützt auf; falls der Package Manager eine neuere Version installiert und das Beispiel nicht richtig funktioniert, wählen Sie stattdessen 3.0.x aus der Versionsliste.
3. Den Tab Samples öffnen. Suchen Sie Starter Assets und klicken Sie auf Import; importieren Sie anschließend auch Hands Interaction Demo. Laut der Fehlerbehebungsseite von XREAL zeigt HelloMR ohne diese Demo fehlende Prefabs an.
Schritt 7: Das XREAL SDK in dasselbe Unity-Projekt importieren
Sie sind weiterhin in Unity. Verwenden Sie jetzt die in Schritt 4 heruntergeladene XREAL-SDK-Datei.
1. In Window > Package Manager bleiben. Klicken Sie oben links auf die Schaltfläche +. Wählen Sie dann „Add package from tarball“.
2. Die zuvor heruntergeladene XREAL-SDK-Datei suchen. Öffnen Sie Ihren Ordner Downloads, wählen Sie die Datei mit einem Namen wie com.xreal.xr.tar.gz aus und klicken Sie auf Öffnen. Unity fügt Ihrem Projekt nun das XREAL XR Plugin hinzu.
3. XREAL XR Plugin unter Package Manager > Samples öffnen. Importieren Sie Interaction Basics. Dadurch wird die fertige Beispielszene HelloMR hinzugefügt, mit der Sie prüfen, ob die XREAL-Einrichtung funktioniert.
Schritt 8: XREAL im Projekt aktivieren
Das SDK ist vorhanden, aber Unity muss noch erfahren, dass dieses Android-Projekt das XREAL-Plug-in verwenden soll.
1. Edit > Project Settings > XR Plug-in Management öffnen. Wählen Sie den Tab Android.
2. XREAL ankreuzen. Damit wird der XREAL-XR-Provider für den Android-Build aktiviert.
3. Project Validation öffnen. Klicken Sie bei allen erforderlichen XREAL-Änderungen auf Fix All.
4. XR Plug-in Management > XREAL öffnen. Setzen Sie bei einer One Pro ohne XREAL Eye Initial Tracking Type auf MODE_3DOF, Initial Input Source auf Controller (Beam Pro bzw. das Smartphone dient als 3DoF-Controller) und Support Devices auf XREAL_DEVICE_CATEGORY_VISION, die XREAL-Kategorie für 3DoF-Brillen wie die One-Serie. Belassen Sie alles andere bei den Standardwerten, bis das Beispiel funktioniert.
Weiter mit Schritt 9, wenn: Project Validation keine ungelösten erforderlichen XREAL-Einstellungen mehr anzeigt.
Schritt 9: Das HelloMR-Beispiel von XREAL öffnen
Bevor Sie Ihre eigene App schreiben, verwenden Sie das Beispiel von XREAL. Damit stellen Sie sicher, dass Unity, XREAL SDK, Beam Pro und die Brille zusammenarbeiten.
1. Das Project-Fenster in Unity öffnen. Navigieren Sie zu Assets > Samples > XREAL XR Plugin > [Ihre SDK-Version] > Interaction Basics.
2. HelloMR.unity suchen. Doppelklicken Sie auf die Szene, um sie zu öffnen.
3. Noch nichts anpassen. Erstellen Sie zuerst das unveränderte Beispiel, damit Sie wissen, dass die Entwicklungsumgebung funktioniert.
Schritt 10: Die Android-APK auf dem Computer erstellen
Unity macht nun aus dem HelloMR-Projekt eine Android-App-Datei. Diese Datei heißt APK.
1. File > Build Settings oder Build Profiles öffnen. Wählen Sie Add Open Scenes, damit HelloMR enthalten ist.
2. Prüfen, ob Android aktiv ist. Falls nicht, wechseln Sie zu Android.
3. Auf Build klicken. Legen Sie die Player Settings fest und erstellen Sie dann den Build. Tragen Sie in den Player Settings Company Name und Product Name ein (MyGlasses zeigt den Product Name an, verwenden Sie also XREAL-HelloMR) und prüfen Sie, dass als Scripting Backend IL2CPP und als Zielarchitektur ARM64 eingestellt ist; XREAL setzt beides voraus. Klicken Sie dann auf Build, wählen Sie einen Ordner auf Ihrem Computer und speichern Sie die Datei als XREAL-HelloMR.apk
4. Warten, bis der Build abgeschlossen ist. Die APK befindet sich jetzt auf dem Computer, aber noch nicht auf Beam Pro.
Was eine APK ist: Eine APK ist die Datei, mit der eine Android-App installiert wird. In diesem Workflow kommt die APK auf Beam Pro, nicht auf die [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Schritt 11: Die APK auf Beam Pro installieren
ADB: Android Debug Bridge, ein Computer-Tool, mit dem Android-Apps auf Beam Pro oder einem Smartphone installiert und getestet werden.
Die App ist erstellt. Im nächsten Schritt wird die APK vom Computer auf Beam Pro übertragen.
1. Beam Pro per USB-C mit dem Computer verbinden.
2. Terminal oder PowerShell auf dem Computer öffnen.
3. USB-Debugging auf Beam Pro aktivieren. Die Anleitung von XREAL sagt nur, dass auf dem Host die Entwickleroptionen und USB-Debugging aktiviert werden sollen; unter Android bedeutet das, unter „Über“ siebenmal auf „Build-Nummer“ zu tippen, um die Entwickleroptionen freizuschalten, und dort dann USB-Debugging einzuschalten. Wenn Beam Pro fragt, ob USB-Debugging von diesem Computer zugelassen werden soll, wählen Sie Zulassen.
4. Prüfen, ob der Computer Beam Pro erkennt. Geben Sie in PowerShell Folgendes ein:
adb devices
Wird Beam Pro als device angezeigt, funktioniert die Verbindung und Sie können fortfahren.
5. Die APK installieren. Suchen Sie zunächst die Datei XREAL-HelloMR.apk auf Ihrem Computer. Wenn Sie sie zum Beispiel in einem Ordner namens XREAL Test auf Ihrem Desktop gespeichert haben, könnte der Windows-Pfad so aussehen:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
Geben Sie in PowerShell Folgendes ein:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Ersetzen Sie den Beispielpfad durch den tatsächlichen Speicherort Ihrer APK und drücken Sie dann Enter.
6. Auf Success warten. Sobald ADB Success meldet, ist die Anwendung auf Beam Pro installiert.
Weiter mit Schritt 12, wenn: die APK-Installation auf dem Computer Success meldet.:
Schritt 12: One Pro mit Beam Pro verbinden und die App öffnen
Die Android-App befindet sich jetzt auf Beam Pro. Erst jetzt stecken Sie die USB-C-Verbindung vom Computer auf die Brille um.
1. Beam Pro vom Computer trennen.
2. Die [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) mit Beam Pro verbinden. Verwenden Sie das USB-C-Kabel von XREAL.
3. MyGlasses auf Beam Pro öffnen. Dies ist die XREAL-Umgebung, mit der die angeschlossene Brille verwaltet und XREAL-3D-Anwendungen gestartet werden.
4. Ihre App in MyGlasses suchen. Sie wird unter dem Product Name aus den Player Settings aufgeführt, nicht unter dem Namen der APK-Datei. Wählen Sie sie aus und öffnen Sie sie. Falls sie fehlt oder MyGlasses meldet, dass die App auf diesem Gerät nicht unterstützt wird, tippen Sie bei getrennter Brille zehnmal auf das Brillensymbol oben links in MyGlasses, um den Entwicklermodus zu öffnen, und wählen Sie die App dann über 'select other MR App' aus.
5. Berechtigungen bei Aufforderung bestätigen.
6. Durch die One Pro schauen. Die HelloMR-Szene sollte nun in der Brille erscheinen, während Beam Pro die Anwendung ausführt.
Schritt 13: Die erste kleine eigene Änderung vornehmen
Sobald das unveränderte HelloMR-Beispiel funktioniert, kehren Sie zu Unity zurück und ändern eine Sache. So vermeiden Sie es, Ihren eigenen Code zu debuggen, bevor die grundlegende XREAL-Einrichtung nachweislich funktioniert.
1. Zu Unity auf dem Computer zurückkehren. Öffnen Sie die HelloMR-Szene. Öffnen Sie den Tab Scene. Hier können Sie die Oberfläche aufbauen und Objekte positionieren, die über die XREAL One Pro angezeigt werden.
2. Einen Cube hinzufügen. Wählen Sie GameObject > 3D Object > Cube und platzieren Sie ihn etwa einen Meter vor der Kamera. Texte, Schaltflächen, Panels und importierte Modelle werden später auf dieselbe Weise hinzugefügt. (HelloMR enthält keinen Cube; das Beispiel von XREAL zeigt sein Logo-Objekt, daher muss der Cube für die Punkte 6 und 7 hier erstellt werden.)
3. Ein Objekt in der Hierarchy auswählen. Ändern Sie im Inspector Position, Größe, Drehung und weitere Einstellungen.
4. Das Layout der Anwendung anordnen. Bauen Sie die für das Projekt benötigte Oberfläche auf, etwa Anweisungen, ein Produktmodell, ein Status-Panel oder eine Schaltfläche „Start Inspection“.
5. C#-Code nur hinzufügen, wenn eigenes Verhalten nötig ist. Um Objekte zu platzieren und zu gestalten, ist kein Code erforderlich. Erstellen Sie nur dann ein Skript unter Assets > Scripts, wenn sich ein Objekt bewegen, auf Eingaben reagieren, Informationen ändern oder sich mit externen Daten verbinden soll.
Dieses optionale Skript lässt zum Beispiel ein Objekt rotieren:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Das Skript an den Cube anhängen. Ziehen Sie SpinObject aus Assets > Scripts auf den Cube in der Hierarchy.
7. Erneut erstellen und installieren. Wiederholen Sie die Schritte 10 bis 12. Der Cube sollte sich drehen, wenn die App auf Beam Pro läuft und über die One Pro angezeigt wird.
Was das zeigt: Ihr eigener C#-Code wird von der Android-Anwendung auf Beam Pro ausgeführt. Die Brille zeigt das Ergebnis an.
Wenn Sie statt Beam Pro ein Android-Smartphone verwenden möchten
Die grundlegende Architektur bleibt gleich, nur wird ein unterstütztes Android-Smartphone zum Host. Auf diesem Weg verwenden Sie MyGlasses nicht.
· Verwenden Sie ein von XREAL freigegebenes Smartphone. SDK 3.1.0 führt das Samsung Galaxy S25 mit Android 15 auf; die Kompatibilitätsseite von XREAL nennt außerdem das Galaxy S24 mit Android 14 und gibt an, dass nur Samsung-Flaggschiffe unterstützt werden. Prüfen Sie vor dem Kauf oder einem Update die Android-Version des Smartphones: XREAL bittet Entwickler, Entwicklungsgeräte nicht auf Android 16 umzustellen, und Samsung liefert Android 16 (One UI 8) seit September 2025 für beide Modelle aus. Schalten Sie Samsung DeX während der Entwicklung aus.
· Installieren Sie die APK auf dem Smartphone statt auf Beam Pro.
· Verbinden Sie die XREAL One Pro per USB-C mit dem Smartphone.
· Öffnen Sie ControlGlasses, suchen Sie die installierte XREAL-App und starten Sie sie.
Vermischen Sie die beiden Wege nicht: Beam Pro verwendet MyGlasses. Ein unterstütztes Android-Smartphone verwendet ControlGlasses.
Häufige Fehler bei der Entwicklung
- Versuch, die APK auf der Brille zu installieren: Installieren Sie sie auf Beam Pro oder dem unterstützten Android-Smartphone.
- Annahme, Beam Pro sei eine App: Beam Pro ist separate physische Hardware. MyGlasses ist die XREAL-App, die auf Beam Pro verwendet wird.
- MyGlasses auf einem normalen Android-Smartphone verwenden: Für die Entwicklung mit dem Smartphone wird stattdessen ControlGlasses verwendet.
- Mit eigenem Code beginnen, bevor HelloMR funktioniert: Führen Sie zuerst das unveränderte Beispiel aus und passen Sie es danach an.
- Beam Pro bei der Nutzung der Brille am Computer angeschlossen lassen: Trennen Sie Beam Pro nach der Installation der APK vom Computer und verbinden Sie die One Pro mit Beam Pro.
Fazit
Die Entwicklung für XREAL One Pro beginnt damit, die drei Teile des Systems auseinanderzuhalten: Auf dem Computer wird das Unity-Projekt erstellt, auf Beam Pro oder einem unterstützten Android-Smartphone läuft die Android-APK tatsächlich, und die XREAL One Pro ist das tragbare Display- und Tracking-Gerät. Mit Beam Pro als dem klarsten Weg richten Sie zuerst das physische Beam Pro ein, installieren Unity Hub und einen unterstützten Unity Editor auf dem Computer, laden das XREAL SDK herunter und importieren es, aktivieren das XREAL-Plug-in, öffnen das HelloMR-Beispiel, erstellen eine APK, installieren diese per ADB auf Beam Pro, trennen Beam Pro dann vom Computer, schließen die One Pro an und starten die App über MyGlasses. Für Unternehmen hilft es, diese Architektur vor Entwicklungsbeginn zu verstehen: So lassen sich die richtige Hardware-, Sicherheits- und Bereitstellungsplanung festlegen, Pilotprojekte leichter auf Fehler untersuchen, und Teams verschwenden keine Zeit mit der Entwicklung für ein Modell eigenständiger Brillen, das die One Pro nicht verwendet.
Sie planen eine Anwendung für XREAL One Pro? Beginnen Sie mit einem Beam Pro, einer One Pro und dem HelloMR-Beispiel, weisen Sie zuerst nach, dass der Workflow vom Host zur Brille funktioniert, und fügen Sie dann nur die Unity-Funktionen hinzu, die für den geschäftlichen Anwendungsfall erforderlich sind.
