Sammendrag
XREAL One Pro kjører ikke selve den egendefinerte applikasjonen. Appen lages i Unity på en datamaskin, installeres som en Android-APK på XREAL Beam Pro eller en annen støttet Android-vertsenhet, og vises deretter gjennom One Pro-brillene. Denne vertsenhetsmodellen er det viktigste utviklere må forstå før de begynner.
Oppsettet følger en tydelig arbeidsflyt: klargjør Beam Pro, installer Unity og Android-støtte, legg til XREAL SDK, åpne og test HelloMR-eksempelet, bygg APK-en, installer den på Beam Pro med ADB, koble til One Pro og start appen via MyGlasses. For bedrifter gjør denne arkitekturen det enklere å utvikle og teste egendefinerte XREAL-arbeidsflyter med kjente Android- og Unity-verktøy, samtidig som applikasjonslogikken ligger på en separat vertsenhet som kan administreres, oppdateres og integreres med eksisterende bedriftssystemer.
Feilen du bør unngå: Ikke planlegg et prosjekt der APK-en installeres direkte på [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). APK-en installeres på Android-vertsenheten.
Hva er XREAL One Pro?
XREAL One Pro er en kablet AR-skjerm med 57 graders synsfelt, Sony Micro-OLED-skjermer og XREALs X1-brikke for romlig prosessering. X1-brikken gir innebygd 3DoF, slik at skjermen blir stående på plass når du snur hodet, og siden SDK 3.1.0 støtter One-serien også 6DoF-hodesporing med det valgfrie XREAL Eye-kameraet etter en fastvareoppdatering. Ingenting av dette gjør brillene til en frittstående Android-datamaskin.
Ved utvikling av egne apper med XREAL SDK er det den tilkoblede Android-verten som håndterer applikasjonen. One Pro er den bærbare skjermen og sporingsenheten.
Dette trenger du for denne guiden
· En Windows- eller macOS-datamaskin.
· XREAL Beam Pro, eller en Samsung-flaggskiptelefon som XREAL har testet: Galaxy S24 med Android 14 eller Galaxy S25 med Android 15. XREAL støtter kun Samsungs flaggskipmodeller og ber utviklere om ikke å bruke telefoner som er oppdatert til Android 16, så lenge kompatibilitetsvarselet gjelder. Beam Pro er verten som brukes i hovedtrinnene.
· En USB-C-kabel for å koble One Pro til Beam Pro.
· Unity Hub og en støttet Unity LTS-versjon med Android Build Support. (Veiledning i artikkelen)
· Den nyeste XREAL SDK for Unity fra XREALs nedlastingsside for utviklere. (Veiledning i artikkelen)
· Android Debug Bridge (ADB) for å installere APK-en på Beam Pro. (Veiledning i artikkelen)
Slik utvikler du din første app for XREAL One Pro
Trinn 1: Klargjør Beam Pro, enheten som skal kjøre appen
Begynn med Beam Pro, fordi det er her den ferdige Android-appen skal installeres. Beam Pro er en fysisk håndholdt enhet, ikke noe du laster ned.
1. Skaff deg XREAL Beam Pro. Kjøp Beam Pro-maskinvaren fra XREAL eller en autorisert forhandler. Den er en egen enhet, atskilt fra One Pro-brillene.
2. Slå den på og koble den til Wi-Fi. Fullfør det vanlige førstegangsoppsettet av Android/nebulaOS på Beam Pro.
3. Åpne MyGlasses på Beam Pro. MyGlasses er XREALs app for administrasjon av brillene, og den brukes på Beam Pro.
4. Oppdater Beam Pro og MyGlasses hvis du blir bedt om det. SDK 3.1.0 hører sammen med MyGlasses 1.11.0. Ifølge XREALs versjonsmerknad skal du oppdatere MyGlasses først og deretter koble til brillene, noe som automatisk utløser fastvareoppdateringen deres. Beam Pro kjører nebulaOS på Android 14, så XREALs advarsel om Android 16 gjelder telefoner, ikke Beam Pro.
5. Koble One Pro til Beam Pro én gang. Bruk USB-C-kabelen til brillene. Hvis det dukker opp en fastvareoppdatering for brillene, fullfører du den før du begynner utviklingen.
****
Trinn 2: Installer Unity Hub på utviklingsdatamaskinen
1. Åpne Unitys nettsted på datamaskinen. Last ned Unity Hub for Windows eller macOS.
2. Installer og åpne Unity Hub. Unity Hub er et eget skrivebordsprogram som brukes til å installere Unity Editor.
3. Logg inn eller opprett en Unity-konto hvis du blir bedt om det. Dette gir Unity Hub tilgang til installasjonen av editoren og lisensieringsprosessen
Trinn 3: Installer en Unity Editor-versjon med Android-støtte
XREAL SDK kjører i Unity, så Unity Editor må være installert før SDK-en kan importeres.
1. Åpne Unity Hub > Installs. Velg Install Editor.
2. Velg en støttet LTS-versjon. XREAL støtter Unity 2021.3.X, 2022.3.X og 6000.0.X LTS. Bruk en støttet versjon som er oppført i den gjeldende XREAL-dokumentasjonen.
3. Velg Android Build Support. XREALs minstekrav er Android SDK API-nivå 31 (Android 12) eller nyere, noe den medfølgende SDK-en dekker.
4. Fullfør installasjonen. Vent til Unity Hub viser editoren under Installs.
Gå videre til trinn 4 når: Unity Editor er installert og Android Build Support er inkludert.
Trinn 4: Last ned XREAL SDK til datamaskinen
XREAL SDK er en fil som importeres i Unity senere. Ikke prøv å installere den på Beam Pro eller brillene.
1. Åpne XREALs nedlastingsside for utviklere. Gå til developer.xreal.com/download på utviklingsdatamaskinen.
2. Finn XREAL SDK for Unity. Godta XREALs API-vilkår og last ned den nyeste SDK-en.
3. Ta vare på den nedlastede filen. Pakken leveres som en fil, for eksempel com.xreal.xr.tar.gz.
Gå videre til trinn 5 når: XREAL SDK-filen er lagret på datamaskinen. Ikke åpne tar.gz-filen manuelt.
Trinn 5: Opprett Unity-prosjektet
Bruk nå Unity Hub til å opprette prosjektet som senere blir Android-appen som installeres på Beam Pro.
1. Åpne Unity Hub > Projects. Velg New project.
2. Velg en vanlig 3D-mal. Gi prosjektet et enkelt navn, for eksempel XREAL-One-Pro-Test, og velg hvor det skal lagres.
3. Opprett prosjektet. Vent til Unity Editor åpnes.
4. Bytt prosjektet til Android. I Unity Editor åpner du File > Build Settings. Velg Android og klikk på Switch Platform. I Unity 6 bruker du File > Build Profiles hvis det er den menyen som vises.
Gå videre til trinn 6 når: Android er den aktive byggeplattformen i Unity.
Trinn 6: Installer Unity-pakken XREAL trenger
Bli værende i Unity Editor. De neste verktøyene legges til i det samme prosjektet.
1. Åpne Window > Package Manager. I Package Manager-vinduet setter du pakkekilden til Unity Registry. Dette viser pakker som leveres av Unity.
2. Finn XR Interaction Toolkit. Velg den og klikk på Install. XREAL oppgir versjon 2.5.x og 3.0.x som støttet. Hvis Package Manager installerer en nyere versjon og eksempelet ikke fungerer som det skal, velger du heller 3.0.x fra versjonslisten.
3. Åpne fanen Samples for pakken. Finn Starter Assets og klikk på Import, og importer deretter også Hands Interaction Demo. Ifølge XREALs feilsøkingsside viser HelloMR manglende prefabs uten den.
Trinn 7: Importer XREAL SDK i det samme Unity-prosjektet
Du er fortsatt i Unity. Nå skal du bruke XREAL SDK-filen du lastet ned i trinn 4.
1. Bli værende i Window > Package Manager. Klikk på +-knappen øverst til venstre. Velg deretter «Add package from tarball».
2. Finn XREAL SDK-filen du lastet ned tidligere. Gå til mappen Nedlastinger, velg filen som heter noe sånt som com.xreal.xr.tar.gz, og klikk på Åpne. Unity legger nå til XREAL XR Plugin i prosjektet ditt.
3. Åpne XREAL XR Plugin under Package Manager > Samples. Importer Interaction Basics. Dette legger til den ferdiglagde HelloMR-eksempelscenen som du skal bruke for å kontrollere at XREAL-oppsettet fungerer.
Trinn 8: Aktiver XREAL i prosjektet
SDK-en er på plass, men Unity må fortsatt få vite at dette Android-prosjektet skal bruke XREAL-pluginen.
1. Åpne Edit > Project Settings > XR Plug-in Management. Velg fanen Android.
2. Huk av for XREAL. Dette aktiverer XREAL XR-leverandøren for Android-bygget.
3. Åpne Project Validation. Klikk på Fix All for eventuelle nødvendige XREAL-endringer.
4. Åpne XR Plug-in Management > XREAL. For en One Pro uten XREAL Eye setter du Initial Tracking Type til MODE_3DOF, Initial Input Source til Controller (Beam Pro eller telefonen fungerer som en 3DoF-kontroller) og Support Devices til XREAL_DEVICE_CATEGORY_VISION, XREALs kategori for 3DoF-briller som One-serien. La alt annet stå på standardinnstillingene til eksempelet fungerer.
Gå videre til trinn 9 når: Project Validation ikke lenger viser uløste påkrevde XREAL-innstillinger.
Trinn 9: Åpne XREALs HelloMR-eksempel
Før du skriver din egen app, bruker du XREALs eksempel. Dette bekrefter at Unity, XREAL SDK, Beam Pro og brillene kan fungere sammen.
1. Åpne Project-panelet i Unity. Gå til Assets > Samples > XREAL XR Plugin > [din SDK-versjon] > Interaction Basics.
2. Finn HelloMR.unity. Dobbeltklikk på scenen for å åpne den.
3. Ikke tilpass den ennå. Bygg først det uendrede eksempelet, slik at du vet at utviklingsmiljøet fungerer.
Trinn 10: Bygg Android-APK-en på datamaskinen
Unity gjør nå HelloMR-prosjektet om til en Android-appfil. Den filen kalles en APK.
1. Åpne File > Build Settings eller Build Profiles. Velg Add Open Scenes slik at HelloMR blir inkludert.
2. Bekreft at Android er aktiv. Hvis ikke, bytter du til Android.
3. Klikk på Build. Angi Player Settings, og bygg deretter. I Player Settings fyller du ut Company Name og Product Name (MyGlasses viser Product Name, så bruk XREAL-HelloMR) og kontrollerer at Scripting Backend er IL2CPP med ARM64 som målarkitektur; XREAL krever begge deler. Klikk deretter på Build, velg en mappe på datamaskinen og lagre filen som XREAL-HelloMR.apk
4. Vent til byggingen er ferdig. APK-en finnes nå på datamaskinen, men den er ikke på Beam Pro ennå.
Hva en APK er: En APK er filen som brukes til å installere en Android-app. I denne arbeidsflyten havner APK-en på Beam Pro, ikke på [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Trinn 11: Installer APK-en på Beam Pro
ADB: Android Debug Bridge, et dataverktøy som brukes til å installere og teste Android-apper på Beam Pro eller en telefon.
Appen er bygget. Neste trinn flytter APK-en fra datamaskinen til Beam Pro.
1. Koble Beam Pro til datamaskinen med USB-C.
2. Åpne Terminal eller PowerShell på datamaskinen.
3. Aktiver USB-feilsøking på Beam Pro. XREALs veiledning sier bare at du skal aktivere utvikleralternativer og USB-feilsøking på verten. På Android betyr det at du trykker sju ganger på «Delversjonsnummer» under «Om» for å låse opp utvikleralternativer, og deretter slår på USB-feilsøking der. Hvis Beam Pro viser en melding som spør om USB-feilsøking skal tillates fra denne datamaskinen, velger du Tillat.
4. Kontroller at datamaskinen ser Beam Pro. Skriv inn følgende i PowerShell:
adb devices
Vises Beam Pro som device, fungerer tilkoblingen, og du kan fortsette.
5. Installer APK-en. Finn først filen XREAL-HelloMR.apk på datamaskinen. Hvis du for eksempel lagret den i en mappe som heter XREAL Test på skrivebordet, kan Windows-banen se slik ut:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
Skriv inn følgende i PowerShell:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Erstatt eksempelbanen med den faktiske plasseringen av APK-en din, og trykk deretter på Enter.
6. Vent på Success. Når ADB melder Success, er applikasjonen installert på Beam Pro.
Gå videre til trinn 12 når: APK-installasjonen melder Success på datamaskinen.:
Trinn 12: Koble One Pro til Beam Pro og åpne appen
Android-appen ligger nå på Beam Pro. Først nå flytter du USB-C-tilkoblingen fra datamaskinen til brillene.
1. Koble Beam Pro fra datamaskinen.
2. Koble [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) til Beam Pro. Bruk USB-C-kabelen fra XREAL.
3. Åpne MyGlasses på Beam Pro. Dette er XREAL-miljøet som brukes til å administrere de tilkoblede brillene og starte XREAL-3D-applikasjoner.
4. Finn appen din i MyGlasses. Den er oppført under Product Name fra Player Settings, ikke under APK-filnavnet. Velg den og åpne den. Hvis den mangler, eller MyGlasses sier at appen ikke støttes på denne enheten, trykker du ti ganger på brilleikonet øverst til venstre i MyGlasses mens brillene er frakoblet, for å åpne utviklermodus, og bruker deretter «select other MR App» for å velge den.
5. Godkjenn tillatelser hvis du blir bedt om det.
6. Se gjennom One Pro. HelloMR-scenen skal nå vises i brillene mens Beam Pro kjører applikasjonen.
Trinn 13: Gjør din første lille tilpasning
Når det uendrede HelloMR-eksempelet fungerer, går du tilbake til Unity og endrer én ting. Slik unngår du å feilsøke din egen kode før det grunnleggende XREAL-oppsettet er bevist å fungere.
1. Gå tilbake til Unity på datamaskinen. Åpne HelloMR-scenen. Åpne fanen Scene. Det er her du kan bygge grensesnittet og plassere objekter som skal vises gjennom XREAL One Pro.
2. Legg til en Cube. Velg GameObject > 3D Object > Cube og plasser den omtrent én meter foran kameraet. Tekst, knapper, paneler og importerte modeller legges til på samme måte senere. (HelloMR leveres ikke med en Cube; XREALs eksempel viser logoobjektet sitt, så Cube-objektet i punkt 6 og 7 må opprettes her.)
3. Velg et objekt i Hierarchy. Bruk Inspector til å endre posisjon, størrelse, rotasjon og andre innstillinger.
4. Ordne applikasjonens layout. Bygg grensesnittet prosjektet trenger, for eksempel instruksjoner, en produktmodell, et statuspanel eller en Start Inspection-knapp.
5. Legg til C#-kode bare når du trenger egendefinert oppførsel. Det kreves ingen kode bare for å plassere og utforme objekter. Opprett et skript under Assets > Scripts bare når et objekt skal bevege seg, reagere på inndata, endre informasjon eller koble til eksterne data.
Dette valgfrie skriptet får for eksempel et objekt til å rotere:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Fest skriptet til Cube-objektet. Dra SpinObject fra Assets > Scripts til Cube i Hierarchy.
7. Bygg og installer på nytt. Gjenta trinn 10 til 12. Cube-objektet skal rotere når appen kjører på Beam Pro og vises gjennom One Pro.
Hva dette viser: Den egendefinerte C#-koden din kjøres av Android-applikasjonen på Beam Pro. Brillene viser resultatet.
Hvis du vil bruke en Android-telefon i stedet for Beam Pro
Den samme overordnede arkitekturen gjelder, men verten blir en støttet Android-telefon. Du bruker ikke MyGlasses med denne fremgangsmåten.
· Bruk en telefon som XREAL har godkjent. SDK 3.1.0 oppgir Samsung Galaxy S25 med Android 15; XREALs kompatibilitetsside oppgir også Galaxy S24 med Android 14 og sier at bare Samsungs flaggskipmodeller støttes. Sjekk telefonens Android-versjon før du kjøper eller oppdaterer: XREAL ber utviklere om ikke å oppgradere utviklingsenheter til Android 16, og Samsung har rullet ut Android 16 (One UI 8) til begge modellene siden september 2025. Slå av Samsung DeX mens du utvikler.
· Installer APK-en på telefonen i stedet for på Beam Pro.
· Koble XREAL One Pro til telefonen med USB-C.
· Åpne ControlGlasses, finn den installerte XREAL-appen og start den.
Ikke bland de to fremgangsmåtene: Beam Pro bruker MyGlasses. En støttet Android-telefon bruker ControlGlasses.
Vanlige feil under utvikling
- Å prøve å installere APK-en på brillene: Installer den på Beam Pro eller den støttede Android-telefonen.
- Å tro at Beam Pro er en app: Beam Pro er separat fysisk maskinvare. MyGlasses er XREAL-appen som brukes på Beam Pro.
- Å bruke MyGlasses på en vanlig Android-telefon: Ved utvikling på telefon brukes ControlGlasses i stedet.
- Å begynne med egen kode før HelloMR fungerer: Kjør det uendrede eksempelet først, og tilpass deretter.
- Å la Beam Pro være koblet til datamaskinen når du prøver å bruke brillene: Etter at APK-en er installert, kobler du Beam Pro fra datamaskinen og kobler One Pro til Beam Pro.
Konklusjon
Utvikling for XREAL One Pro begynner med å skille mellom de tre delene av systemet: datamaskinen er der Unity-prosjektet lages, Beam Pro eller en støttet Android-telefon er der Android-APK-en faktisk kjører, og XREAL One Pro er den bærbare skjermen og sporingsenheten. Med Beam Pro som den tydeligste veien setter du først opp den fysiske Beam Pro-enheten, installerer Unity Hub og en støttet Unity Editor på datamaskinen, laster ned og importerer XREAL SDK, aktiverer XREAL-pluginen, åpner HelloMR-eksempelet, bygger en APK, installerer APK-en på Beam Pro med ADB, kobler deretter Beam Pro fra datamaskinen, kobler til One Pro og starter appen via MyGlasses. For bedrifter bidrar det å forstå denne arkitekturen før utviklingen starter til å definere riktig plan for maskinvare, sikkerhet og utrulling, gjør pilotprosjekter enklere å feilsøke og hindrer at team bruker tid på å utvikle for en modell med frittstående briller som One Pro ikke bruker.
Planlegger du en XREAL One Pro-applikasjon? Start med én Beam Pro, én One Pro og HelloMR-eksempelet, bevis arbeidsflyten fra vert til briller først, og legg deretter bare til de Unity-funksjonene som forretningsbehovet krever.