Resumé
XREAL One Pro kører ikke selv den specialudviklede applikation. Appen oprettes i Unity på en computer, installeres som en Android-APK på XREAL Beam Pro eller en anden understøttet Android-værtsenhed og vises derefter gennem One Pro-brillerne. Denne værtsenhedsmodel er det vigtigste, udviklere skal forstå, før de går i gang.
Opsætningen følger et klart forløb: Gør Beam Pro klar, installer Unity og Android-understøttelse, tilføj XREAL SDK, åbn og test HelloMR-eksemplet, byg APK'en, installer den på Beam Pro med ADB, tilslut One Pro, og start appen via MyGlasses. For virksomheder gør denne arkitektur det lettere at udvikle og teste skræddersyede XREAL-arbejdsgange med velkendte Android- og Unity-værktøjer, mens applikationslogikken ligger på en separat værtsenhed, der kan administreres, opdateres og integreres med eksisterende virksomhedssystemer.
Fejlen, du skal undgå: Planlæg ikke et projekt, hvor APK'en installeres direkte på [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). APK'en installeres på Android-værtsenheden.
Hvad er XREAL One Pro?
XREAL One Pro er et kablet AR-display med et synsfelt på 57 grader, Sony Micro-OLED-skærme og XREAL's X1-chip til rumlig behandling. X1-chippen giver indbygget 3DoF, så skærmen bliver på sin plads, når du drejer hovedet, og siden SDK 3.1.0 understøtter One-serien også 6DoF-hovedsporing med det valgfrie XREAL Eye-kamera efter en firmwareopdatering. Intet af dette gør brillerne til en selvstændig Android-computer.
Ved specialudvikling med XREAL SDK er det den tilsluttede Android-vært, der håndterer applikationen. One Pro er det bærbare display og sporingsendepunktet.
Det skal du bruge til denne guide
· En Windows- eller macOS-computer.
· XREAL Beam Pro eller en Samsung-flagskibstelefon, som XREAL har testet: Galaxy S24 med Android 14 eller Galaxy S25 med Android 15. XREAL understøtter kun Samsung-flagskibe og beder udviklere om ikke at bruge telefoner, der er opdateret til Android 16, så længe virksomhedens kompatibilitetsmeddelelse gælder. Beam Pro er den vært, der bruges i hovedtrinnene.
· Et USB-C-kabel til at forbinde One Pro med Beam Pro.
· Unity Hub og en understøttet Unity LTS-version med Android Build Support. (Vejledning i artiklen)
· Den aktuelle XREAL SDK til Unity fra XREAL's downloadside for udviklere. (Vejledning i artiklen)
· Android Debug Bridge (ADB) til installation af APK'en på Beam Pro. (Vejledning i artiklen)
Sådan udvikler du din første XREAL One Pro-app
Trin 1: Gør Beam Pro klar – enheden, der skal køre appen
Start med Beam Pro, for det er her, den færdige Android-app skal installeres. Beam Pro er en fysisk håndholdt enhed, ikke noget, du downloader.
1. Anskaf XREAL Beam Pro. Køb Beam Pro-hardwaren hos XREAL eller en autoriseret forhandler. Den er adskilt fra One Pro-brillerne.
2. Tænd den, og forbind den til Wi-Fi. Gennemfør den almindelige førstegangsopsætning af Android/nebulaOS på Beam Pro.
3. Åbn MyGlasses på Beam Pro. MyGlasses er XREAL's app til administration af brillerne, som bruges på Beam Pro.
4. Opdater Beam Pro og MyGlasses, hvis du bliver bedt om det. SDK 3.1.0 hører sammen med MyGlasses 1.11.0. Ifølge XREAL's udgivelsesnoter skal du først opdatere MyGlasses og derefter tilslutte brillerne, hvilket automatisk starter deres firmwareopdatering. Beam Pro kører nebulaOS på Android 14, så XREAL's advarsel om Android 16 gælder telefoner, ikke Beam Pro.
5. Tilslut One Pro til Beam Pro én gang. Brug brillernes USB-C-kabel. Hvis der vises en firmwareopdatering til brillerne, skal du gennemføre den, før du begynder at udvikle.
****
Trin 2: Installer Unity Hub på udviklingscomputeren
1. Åbn Unitys websted på computeren. Download Unity Hub til Windows eller macOS.
2. Installer og åbn Unity Hub. Unity Hub er et separat skrivebordsprogram, der bruges til at installere Unity Editor.
3. Log ind, eller opret en Unity-konto, hvis du bliver bedt om det. Det giver Unity Hub adgang til installationen af editoren og licensforløbet
Trin 3: Installer en Unity Editor-version med Android-understøttelse
XREAL SDK kører inde i Unity, så Unity Editor skal være installeret, før SDK'et kan importeres.
1. Åbn Unity Hub > Installs. Vælg Install Editor.
2. Vælg en understøttet LTS-version. XREAL understøtter Unity 2021.3.X, 2022.3.X og 6000.0.X LTS. Brug en understøttet version, der er angivet i XREAL's aktuelle dokumentation.
3. Vælg Android Build Support. XREAL's minimumskrav er Android SDK API-niveau 31 (Android 12) eller nyere, hvilket det medfølgende SDK dækker.
4. Afslut installationen. Vent, til Unity Hub viser editoren under Installs.
Gå videre til trin 4, når: Unity Editor er installeret, og Android Build Support er inkluderet.
Trin 4: Download XREAL SDK til computeren
XREAL SDK er en fil, der senere importeres i Unity. Forsøg ikke at installere den på Beam Pro eller brillerne.
1. Åbn XREAL's downloadside for udviklere. Gå til developer.xreal.com/download på udviklingscomputeren.
2. Find XREAL SDK til Unity. Accepter XREAL's API-vilkår, og download det aktuelle SDK.
3. Gem den downloadede fil. Pakken leveres som en fil, f.eks. com.xreal.xr.tar.gz.
Gå videre til trin 5, når: XREAL SDK-filen er gemt på computeren. Åbn ikke tar.gz-filen manuelt.
Trin 5: Opret Unity-projektet
Brug nu Unity Hub til at oprette det projekt, der senere bliver til den Android-app, som installeres på Beam Pro.
1. Åbn Unity Hub > Projects. Vælg New project.
2. Vælg en almindelig 3D-skabelon. Giv projektet et enkelt navn som XREAL-One-Pro-Test, og vælg, hvor det skal gemmes.
3. Opret projektet. Vent på, at Unity Editor åbner.
4. Skift projektet til Android. Åbn File > Build Settings i Unity Editor. Vælg Android, og klik på Switch Platform. I Unity 6 skal du bruge File > Build Profiles, hvis det er den menu, der vises.
Gå videre til trin 6, når: Android er den aktive build-platform i Unity.
Trin 6: Installer den Unity-pakke, som XREAL kræver
Bliv i Unity Editor. De næste værktøjer føjes til det samme projekt.
1. Åbn Window > Package Manager. I Package Manager-vinduet skal du sætte pakkekilden til Unity Registry. Så vises de pakker, som Unity leverer.
2. Find XR Interaction Toolkit. Vælg den, og klik på Install. XREAL angiver version 2.5.x og 3.0.x som understøttede; hvis Package Manager installerer en nyere version, og eksemplet ikke opfører sig korrekt, så vælg i stedet 3.0.x på versionslisten.
3. Åbn fanen Samples. Find Starter Assets, klik på Import, og importer derefter også Hands Interaction Demo. Ifølge XREAL's fejlfindingsside viser HelloMR manglende prefabs uden den.
Trin 7: Importer XREAL SDK i det samme Unity-projekt
Du er stadig i Unity. Brug nu den XREAL SDK-fil, du downloadede i trin 4.
1. Bliv i Window > Package Manager. Klik på +-knappen øverst til venstre. Vælg derefter: „Add package from tarball“.
2. Find den XREAL SDK-fil, du downloadede tidligere. Gå til mappen Downloads, vælg filen med et navn som com.xreal.xr.tar.gz, og klik på Open. Unity tilføjer nu XREAL XR Plugin til dit projekt.
3. Åbn XREAL XR Plugin under Package Manager > Samples. Importer Interaction Basics. Det tilføjer den færdige HelloMR-eksempelscene, som du skal bruge til at kontrollere, at XREAL-opsætningen virker.
Trin 8: Aktivér XREAL i projektet
SDK'et er på plads, men Unity skal stadig vide, at dette Android-projekt skal bruge XREAL-plug-in'et.
1. Åbn Edit > Project Settings > XR Plug-in Management. Vælg fanen Android.
2. Sæt flueben ved XREAL. Det aktiverer XREAL XR-udbyderen til Android-buildet.
3. Åbn Project Validation. Klik på Fix All for alle nødvendige XREAL-ændringer.
4. Åbn XR Plug-in Management > XREAL. For en One Pro uden XREAL Eye skal du sætte Initial Tracking Type til MODE_3DOF, Initial Input Source til Controller (Beam Pro eller telefonen fungerer som 3DoF-controller) og Support Devices til XREAL_DEVICE_CATEGORY_VISION, som er XREAL's kategori for 3DoF-briller som One-serien. Lad alt andet stå på standardindstillingerne, indtil eksemplet virker.
Gå videre til trin 9, når: Project Validation ikke længere viser uløste påkrævede XREAL-indstillinger.
Trin 9: Åbn XREAL's HelloMR-eksempel
Brug XREAL's eksempel, før du skriver din egen app. Det bekræfter, at Unity, XREAL SDK, Beam Pro og brillerne kan arbejde sammen.
1. Åbn Project-panelet i Unity. Gå til Assets > Samples > XREAL XR Plugin > [din SDK-version] > Interaction Basics.
2. Find HelloMR.unity. Dobbeltklik på scenen for at åbne den.
3. Tilpas den ikke endnu. Byg først det uændrede eksempel, så du ved, at udviklingsmiljøet virker.
Trin 10: Byg Android-APK'en på computeren
Unity omdanner nu HelloMR-projektet til en Android-appfil. Den fil kaldes en APK.
1. Åbn File > Build Settings eller Build Profiles. Vælg Add Open Scenes, så HelloMR kommer med.
2. Bekræft, at Android er aktiv. Hvis ikke, så skift til Android.
3. Klik på Build. Indstil Player Settings, og byg derefter. Udfyld Company Name og Product Name i Player Settings (MyGlasses viser Product Name, så brug XREAL-HelloMR), og kontrollér, at Scripting Backend er IL2CPP med ARM64 som målarkitektur; XREAL kræver begge dele. Klik derefter på Build, vælg en mappe på computeren, og gem filen som XREAL-HelloMR.apk
4. Vent, til buildet er færdigt. APK'en findes nu på computeren, men den er endnu ikke på Beam Pro.
Hvad en APK er: En APK er den fil, der bruges til at installere en Android-app. I dette forløb skal APK'en over på Beam Pro, ikke på [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Trin 11: Installer APK'en på Beam Pro
ADB: Android Debug Bridge, et computerværktøj, der bruges til at installere og teste Android-apps på Beam Pro eller en telefon.
Appen er bygget. I næste trin flyttes APK'en fra computeren til Beam Pro.
1. Forbind Beam Pro med computeren via USB-C.
2. Åbn Terminal eller PowerShell på computeren.
3. Aktivér USB-fejlfinding på Beam Pro. XREAL's vejledning siger kun, at Udviklerindstillinger og USB-fejlfinding skal aktiveres på værten; på Android betyder det, at du trykker syv gange på „Buildnummer“ under „Om“ for at låse Udviklerindstillinger op og derefter slår USB-fejlfinding til der. Hvis Beam Pro viser en meddelelse, der spørger, om USB-fejlfinding fra denne computer skal tillades, så vælg Tillad.
4. Kontrollér, at computeren kan se Beam Pro. Skriv følgende i PowerShell:
adb devices
Vises Beam Pro som device, fungerer forbindelsen, og du kan fortsætte.
5. Installer APK'en. Find først filen XREAL-HelloMR.apk på computeren. Hvis du f.eks. har gemt den i en mappe ved navn XREAL Test på skrivebordet, kan Windows-stien se sådan ud:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
Skriv følgende i PowerShell:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Erstat eksempelstien med den faktiske placering af din APK, og tryk derefter på Enter.
6. Vent på Success. Når ADB melder Success, er applikationen installeret på Beam Pro.
Gå videre til trin 12, når: APK-installationen melder Success på computeren.:
Trin 12: Tilslut One Pro til Beam Pro, og åbn appen
Android-appen ligger nu på Beam Pro. Først nu flytter du USB-C-forbindelsen fra computeren til brillerne.
1. Frakobl Beam Pro fra computeren.
2. Tilslut [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) til Beam Pro. Brug XREAL's USB-C-kabel.
3. Åbn MyGlasses på Beam Pro. Det er XREAL-miljøet, der bruges til at administrere de tilsluttede briller og starte XREAL-3D-applikationer.
4. Find din app i MyGlasses. Den står under det Product Name, der er angivet i Player Settings, ikke under APK-filnavnet. Vælg den, og åbn den. Hvis den mangler, eller MyGlasses siger, at appen ikke understøttes på denne enhed, så tryk ti gange på brilleikonet i øverste venstre hjørne af MyGlasses, mens brillerne er frakoblet, for at åbne udviklertilstand, og brug derefter 'select other MR App' til at vælge den.
5. Godkend tilladelser, hvis du bliver bedt om det.
6. Kig gennem One Pro. HelloMR-scenen bør nu vises i brillerne, mens Beam Pro kører applikationen.
Trin 13: Lav den første lille tilpasning
Når det uændrede HelloMR-eksempel virker, så vend tilbage til Unity, og ændr én ting. På den måde undgår du at fejlsøge din egen kode, før den grundlæggende XREAL-opsætning har vist sig at virke.
1. Vend tilbage til Unity på computeren. Åbn HelloMR-scenen. Åbn fanen Scene. Her kan du bygge brugerfladen og placere de objekter, der skal vises gennem XREAL One Pro.
2. Tilføj en Cube. Vælg GameObject > 3D Object > Cube, og placer den cirka en meter foran kameraet. Tekst, knapper, paneler og importerede modeller tilføjes senere på samme måde. (HelloMR indeholder ikke en Cube; XREAL's eksempel viser virksomhedens logo-objekt, så den Cube, der bruges i punkt 6 og 7, skal oprettes her.)
3. Vælg et objekt i Hierarchy. Brug Inspector til at ændre dets position, størrelse, rotation og andre indstillinger.
4. Arranger applikationens layout. Byg den brugerflade, projektet kræver, f.eks. instruktioner, en produktmodel, et statuspanel eller en Start Inspection-knap.
5. Tilføj kun C#-kode, når der er brug for specialtilpasset adfærd. Der kræves ingen kode bare for at placere og designe objekter. Opret kun et script under Assets > Scripts, når et objekt skal bevæge sig, reagere på input, ændre information eller forbinde til eksterne data.
Dette valgfrie script får f.eks. et objekt til at rotere:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Tilknyt scriptet til Cube. Træk SpinObject fra Assets > Scripts over på Cube i Hierarchy.
7. Byg og installer igen. Gentag trin 10 til 12. Cube bør rotere, når appen kører på Beam Pro og vises gennem One Pro.
Det viser dette: Din egen C#-kode udføres af Android-applikationen på Beam Pro. Brillerne viser resultatet.
Hvis du vil bruge en Android-telefon i stedet for Beam Pro
Den samme overordnede arkitektur gælder, men værten bliver en understøttet Android-telefon. Du bruger ikke MyGlasses på denne vej.
· Brug en telefon, som XREAL har godkendt. SDK 3.1.0 angiver Samsung Galaxy S25 med Android 15; XREAL's kompatibilitetsside angiver også Galaxy S24 med Android 14 og oplyser, at kun Samsung-flagskibe understøttes. Tjek telefonens Android-version, før du køber eller opdaterer: XREAL beder udviklere om ikke at opdatere udviklingsenheder til Android 16, og Samsung har siden september 2025 udrullet Android 16 (One UI 8) til begge modeller. Slå Samsung DeX fra, mens du udvikler.
· Installer APK'en på telefonen i stedet for på Beam Pro.
· Tilslut XREAL One Pro til telefonen via USB-C.
· Åbn ControlGlasses, find den installerede XREAL-app, og start den.
Bland ikke de to veje sammen: Beam Pro bruger MyGlasses. En understøttet Android-telefon bruger ControlGlasses.
Almindelige fejl under udvikling
- At forsøge at installere APK'en på brillerne: Installer den på Beam Pro eller den understøttede Android-telefon.
- At tro, at Beam Pro er en app: Beam Pro er separat fysisk hardware. MyGlasses er den XREAL-app, der bruges på Beam Pro.
- At bruge MyGlasses på en almindelig Android-telefon: Ved udvikling på telefon bruges ControlGlasses i stedet.
- At starte med egen kode, før HelloMR virker: Kør det uændrede eksempel først, og tilpas derefter.
- At lade Beam Pro være forbundet til computeren, når du prøver at bruge brillerne: Når APK'en er installeret, skal du frakoble Beam Pro fra computeren og tilslutte One Pro til Beam Pro.
Konklusion
Udvikling til XREAL One Pro begynder med at adskille systemets tre dele: Computeren er der, hvor Unity-projektet oprettes, Beam Pro eller en understøttet Android-telefon er der, hvor Android-APK'en faktisk kører, og XREAL One Pro er det bærbare display og sporingsenheden. Med Beam Pro som den mest overskuelige vej skal du først sætte den fysiske Beam Pro op, installere Unity Hub og en understøttet Unity Editor på computeren, downloade og importere XREAL SDK, aktivere XREAL-plug-in'et, åbne HelloMR-eksemplet, bygge en APK, installere APK'en på Beam Pro med ADB og derefter frakoble Beam Pro fra computeren, tilslutte One Pro og starte appen via MyGlasses. For virksomheder hjælper det at forstå denne arkitektur, før udviklingen begynder, med at fastlægge den rigtige plan for hardware, sikkerhed og udrulning; det gør pilotprojekter lettere at fejlsøge og forhindrer, at teams bruger tid på at bygge til en model med selvstændige briller, som One Pro ikke bruger.
Planlægger du en XREAL One Pro-applikation? Start med én Beam Pro, én One Pro og HelloMR-eksemplet, bevis først arbejdsgangen fra vært til briller, og tilføj derefter kun de Unity-funktioner, som den konkrete forretningsanvendelse kræver.
