Tiivistelmä
XREAL One Pro ei itse suorita räätälöityä sovellusta. Sovellus luodaan Unityssä tietokoneella, asennetaan Android-APK:na XREAL Beam Prolle tai muulle tuetulle Android-isäntälaitteelle ja näytetään sitten One Pro -lasien kautta. Tämä isäntälaitemalli on tärkein asia, joka kehittäjien on ymmärrettävä ennen aloittamista.
Käyttöönotto etenee selkeässä järjestyksessä: valmistele Beam Pro, asenna Unity ja Android-tuki, lisää XREAL SDK, avaa ja testaa HelloMR-esimerkki, koosta APK, asenna se Beam Prolle ADB:llä, liitä One Pro ja käynnistä sovellus MyGlassesin kautta. Yrityksille tämä arkkitehtuuri helpottaa räätälöityjen XREAL-työnkulkujen kehittämistä ja testaamista tutuilla Android- ja Unity-työkaluilla, ja samalla sovelluslogiikka pysyy erillisellä isäntälaitteella, jota voidaan hallita, päivittää ja integroida yrityksen olemassa oleviin järjestelmiin.
Vältettävä virhe: Älä suunnittele projektia, jossa APK asennetaan suoraan [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) -laseille. APK asennetaan Android-isäntälaitteelle.
Mikä XREAL One Pro on?
XREAL One Pro on kaapelilla liitettävä AR-näyttö, jossa on 57 asteen näkökenttä, Sonyn Micro-OLED-näytöt ja XREALin X1-piiri tilalliseen prosessointiin. X1-piiri tarjoaa natiivin 3DoF-seurannan, joten näkymä pysyy paikallaan, kun käännät päätäsi, ja SDK 3.1.0:sta lähtien One-sarja tukee myös 6DoF-päänseurantaa valinnaisella XREAL Eye -kameralla laiteohjelmistopäivityksen jälkeen. Mikään tästä ei kuitenkaan tee laseista itsenäistä Android-tietokonetta.
Räätälöidyssä XREAL SDK -kehityksessä sovelluksen hoitaa liitetty Android-isäntälaite. One Pro on puettava näyttö ja seurannan päätepiste.
Mitä tarvitset tähän oppaaseen
· Windows- tai macOS-tietokone.
· XREAL Beam Pro tai jokin XREALin testaamista Samsungin lippulaivapuhelimista: Galaxy S24 Android 14:llä tai Galaxy S25 Android 15:llä. XREAL tukee vain Samsungin lippulaivamalleja ja pyytää kehittäjiä olemaan käyttämättä Android 16:een päivitettyjä puhelimia niin kauan kuin sen yhteensopivuusilmoitus on voimassa. Pääasiallisissa vaiheissa isäntälaitteena käytetään Beam Prota.
· USB-C-kaapeli One Pron liittämiseen Beam Prohon.
· Unity Hub ja tuettu Unity LTS -versio Android Build Support -tuella. (Ohjeet artikkelissa)
· Ajantasainen XREAL SDK for Unity XREALin kehittäjien lataussivulta. (Ohjeet artikkelissa)
· Android Debug Bridge (ADB) APK:n asentamiseen Beam Prolle. (Ohjeet artikkelissa)
Näin kehität ensimmäisen XREAL One Pro -sovelluksesi
Vaihe 1: Valmistele Beam Pro, laite, joka suorittaa sovelluksen
Aloita Beam Prosta, koska valmis Android-sovellus asennetaan siihen. Beam Pro on fyysinen kämmenlaite, ei mikään ladattava ohjelma.
1. Hanki XREAL Beam Pro. Osta Beam Pro -laite XREALilta tai valtuutetulta jälleenmyyjältä. Se on erillinen One Pro -laseista.
2. Käynnistä laite ja yhdistä se Wi-Fi-verkkoon. Suorita Beam Prossa tavallinen Androidin/nebulaOS:n ensikäyttöönotto.
3. Avaa MyGlasses Beam Prossa. MyGlasses on XREALin lasienhallintasovellus, jota käytetään Beam Prossa.
4. Päivitä Beam Pro ja MyGlasses, jos niin kehotetaan. SDK 3.1.0 on tarkoitettu käytettäväksi MyGlasses 1.11.0:n kanssa. XREALin julkaisutiedotteen mukaan MyGlasses päivitetään ensin ja lasit liitetään vasta sen jälkeen, jolloin lasien laiteohjelmistopäivitys käynnistyy automaattisesti. Beam Pro käyttää Android 14 -pohjaista nebulaOS:ää, joten XREALin Android 16 -varoitus koskee puhelimia eikä Beam Prota.
5. Liitä One Pro kerran Beam Prohon. Käytä lasien USB-C-kaapelia. Jos lasien laiteohjelmistopäivitys tulee näkyviin, suorita se loppuun ennen kehitystyötä.
****
Vaihe 2: Asenna Unity Hub kehitystietokoneelle
1. Avaa Unityn verkkosivusto tietokoneella. Lataa Unity Hub Windowsille tai macOS:lle.
2. Asenna ja avaa Unity Hub. Unity Hub on erillinen työpöytäohjelma, jolla Unity Editor asennetaan.
3. Kirjaudu sisään tai luo Unity-tili, jos sitä pyydetään. Näin Unity Hub pääsee editorin asennukseen ja lisensointiin
Vaihe 3: Asenna Unity Editor -versio, jossa on Android-tuki
XREAL SDK toimii Unityn sisällä, joten Unity Editor on asennettava ennen kuin SDK:n voi tuoda.
1. Avaa Unity Hub > Installs. Valitse Install Editor.
2. Valitse tuettu LTS-versio. XREAL tukee Unityn LTS-versioita 2021.3.X, 2022.3.X ja 6000.0.X. Käytä jotakin XREALin ajantasaisessa dokumentaatiossa mainittua tuettua versiota.
3. Valitse Android Build Support. XREALin vähimmäisvaatimus on Android SDK:n API-taso 31 (Android 12) tai uudempi, minkä mukana tuleva SDK kattaa.
4. Viimeistele asennus. Odota, kunnes Unity Hub näyttää editorin Installs-kohdassa.
Siirry vaiheeseen 4, kun Unity Editor on asennettu ja siihen sisältyy Android Build Support.
Vaihe 4: Lataa XREAL SDK tietokoneelle
XREAL SDK on tiedosto, joka tuodaan myöhemmin Unityyn. Älä yritä asentaa sitä Beam Prolle tai laseille.
1. Avaa XREALin Developer Download -sivu. Mene kehitystietokoneella osoitteeseen developer.xreal.com/download.
2. Etsi XREAL SDK for Unity. Hyväksy XREALin API-ehdot ja lataa ajantasainen SDK.
3. Säilytä ladattu tiedosto. Paketti toimitetaan tiedostona, jonka nimi on esimerkiksi com.xreal.xr.tar.gz.
Siirry vaiheeseen 5, kun XREAL SDK -tiedosto on tallennettu tietokoneelle. Älä avaa tar.gz-tiedostoa käsin.
Vaihe 5: Luo Unity-projekti
Luo nyt Unity Hubissa projekti, josta tulee myöhemmin Beam Prolle asennettava Android-sovellus.
1. Avaa Unity Hub > Projects. Valitse New project.
2. Valitse tavallinen 3D-pohja. Anna projektille yksinkertainen nimi, kuten XREAL-One-Pro-Test, ja valitse tallennuspaikka.
3. Luo projekti. Odota, että Unity Editor avautuu.
4. Vaihda projektin alustaksi Android. Avaa Unity Editorissa File > Build Settings. Valitse Android ja napsauta Switch Platform. Käytä Unity 6:ssa File > Build Profiles -valikkoa, jos se on näkyvissä.
Siirry vaiheeseen 6, kun Android on Unityssä aktiivinen koostealusta.
Vaihe 6: Asenna XREALin tarvitsema Unity-paketti
Pysy Unity Editorissa. Seuraavat työkalut lisätään samaan projektiin.
1. Avaa Window > Package Manager. Aseta Package Manager -ikkunassa paketin lähteeksi Unity Registry. Näin näet Unityn tarjoamat paketit.
2. Etsi XR Interaction Toolkit. Valitse se ja napsauta Install. XREAL ilmoittaa tuetuiksi versiot 2.5.x ja 3.0.x; jos Package Manager asentaa uudemman version ja esimerkki toimii virheellisesti, valitse versioluettelosta sen sijaan 3.0.x.
3. Avaa sen Samples-välilehti. Etsi Starter Assets ja napsauta Import, ja tuo sitten myös Hands Interaction Demo. XREALin vianmäärityssivun mukaan HelloMR näyttää ilman sitä puuttuvia prefabeja.
Vaihe 7: Tuo XREAL SDK samaan Unity-projektiin
Olet yhä Unityssä. Käytä nyt vaiheessa 4 ladattua XREAL SDK -tiedostoa.
1. Pysy kohdassa Window > Package Manager. Napsauta vasemmassa yläkulmassa olevaa +-painiketta. Valitse sitten ”Add package from tarball”.
2. Etsi aiemmin lataamasi XREAL SDK -tiedosto. Mene Downloads-kansioon, valitse tiedosto, jonka nimi on esimerkiksi com.xreal.xr.tar.gz, ja napsauta Open. Unity lisää nyt projektiisi XREAL XR Plugin -laajennuksen.
3. Avaa XREAL XR Plugin kohdassa Package Manager > Samples. Tuo Interaction Basics. Tämä lisää valmiin HelloMR-esimerkkikohtauksen, jolla tarkistat, että XREAL-asetukset toimivat.
Vaihe 8: Ota XREAL käyttöön projektissa
SDK on nyt mukana, mutta Unityn on vielä tiedettävä, että tämän Android-projektin tulee käyttää XREAL-laajennusta.
1. Avaa Edit > Project Settings > XR Plug-in Management. Valitse Android-välilehti.
2. Valitse XREAL. Tämä ottaa XREAL XR -palveluntarjoajan käyttöön Android-koosteessa.
3. Avaa Project Validation. Napsauta Fix All tehdäksesi kaikki tarvittavat XREAL-muutokset.
4. Avaa XR Plug-in Management > XREAL. Jos One Prossa ei ole XREAL Eye -kameraa, aseta Initial Tracking Type -asetukseksi MODE_3DOF, Initial Input Source -asetukseksi Controller (Beam Pro tai puhelin toimii 3DoF-ohjaimena) ja Support Devices -asetukseksi XREAL_DEVICE_CATEGORY_VISION, joka on XREALin luokka One-sarjan kaltaisille 3DoF-laseille. Jätä kaikki muu oletusarvoihin, kunnes esimerkki toimii.
Siirry vaiheeseen 9, kun Project Validation ei enää näytä ratkaisemattomia pakollisia XREAL-asetuksia.
Vaihe 9: Avaa XREALin HelloMR-esimerkki
Käytä XREALin esimerkkiä ennen kuin kirjoitat oman sovelluksesi. Näin varmistat, että Unity, XREAL SDK, Beam Pro ja lasit toimivat yhdessä.
1. Avaa Unityn Project-paneeli. Siirry kohtaan Assets > Samples > XREAL XR Plugin > [SDK-versiosi] > Interaction Basics.
2. Etsi HelloMR.unity. Avaa kohtaus kaksoisnapsauttamalla sitä.
3. Älä muokkaa sitä vielä. Koosta ensin muuttamaton esimerkki, niin tiedät, että kehitysympäristö toimii.
Vaihe 10: Koosta Android-APK tietokoneella
Unity muuntaa nyt HelloMR-projektin Android-sovellustiedostoksi. Tätä tiedostoa kutsutaan APK:ksi.
1. Avaa File > Build Settings tai Build Profiles. Valitse Add Open Scenes, jotta HelloMR tulee mukaan.
2. Varmista, että Android on aktiivinen. Jos se ei ole, vaihda Androidiin.
3. Napsauta Build. Määritä Player Settings -asetukset ja koosta sitten. Täytä Player Settingsissä Company Name ja Product Name (MyGlasses näyttää Product Name -nimen, joten käytä nimeä XREAL-HelloMR) ja tarkista, että Scripting Backend on IL2CPP ja kohdearkkitehtuuri ARM64; XREAL edellyttää molempia. Napsauta sitten Build, valitse tietokoneelta kansio ja tallenna tiedosto nimellä XREAL-HelloMR.apk
4. Odota, että koostaminen valmistuu. APK on nyt tietokoneella, mutta ei vielä Beam Prossa.
Mikä APK on: APK on tiedosto, jolla Android-sovellus asennetaan. Tässä työnkulussa APK asennetaan Beam Prolle eikä [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) -laseille.
Vaihe 11: Asenna APK Beam Prolle
ADB: Android Debug Bridge, tietokoneella käytettävä työkalu Android-sovellusten asentamiseen ja testaamiseen Beam Prossa tai puhelimessa.
Sovellus on koostettu. Seuraavaksi APK siirretään tietokoneelta Beam Prolle.
1. Liitä Beam Pro tietokoneeseen USB-C-kaapelilla.
2. Avaa tietokoneella Terminal tai PowerShell.
3. Ota USB-virheenkorjaus käyttöön Beam Prossa. XREALin oppaassa kehotetaan vain ottamaan isäntälaitteessa käyttöön kehittäjäasetukset ja USB-virheenkorjaus; Androidissa tämä tarkoittaa, että napautat ”Koontiversion numero” -kohtaa seitsemän kertaa ”Tietoja”-osiossa avataksesi kehittäjäasetukset ja otat sitten siellä USB-virheenkorjauksen käyttöön. Jos Beam Pro kysyy, sallitaanko USB-virheenkorjaus tästä tietokoneesta, valitse Salli.
4. Tarkista, että tietokone tunnistaa Beam Pron. Kirjoita PowerShelliin:
adb devices
Jos Beam Pro näkyy muodossa device, yhteys toimii ja voit jatkaa.
5. Asenna APK. Etsi ensin XREAL-HelloMR.apk-tiedosto tietokoneeltasi. Jos olet esimerkiksi tallentanut sen työpöydälläsi olevaan kansioon nimeltä XREAL Test, Windows-polku voi näyttää tältä:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
Kirjoita PowerShelliin:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Korvaa esimerkkipolku APK-tiedostosi todellisella sijainnilla ja paina sitten Enter-näppäintä.
6. Odota Success-ilmoitusta. Kun ADB ilmoittaa Success, sovellus on asennettu Beam Prolle.
Siirry vaiheeseen 12, kun APK:n asennus ilmoittaa tietokoneella Success.
Vaihe 12: Liitä One Pro Beam Prohon ja avaa sovellus
Android-sovellus on nyt Beam Prossa. Vasta nyt siirrät USB-C-liitännän tietokoneelta laseihin.
1. Irrota Beam Pro tietokoneesta.
2. Liitä [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) -lasit Beam Prohon. Käytä XREALin USB-C-kaapelia.
3. Avaa MyGlasses Beam Prossa. Tämä on XREAL-ympäristö, jolla hallitaan liitettyjä laseja ja käynnistetään XREALin 3D-sovelluksia.
4. Etsi sovelluksesi MyGlassesista. Se näkyy luettelossa Player Settingsin Product Name -nimellä, ei APK-tiedoston nimellä. Valitse ja avaa se. Jos sitä ei löydy tai MyGlasses ilmoittaa, ettei sovellusta tueta tässä laitteessa, avaa kehittäjätila napauttamalla MyGlassesin vasemmassa yläkulmassa olevaa lasikuvaketta kymmenen kertaa lasien ollessa irrotettuina ja valitse sovellus sitten toiminnolla 'select other MR App'.
5. Hyväksy käyttöoikeudet, jos niitä pyydetään.
6. Katso One Pro -lasien läpi. HelloMR-kohtauksen pitäisi nyt näkyä laseissa, kun Beam Pro suorittaa sovellusta.
Vaihe 13: Tee ensimmäinen pieni oma muutos
Kun muuttamaton HelloMR-esimerkki toimii, palaa Unityyn ja muuta yksi asia. Näin vältät oman koodisi virheenkorjauksen ennen kuin XREALin perusasetusten toimivuus on varmistettu.
1. Palaa Unityyn tietokoneella. Avaa HelloMR-kohtaus. Avaa Scene-välilehti. Täällä voit rakentaa käyttöliittymän ja sijoittaa objektit, jotka näkyvät XREAL One Pro -lasien kautta.
2. Lisää Cube-objekti. Valitse GameObject > 3D Object > Cube ja sijoita se noin metrin päähän kameran eteen. Tekstit, painikkeet, paneelit ja tuodut mallit lisätään myöhemmin samalla tavalla. (HelloMR:n mukana ei tule Cube-objektia; XREALin esimerkissä näkyy sen logo-objekti, joten kohdissa 6 ja 7 käytettävä Cube on luotava tässä.)
3. Valitse objekti Hierarchy-näkymästä. Muuta sen sijaintia, kokoa, kiertoa ja muita asetuksia Inspectorissa.
4. Järjestä sovelluksen asettelu. Rakenna projektin tarvitsema käyttöliittymä, esimerkiksi ohjeet, tuotemalli, tilapaneeli tai Start Inspection -painike.
5. Lisää C#-koodia vain, kun tarvitset mukautettua toimintaa. Koodia ei tarvita pelkkään objektien sijoittamiseen ja suunnitteluun. Luo skripti kansioon Assets > Scripts vain silloin, kun objektin täytyy liikkua, reagoida syötteeseen, muuttaa tietoja tai yhdistyä ulkoiseen dataan.
Esimerkiksi tämä valinnainen skripti saa objektin pyörimään:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Liitä skripti Cube-objektiin. Vedä SpinObject kansiosta Assets > Scripts Hierarchy-näkymässä olevan Cube-objektin päälle.
7. Koosta ja asenna uudelleen. Toista vaiheet 10–12. Cuben pitäisi pyöriä, kun sovellus toimii Beam Prossa ja näkyy One Pro -lasien kautta.
Mitä tämä osoittaa: Mukautetun C#-koodisi suorittaa Beam Prossa toimiva Android-sovellus. Lasit näyttävät tuloksen.
Jos haluat käyttää Android-puhelinta Beam Pron sijaan
Yleinen arkkitehtuuri on sama, mutta isäntälaitteena toimii tuettu Android-puhelin. Tällä reitillä MyGlassesia ei käytetä.
· Käytä XREALin hyväksymää puhelinta. SDK 3.1.0 mainitsee Samsung Galaxy S25:n Android 15:llä; XREALin yhteensopivuussivulla mainitaan myös Galaxy S24 Android 14:llä, ja sivun mukaan XREAL tukee vain Samsungin lippulaivamalleja. Tarkista puhelimen Android-versio ennen ostamista tai päivittämistä: XREAL pyytää kehittäjiä olemaan päivittämättä kehityslaitteita Android 16:een, ja Samsung on toimittanut Android 16:n (One UI 8) molempiin malleihin syyskuusta 2025 lähtien. Poista Samsung DeX käytöstä kehityksen ajaksi.
· Asenna APK puhelimeen Beam Pron sijaan.
· Liitä XREAL One Pro puhelimeen USB-C-kaapelilla.
· Avaa ControlGlasses, etsi asennettu XREAL-sovellus ja käynnistä se.
Älä sekoita näitä kahta reittiä: Beam Pro käyttää MyGlassesia. Tuettu Android-puhelin käyttää ControlGlassesia.
Yleisiä kehitysvirheitä
- Yritys asentaa APK laseille: Asenna se Beam Prolle tai tuetulle Android-puhelimelle.
- Luulo, että Beam Pro on sovellus: Beam Pro on erillinen fyysinen laite. MyGlasses on XREAL-sovellus, jota käytetään Beam Prossa.
- MyGlassesin käyttäminen tavallisessa Android-puhelimessa: Puhelimella kehitettäessä käytetään sen sijaan ControlGlassesia.
- Oman koodin kirjoittaminen ennen kuin HelloMR toimii: Aja ensin muokkaamaton esimerkki ja tee mukautukset vasta sitten.
- Beam Pron jättäminen kiinni tietokoneeseen, kun yrität käyttää laseja: Kun APK on asennettu, irrota Beam Pro tietokoneesta ja liitä One Pro Beam Prohon.
Yhteenveto
Kehitys XREAL One Pro -laseille alkaa järjestelmän kolmen osan erottamisesta: tietokoneella luodaan Unity-projekti, Beam Prossa tai tuetussa Android-puhelimessa Android-APK varsinaisesti toimii, ja XREAL One Pro on puettava näyttö- ja seurantalaite. Kun käytät selkeintä reittiä eli Beam Prota, valmistele ensin fyysinen Beam Pro, asenna tietokoneelle Unity Hub ja tuettu Unity Editor, lataa ja tuo XREAL SDK, ota XREAL-laajennus käyttöön, avaa HelloMR-esimerkki, koosta APK, asenna se Beam Prolle ADB:llä, irrota sitten Beam Pro tietokoneesta, liitä One Pro ja käynnistä sovellus MyGlassesin kautta. Yrityksille tämän arkkitehtuurin ymmärtäminen ennen kehityksen aloittamista auttaa määrittelemään oikean laitteisto-, tietoturva- ja käyttöönottosuunnitelman, helpottaa pilottien vianmääritystä ja estää tiimejä käyttämästä aikaa sellaiseen itsenäisten lasien malliin perustuvaan kehitykseen, jota One Pro ei käytä.
Suunnitteletko XREAL One Pro -sovellusta? Aloita yhdellä Beam Prolla, yhdellä One Prolla ja HelloMR-esimerkillä, todenna ensin isäntälaitteen ja lasien välinen työnkulku ja lisää sitten vain ne Unity-ominaisuudet, joita liiketoiminnan käyttötapaus edellyttää.