Vezetői összefoglaló
Ez az XREAL One Pro Unity SDK-útmutató bemutatja a fejlesztőknek és az üzleti csapatoknak, hogyan készíthetnek és tesztelhetnek alkalmazást az XREAL SDK 3.1.0 használatával. Az első eredmény egy Android APK, amely támogatott telefonon az XREAL Control Glasses alkalmazáson keresztül nyílik meg. Kezdje a hivatalos Hello MR mintával, majd adjon hozzá egy egyszerű üzleti utasításpanelt, ha saját munkafolyamat-tartalmat szeretne megjeleníteni.
Az első Hello MR buildhez nincs szükség egyedi kódra. Egy üzletspecifikus élményhez viszont már Unity-fejlesztési munka szükséges, amikor a csapatok saját lépéseket, vezérlőket, adatfolyamot, hitelesítést vagy backend-kapcsolatot adnak hozzá. Az XREAL One Pro csatlakoztatott kijelző, nem önálló számítógép, ezért az alkalmazást a támogatott telefon futtatja. Szélesebb körű bevezetés előtt egyeztesse belső műszaki csapatával a kompatibilitást, az engedélyeket, az adatkezelést és az eszközkezelést.
Bevezetés
Az XREAL One Pro Unity SDK-munkafolyamat gyakorlatias módja egy kéz nélkül kezelhető üzleti felület – például feladatlista, távsegítségnyújtási nézet vagy rövid munkautasítás – kipróbálásának. Tekintse meg az XREAL One Pro termékoldalát a VR Expertnél az eszköz áttekintéséért. Ez az útmutató a Unity-fejlesztési útra és azokra az ellenőrzésekre összpontosít, amelyek egy üzleti pilot előtt számítanak: támogatott gazdatelefon, a megfelelő XREAL plug-in, Android-engedélyek és egy egyértelmű első build.
Az XREAL One Pro Unity SDK követelményei
- Fejlesztési útvonal: XREAL SDK for Unity. Ez az útmutató nem tárgyalja a natív Android-, Java- vagy Kotlin-fejlesztést.
- Aktuális SDK-dokumentáció: Az ellenőrzés időpontjában a 3.1.0-s verzió. Fejlesztés vagy bevezetés előtt nézze át az XREAL legfrissebb kiadási megjegyzéseit.
- Unity-verziók a gyors útmutatóban: Unity 2021.3 LTS, 2022.3 LTS vagy Unity 6000.0 LTS, Android Build Support modullal.
- Támogatott gazdaeszköz: Az XREAL a Beam Prót vagy a támogatott Android telefonokat sorolja fel; a gyors útmutató a Samsung S24 és az azt követő csúcskategóriás sorozatokat nevezi meg. A 3.1.0-s verzió megjegyzései a Beam Prót és a Samsung S25-öt tüntetik fel tesztelten kompatibilisként.
- Követés a One Prón: Kezdje 3DoF-fel. Az XREAL SDK 3.1.0 csatlakoztatott XREAL Eye-jal és frissített szemüveg-firmware-rel 6DoF-támogatást ad a One sorozathoz.
- Telefonkapcsolat: A telefonnak USB-C DisplayPort videokimenettel és ettől független XREAL SDK gazdaeszköz-kompatibilitással kell rendelkeznie. A kijelzőkimenet önmagában nem bizonyítja az SDK-támogatást.
Mielőtt megnyitná a Unityt
· Támogatott gazdatelefon: Használjon Beam Prót vagy olyan telefont, amely az XREAL aktuális SDK-dokumentációjában kompatibilisként szerepel. A gyors útmutató jelenleg a Samsung S24 és az azt követő csúcskategóriás sorozatokat jelöli meg; a 3.1.0-s kiadási megjegyzések a Beam Prót és a Samsung S25-öt nevezik meg tesztelten kompatibilis gazdaeszközként (az XREAL az S24-et Android 14-en, az S25-öt Android 15-ön teszteli). Lehetőleg ne frissítse a telefont Android 16-ra, mivel az XREAL dokumentációjában szerepel a figyelmeztetés: „Kérjük, ne frissítse fejlesztői eszközeit Android 16-ra”, és a fejlesztés idejére kapcsolja ki a Samsung DeX-et.
· Unity: Telepítsen egy, az XREAL által felsorolt Unity LTS szerkesztőt Android Build Support modullal. Ha hiányzik, adja hozzá az Android Build Supportot a Unity Hub > Installs > (az Ön szerkesztője) > Add modules menüpontban.
· Android SDK-eszközök: Telepítse az Android SDK 12.0 (API 31) vagy újabb verzióját az Android Studio > More Actions > SDK Manager menüből, illetve egy megnyitott Android Studio-projektben a Tools > SDK Manager menüből. Ez csupán a Unityhez szükséges Android build-eszközlánc, nem natív alkalmazásfejlesztési munkafolyamat.
· SDK és futtatókörnyezet: Töltse le az XREAL SDK for Unity 3.1.0-t az XREAL fejlesztői letöltési oldaláról. A ControlGlasses 3.1.0-t az SDK 3.1.0 kiadási megjegyzésében található linkről szerezze be; a letöltési oldal még a régebbi, 1.1.0-s buildet listázza, amely az SDK 3.0.0-hoz tartozik. Tesztelés előtt nézze át az aktuális firmware-megjegyzéseket.
· SDK-feltételek és adatkezelési tájékoztató: Fejlesztés előtt olvassa el és fogadja el az XREAL APIs Terms aktuális változatát. Az XREAL előírja, hogy a fejlesztők tájékoztassanak arról, hogyan gyűjti és kezeli az SDK az adatokat az alkalmazásban, és javasolja az XREAL SDK megnevezését, valamint az adatvédelmi szabályzatára mutató link elhelyezését. Ezt a szervezete saját adatvédelmi tájékoztatója és ellenőrzési folyamata mellett tegye meg.
· Szemüvegkábel: Használjon DisplayPort-videót támogató USB-C kapcsolatot. Győződjön meg arról is, hogy a telefon SDK által támogatott gazdaeszköz, mivel ez külön ellenőrzés.
Az első XREAL One Pro alkalmazás elkészítése és futtatása
1. lépés: Android Unity-projekt létrehozása
· Nyissa meg a Unity Hubot. Válassza a Projects, majd a New project lehetőséget.
· Válasszon sablont. Válasszon egy 3D-sablont, adjon meg egy egyértelmű projektnevet, például `BusinessXREALPilot`, majd kattintson a Create project gombra.
· Váltson Androidra. A Unity Editorban nyissa meg a File > Build Settings menüt, Unity 6 esetén pedig az Android Build Profile-t. Válassza az Androidot, majd a Switch Platform lehetőséget.
Ellenőrzés: Az Android platform ki van választva, és a Unity befejezte a projekt importálását.
2. lépés: A Unity XR-csomagok telepítése
· Nyissa meg a Package Managert. A Unity Editorban válassza a Window > Package Manager menüpontot.
· Válassza a Unity Registryt. Használja a bal felső sarokban lévő csomagforrás-menüt, majd keressen rá az XR Interaction Toolkitre.
· Telepítse a toolkitet. Válassza ki az XR Interaction Toolkitet (az XREAL a 2.5.x és 3.0.x verziókat támogatja), és kattintson az Install gombra. Nyissa meg a Samples lapját, és importálja a Starter Assets és a Hands Interaction Demo mintát; az XREAL hibaelhárítási megjegyzései szerint a HelloMR a kézminta nélkül hiányzó prefabokat jelez.
· Az első build legyen kicsi. Hagyja ki az AR Foundationt. Az XREAL kompatibilitási táblázata szerint a síkkövetés, a képkövetés, a kézkövetés, a mélységháló és a térbeli horgonyok nem támogatottak az XREAL One sorozaton, sem a kamerakiegészítővel, sem anélkül; ezekhez a funkciókhoz Air 2 Ultra szükséges, így egy One Pro-prototípus nem használhatja őket.
Ellenőrzés: Az XR Interaction Toolkit megjelenik a projektben, és a Starter Assets minta importálva van.
3. lépés: Az XREAL SDK for Unity importálása
· Nyissa meg a csomagmenüt. A Package Managerben kattintson a plusz gombra, és válassza az Add package from tarball lehetőséget.
· Válassza ki az SDK-archívumot. Tallózza ki a letöltött `com.xreal.xr.tar.gz` fájlt, és kattintson az Open gombra.
· Importálja az első mintát. Válassza ki az XREAL XR Plugint a Package Managerben, nyissa meg a Samples részt, és importálja az Interaction Basics mintát. Az AR Features mintát hagyja ki: annak sík-, kép- és horgonyfunkciói nem futnak a One sorozaton.
Ellenőrzés: Az XREAL XR Plugin szerepel a Package Managerben, és az Interaction Basics importálható.
4. lépés: Az XREAL plug-in engedélyezése Androidra
· Nyissa meg a Project Settingst. Válassza az Edit > Project Settings > XR Plug in Management menüpontot.
· Válassza az Androidot. Nyissa meg az Android lapot, és jelölje be az XREAL-t.
· Alkalmazza a projektjavításokat. Ha a Project Validation figyelmeztetésekkel jelenik meg, nyissa meg, és kattintson a szükséges javítások melletti Fix All gombra. Várja meg, amíg a Unity befejezi a beállítások módosítását.
Ellenőrzés: Az Android lapon az XREAL engedélyezve van, és a szükséges validációs tételek javítva vannak.
5. lépés: A One Pro eszköztámogatás és a követés beállítása
· Nyissa meg az XREAL beállítási oldalát. A Project Settingsben válassza az XR Plug in Management > XREAL lehetőséget.
· Ellenőrizze az eszközkategóriát. A Support Devices alatt engedélyezze a Vision kategóriát az XREAL One Series szemüvegekhez.
· Válassza ki a követési módot. XREAL Eye nélküli One Pro szemüveg esetén az Initial Tracking Type értékét állítsa MODE_3DOF-ra. MODE_6DOF-ot csak akkor állítson be, ha az XREAL Eye csatlakoztatva van, és a szemüveg firmware-jét az SDK 3.1.0-ra vonatkozó előírások szerint frissítették.
· Válassza ki a prototípus bemenetét. Az Initial Input Source értékét állítsa Controllerre, hogy a támogatott Android telefon az alkalmazás vezérlőjeként működhessen. A vezérlősugár beállítása a 11. lépésben történik.
Ellenőrzés: A projekt az XREAL One Series-hez van konfigurálva, és a követési mód megfelel a csatlakoztatott hardvernek.
6. lépés: Az Android build értékeinek beállítása
· Nyissa meg a Player Settingst. Térjen vissza a File > Build Settings menühöz vagy az Android Build Profile-hoz, válassza a Player Settings lehetőséget, majd nyissa meg az Other Settings részt.
· Adjon egyedi azonosítót az alkalmazásnak. Adjon meg fordított domain formátumú Package Name-et, például `com.companyname.workflowpilot`. Éles projektben ne hagyja meg a minta azonosítóját.
· Állítsa be az alkalmazás azonosító adatait. Ugyanebben a Player Settings részben a Company Name és a Product Name mezőben adja meg szervezete és a pilot alkalmazás nevét. A Resolution and Presentation részben állítsa a Default Orientation értékét Portrait-ra, ahogyan az XREAL gyors útmutatója mutatja.
· Adja meg a grafikai beállításokat. Az XREAL gyors útmutatóját követve kapcsolja ki az Auto Graphics API-t, és használja az OpenGLES3-at.
· Állítsa be az Android API-szinteket. A Minimum API Level értékét állítsa Android 10-re vagy újabbra, a Target API Level értékét pedig Automatic (highest installed) beállításra. Az SDK Managerben telepítse az Android SDK API 31-es vagy újabb verzióját. Ezek külön beállítások: a telepített SDK-eszközök és az alkalmazás minimális verziója.
· Állítsa be az Android architektúrát. A Player Settings > Other Settings > Configuration részben engedélyezze az ARM64-et a céltelefonhoz, és ARM64-re történő buildeléskor állítsa a Scripting Backend értékét IL2CPP-re. Az XREAL dokumentálja ezt a követelményt az ARM64 buildekhez.
Ellenőrzés: A projekt a Unity buildhez szükséges csomagazonosítót és Android-beállításokat használja.
7. lépés: Az Android manifest- és engedélyellenőrzések teljesítése
· Először a generált manifestet használja. A Unity és az XREAL-csomag a build során létrehozza vagy egyesíti az Android manifest bejegyzéseit. Alapszintű mintához ne hozzon létre egyedi Android manifestet, hacsak egy XREAL-beállítás vagy egy dokumentált funkció nem igényli. A manifest-ellenőrzés feltétele, hogy a végleges alkalmazás deklarálja a funkciói által igényelt engedélyeket és alkalmazáskonfigurációt.
· Csak a szükséges engedélyeket válassza ki. A Project Settings > XR Plug in Management > XREAL részben nyissa meg az Android Permissions beállításokat. A Camera engedélyt csak kameraalapú funkcióhoz, az Audio engedélyt csak akkor, ha az alkalmazásnak hanghozzáférésre van szüksége, a Vibration engedélyt pedig csak akkor kapcsolja be, ha az alkalmazás haptikus visszajelzést használ.
· Engedélyezze a futásidejű megjelenítési engedélyt. Amikor a Control Glasses indításkor engedélyt kér, engedélyezze, hogy a Control Glasses más alkalmazások fölött jelenjen meg. Ha elvetette a kérést, nyissa meg az Android Settings > Apps > Special app access > Display over other apps > Control Glasses menüpontot, és kapcsolja be. A pontos feliratok telefononként eltérhetnek.
Ellenőrzés: Az XREAL-csomag csak a prototípus által igényelt engedélyekre van konfigurálva, és a Control Glasses indításkor megjelenhet más alkalmazások fölött.
8. lépés: A Hello MR megnyitása és a jelenet ellenőrzése
· Keresse meg az importált mintát. A Unity Project ablakában nyissa meg az Assets > Samples > XREAL XR Plugin > a telepített csomagverzió > Interaction Basics mappát.
· Nyissa meg a mintajelenetet. Kattintson duplán a `HelloMR.unity` fájlra. Ha nincs ott, térjen vissza a Window > Package Manager > XREAL XR Plugin > Samples részhez, és importálja az Interaction Basics mintát.
· Mentse a jelenetet. Válassza a File > Save menüpontot. Nézze meg a Hierarchy panelt, és győződjön meg arról, hogy a mintaobjektumok láthatók.
Ellenőrzés: A Hello MR hiányzó mintaelemek nélkül nyílik meg. Ez a minta egyedi kód nélküli kiindulási alapot ad.
9. lépés: Üzleti utasításpanel hozzáadása Unity C#-kóddal
· Döntse el, hogy ad-e hozzá kódot. A módosítatlan Hello MR minta buildeléséhez hagyja ki ezt a lépést. Akkor végezze el, ha azt szeretné, hogy a prototípus saját üzleti utasításszöveget jelenítsen meg.
· Hozzon létre egy world space Canvast. A Hierarchy panelen kattintson jobb gombbal > UI > Canvas. A Hierarchy panelen helyezze a Canvast közvetlenül a jelenet gyökerébe vagy az XR Origin alá (ne tegye közvetlenül a Main Camera gyermekévé, hogy elkerülje a merev, archoz rögzített megjelenítést). A Render Mode értékét állítsa World Space-re. A Rect Transform részben a pozíciót állítsa X 0, Y 0, Z 1.5 értékre (a felhasználó kiindulópontja elé), a forgatást 0, 0, 0-ra, a méretezést pedig minden tengelyen 0.001-re.
· Adja hozzá a feladat- és állapotszöveget. A Hierarchy panelen kattintson jobb gombbal a Canvasra > UI > Text - TextMeshPro. Ha a Unity kéri, importálja a TMP Essentials csomagot. Nevezze át az első szövegobjektumot InstructionText névre. Hozzon létre egy második Text - TextMeshPro objektumot StatusText néven. Mindkettőnek adjon jól olvasható szövegdobozt, például 900-as szélességgel, 180-as magassággal és 42-es betűmérettel. A StatusText kerüljön az utasítás alá.
· Adjon hozzá egy befejezés gombot. A Hierarchy panelen kattintson jobb gombbal a Canvasra > UI > Button - TextMeshPro. Nevezze át MarkCompleteButton névre, és a látható feliratát állítsa Mark complete-re. Ha a jelenetben nincs EventSystem, hozzon létre egyet a Hierarchy > jobb kattintás > UI > Event System útvonalon. Hozzon létre egy C# szkriptet az Assets mappában BusinessChecklistDisplay néven, és nyissa meg a Unityhez használt kódszerkesztőben.
Ellenőrzés: A jelenetben van egy world space Canvas, egy TextMeshPro szövegobjektum és egy új C#-szkriptfájl.
using TMPro; using UnityEngine; using UnityEngine.UI;
public class BusinessChecklistDisplay : MonoBehaviour { [SerializeField] private TMP_Text instructionText; [SerializeField] private TMP_Text statusText; [SerializeField] private Button completeButton;
[TextArea(2, 5)] [SerializeField] private string instruction = "Review the assigned task.\nConfirm the required item.";
private void Start() { if (instructionText == null || statusText == null || completeButton == null) { Debug.LogError("Assign the text fields and button in the Inspector.", this); return; }
instructionText.text = instruction; statusText.text = "Status: Not complete"; completeButton.onClick.AddListener(MarkComplete); }
private void MarkComplete() { statusText.text = "Status: Complete (local demo)"; completeButton.interactable = false; }
private void OnDestroy() { if (completeButton != null) completeButton.onClick.RemoveListener(MarkComplete); } }
Fejlesztési hatókör: Ez a kód utasításokat jelenít meg, és a gomb kiválasztásakor helyben módosítja az állapotot. Nem ment feladatot vállalati rendszerbe, nem hitelesíti a felhasználót, és nem küld adatot hálózaton keresztül. Ezekhez a funkciókhoz olyan alkalmazáskód kell, amely illeszkedik a szervezete API-, identitás- és adatkezelési kialakításához. Ne helyezzen hitelesítő adatokat vagy valós üzleti rekordokat az APK-ba.
10. lépés: A szkript összekapcsolása az utasításpanellel
· Várja meg, amíg a Unity lefordítja a kódot. Mentse a szkriptet a kódszerkesztőben, térjen vissza a Unitybe, és várja meg, amíg a fordítást jelző ikon eltűnik.
· Csatolja a szkriptet. Húzza a `BusinessChecklistDisplay` szkriptet a Project ablakból a Hierarchy panelen lévő Canvasra.
· Rendelje hozzá a UI-mezőket. Jelölje ki a Canvast. Az Inspectorban keresse meg a Business Checklist Display komponenst. Húzza az InstructionText és a StatusText objektumot a Hierarchy panelről a megfelelő mezőkbe, majd húzza a MarkCompleteButton objektumot a Complete Button mezőbe.
· Adja meg a mintaértékeket. Ugyanebben az Inspector-komponensben cserélje le az Instruction mező tartalmát jóváhagyott, nem bizalmas demószövegre. Mentse a jelenetet. A gomb kiválasztás után a StatusText szövegét „Complete (local demo)” értékre változtatja; valós üzleti eredményt nem küld el és nem tárol.
Ellenőrzés: Az Inspector mindkét szövegmezőt és a gombot hozzárendelve mutatja, és az állapotszöveg megváltozik, amikor a Unity Editorban kiválasztja a Mark complete gombot.
11. lépés: Vezérlős kiválasztás konfigurálása a felhasználói felülethez
· Állítsa be az EventSystem bemeneti modulját. Jelölje ki az EventSystemet a Hierarchy panelen. Ha jelen van, távolítsa el a Standalone Input Module-t, majd az Add Component segítségével adja hozzá az XR UI Input Module-t. Ha elérhető az XRI Starter Assets preset, alkalmazza az XRI Default XR UI Input Module presetet, hogy a modul a várt bemeneti műveletekkel rendelkezzen.
· Állítsa be a Canvas raycasterét. Jelölje ki a Canvast. Távolítsa el a Graphic Raycastert, és adja hozzá a Tracked Device Graphic Raycastert. Ez lehetővé teszi, hogy egy XR által követett sugár célba vegye a gombot.
· Engedélyezze a UI-interakciót a vezérlősugáron. Az XR Originben jelölje ki azt a vezérlőobjektumot, amelyen XR Ray Interactor található. A UI Interaction részben engedélyezze az Interaction with UI GameObjects opciót. Az XREAL Initial Input Source maradjon az 5. lépésben beállított Controller értéken.
· Ellenőrizze a vezérlési útvonalat. Az Interaction Basics mintának biztosítania kell a vezérlőobjektumokat és a bemeneti műveleteket. Ha az XR Originben nincs XR Ray Interactor, buildelés előtt importálja az XRI Starter Assets mintát, és használja annak XR Origin/vezérlő beállítását.
Ellenőrzés: A Unity Editorban a vezérlősugár kiemeli a Mark complete gombot, és a kiválasztása megváltoztatja az állapotszöveget. Mielőtt a folyamatot pilotban használná, ismételje meg ezt a tesztet a támogatott telefonon és szemüvegen.
12. lépés (opcionális): A feladat befejezésének összekapcsolása egy üzleti API-val
Üzleti API-fogalmak a kódolás előtt
· REST API: Webcím és egyeztetett kérésformátum, amelyek lehetővé teszik, hogy az alkalmazás adatot cseréljen egy vállalati szolgáltatással.
· Hozzáférési token: Jóváhagyott bejelentkezés után kiadott, rövid élettartamú hitelesítő adat; az alkalmazás ezt küldi el annak igazolására, hogy a felhasználó jogosult a műveletre.
· Idempotenciakulcs: Egyedi kérésazonosító, amely alapján a szerver felismeri az újrapróbálkozást, és elkerüli, hogy ugyanazt a befejezést kétszer mentse.
· HTTPS: Titkosított hálózati kommunikáció, amely védi az adatokat, miközben a telefon és a szerver között továbbítódnak.
· Először rögzítse a vállalati API-szerződést. Kérje el a platformcsapatától a HTTPS-végpontot, az elfogadott JSON-mezőket, a felhasználói identitás forrását, a hozzáférési token kiállítóját, a sikeres válasz formátumát és az újrapróbálkozási szabályokat. Az alábbi példa a taskId, operatorId, requestId és completedAtUtc mezőket küldi el; használat előtt feleltesse meg ezeket a vállalati API-nak. A szervezete által jóváhagyott átlátszatlan azonosítókat használjon, ne neveket vagy érzékeny rekordokat.
· Engedélyezze a hálózati hozzáférést ehhez a buildhez. Az alkalmazás API-s változatához nyissa meg az Edit > Project Settings > Player > Android > Other Settings > Configuration részt, és az Internet Access értékét állítsa Require-ra. Buildelje újra az alkalmazást, és vizsgálja meg az egyesített manifestet, hogy meggyőződjön az android.permission.INTERNET jelenlétéről. Ez az engedély nem jelenít meg Android-engedélykérést.
· Adjon hozzá egy összekötő szkriptet. A Unityben hozza létre a `BusinessTaskApi.cs` fájlt, illessze be sorrendben mindkét egymást követő kódblokkot ugyanabba a fájlba, majd mentse. A második blokk a SubmitCompletion metóduson belül folytatódik. A végpont csak helyőrző; cserélje le a jóváhagyott vállalati végpontra. A hozzáférési token ne kerüljön az Inspectorba, a forráskódba, az APK-ba és a naplókba.
using System; using System.Collections; using System.Text; using UnityEngine; using UnityEngine.Networking;
[Serializable] public class TaskCompletionPayload { public string taskId; public string operatorId; public string requestId; public string completedAtUtc; }
public class BusinessTaskApi : MonoBehaviour { [SerializeField] private string completionEndpoint = "https://api.example.com/v1/task-completions";
public IEnumerator SubmitCompletion( string taskId, string operatorId, string accessToken, string requestId, Action<bool, string> onComplete) { if (string.IsNullOrWhiteSpace(taskId) || string.IsNullOrWhiteSpace(operatorId) || string.IsNullOrWhiteSpace(accessToken) || string.IsNullOrWhiteSpace(requestId)) { onComplete?.Invoke(false, "Missing task, user, token, or request ID."); yield break; }
if (!Uri.TryCreate(completionEndpoint, UriKind.Absolute, out Uri endpoint) || endpoint.Scheme != Uri.UriSchemeHttps) { onComplete?.Invoke(false, "Use the approved HTTPS API endpoint."); yield break; }
var payload = new TaskCompletionPayload { taskId = taskId, operatorId = operatorId, requestId = requestId, completedAtUtc = DateTime.UtcNow.ToString("o") }; byte[] body = Encoding.UTF8.GetBytes(JsonUtility.ToJson(payload));
using (var request = new UnityWebRequest(completionEndpoint, "POST")) { request.uploadHandler = new UploadHandlerRaw(body); request.downloadHandler = new DownloadHandlerBuffer(); request.timeout = 20; request.SetRequestHeader("Content-Type", "application/json"); request.SetRequestHeader("Authorization", "Bearer " + accessToken); request.SetRequestHeader("Idempotency-Key", requestId);
yield return request.SendWebRequest();
bool accepted = request.result == UnityWebRequest.Result.Success && request.responseCode >= 200 && request.responseCode < 300; string message = accepted ? "Completion accepted by the business system." : "Request failed (HTTP " + request.responseCode + "). " + request.error; onComplete?.Invoke(accepted, message); } } }
· Hívja meg az összekötőt a gombról. Adjon hozzá egy `BusinessTaskApi` komponenst a Canvashoz, és rendelje hozzá a `BusinessChecklistDisplay` `taskApi` mezőjéhez. Cserélje le a csak helyben működő `MarkComplete` metódust egy korutinhívásra, miután a vállalati identitás-SDK érvényes hozzáférési tokent ad, és az üzleti rendszer megadja a feladat- és operátorazonosítókat:
· Kösse be a hitelesített műveletet. A meglévő BusinessChecklistDisplay szkriptben a gomb jelenleg a helyi MarkComplete metódust hívja. Éles használathoz módosítsa ezt a kezelőt úgy, hogy a jóváhagyott vállalati bejelentkezési folyamat szerezzen hozzáférési tokent, és hívja meg a SubmitToBusinessSystem(token) metódust. Ne adjon hozzá felhasználónév/jelszó űrlapot, és ne tároljon tokent a jelenetben.
// Fields to add to BusinessChecklistDisplay: [SerializeField] private BusinessTaskApi taskApi; [SerializeField] private string taskId; // Set from your approved task source. [SerializeField] private string operatorId; // Set from your approved identity source. // Call this after obtaining a short-lived token from the company identity SDK. private void SubmitToBusinessSystem(string accessToken) { string requestId = System.Guid.NewGuid().ToString("N"); StartCoroutine(taskApi.SubmitCompletion( taskId, operatorId, accessToken, requestId, HandleCompletionResult)); } private void HandleCompletionResult(bool accepted, string message) { statusText.text = accepted ? "Status: Submitted" : "Status: Not submitted"; Debug.Log(message); // Do not log tokens or sensitive business data. }
Fontos: Az `accessToken` értékének futásidőben a jóváhagyott bejelentkezési szolgáltatótól kell származnia. A fenti függvénynév egy átadási pont, nem teljes identitáskezelési megvalósítás. Konfigurálja az API-oldali jogosultságkezelést a feladatra és a felhasználóra, ellenőrizzen minden mezőt a szerveren, újrapróbálkozáskor használjon állandó kérésazonosítót, és ne tiltsa le a gombot, amíg a szerver el nem fogadja a kérést. Éles használat előtt igazítsa az összekötőt az API válaszsémájához és a Unity-verziójához.
Ellenőrzés: Tesztkörnyezetben ellenőrizze, hogy a rendszer elfogadja a jogosult kérést, elutasítja a lejárt vagy jogosulatlan tokent, időtúllépés esetén a feladat láthatóan beküldetlen marad, és az azonos kérésazonosítóval történő újrapróbálkozás nem hoz létre duplikátumot.
13. lépés: A Hello MR jelenet hozzáadása az Android buildhez
· Nyissa meg a build ablakot. Válassza a File > Build Settings menüpontot. A Scenes In Build részben kattintson az Add Open Scenes gombra, és ellenőrizze, hogy a HelloMR szerepel a listában és be van jelölve.
· Unity 6 esetén. Nyissa meg az aktív Android Build Profile-t, és adja hozzá a jelenleg megnyitott HelloMR jelenetet a jelenetlistájához.
Ellenőrzés: Az Android build tartalmazza az imént tesztelt és testre szabott jelenetet.
14. lépés: Az első APK elkészítése
· Ellenőrizze, hogy az Android az aktív platform. Ellenőrizze a kiválasztott platformot a Build Settingsben vagy az Android Build Profile-ban.
· Készítse el az alkalmazást. Kattintson a Build gombra, válasszon kimeneti mappát, és nevezze el a fájlt `BusinessXREALPilot.apk` néven.
· Vizsgálja meg a végleges manifestet. Nyissa meg az Android Studiót, válassza a Build > Analyze APK menüpontot, majd jelölje ki a BusinessXREALPilot.apk fájlt. Az AndroidManifest.xml fájlban ellenőrizze a csomagnevet, és győződjön meg arról, hogy a deklarált engedélyek megfelelnek a pilot funkcióinak. A kész APK-t ellenőrizze, mert az tartalmazza azt az egyesített manifestet, amelyet a Unity telepíteni fog.
· Őrizzen meg egy verziózott tesztpéldányt. Üzleti pilot esetén tárolja az APK-t a Unity-verzióval, az XREAL SDK verziójával, a telefon típusával és a teszt dátumával együtt, hogy a csapat ugyanazt a buildet megismételhesse.
Ellenőrzés: A Unity buildhibák nélkül létrehozza az APK-t, és a feloldott manifestet telepítés előtt átnézték.
15. lépés: Az APK telepítése támogatott Android telefonra
· Csatlakoztassa a telefont a számítógéphez. Használjon USB-t, vagy állítsa be a vezeték nélküli ADB-t. Kábeles telepítés esetén engedélyezze a telefonon a Fejlesztői beállításokat és az USB-hibakeresést.
· Telepítse az APK-t. Használja a Unity Build and Run funkcióját, vagy futtassa az `adb install -r BusinessXREALPilot.apk` parancsot egy olyan terminálból, ahol az ADB elérhető.
· Fogadja el az Android kéréseit. Erősítse meg a telefonon a telepítési és hibakeresési kéréseket. Az APK azon a támogatott telefonon legyen, amelyet a szemüveggel használni tervez.
Ellenőrzés: Az új Unity-alkalmazás megjelenik a telefon alkalmazáslistájában.
16. lépés: Az üzleti alkalmazás indítása a Control Glassesen keresztül
· Csatlakoztassa a szemüveget. Válassza le a telefont a fejlesztői számítógépről, és csatlakoztassa az XREAL One Pro szemüveget a telefon USB-C DisplayPort-kimenetéhez.
· Nyissa meg a futtatókörnyezeti alkalmazást. A telefonon nyissa meg a Control Glasses alkalmazást. Keresse meg a `BusinessXREALPilot` alkalmazást a listájában, és koppintson rá. A Beam Pro ehelyett a MyGlasses alkalmazást használja.
· Adja meg a kért hozzáféréseket. Ha az Android kéri, engedélyezze, hogy a Control Glasses más alkalmazások fölött jelenjen meg. A Camera, Audio vagy Vibration engedélyt csak akkor adja meg, ha a Unity-alkalmazás használja ezeket a funkciókat, és kéri a megfelelő engedélyt.
· Ellenőrizze az eredményt. Győződjön meg arról, hogy a Hello MR és az opcionális üzleti utasításpanel látható a szemüvegben. Óvatosan fordítsa el a fejét, és ellenőrizze, hogy a nézet a várt 3DoF mód szerint követi-e a mozgást.
Ellenőrzés: Az alkalmazás a támogatott telefonon fut, és a képe megjelenik az XREAL One Pro szemüvegben.
Üzleti pilot ellenőrzései a szélesebb körű használat előtt
· Teszteljen jóváhagyott mintatartalommal. A korai prototípusokban ne használjon személyes, ügyfél- és bizalmas adatokat.
· Ellenőrizze a pontos telefon- és firmware-kombinációt. Ne feltételezze, hogy egy USB-C videokapcsolat XREAL SDK-kompatibilitást jelent.
· Ellenőrizze a bemenetet és az olvashatóságot. Ellenőrizze a betűméretet, a kontrasztot, az elhelyezést és a szükséges műveletek számát a szemüveg viselése közben.
· Tekintse át a vállalati követelményeket. A szélesebb körű használat előtt ellenőrizze a hitelesítést, az adattárolást, a hálózati hozzáférést, a frissítések terjesztését, az eszközkezelést és az alkalmazandó adatvédelmi követelményeket, például a GDPR-t.
· Tartsa reálisan az alkalmazás hatókörét. Ez a projekt azt bizonyítja, hogy egy Unity-alkalmazás futtatható az adott konfiguráción. Önmagában nem bizonyítja az éles használatra való alkalmasságot, a biztonsági tanúsítást vagy az összes Android telefon támogatását.
Összegzés
Egy üzleti célú XREAL One Pro prototípus a Unityben indul, az aktuális XREAL SDK-val, egy támogatott Android gazdaeszközzel, az XREAL plug-innel és az eszközbeállításokkal, valamint a megfelelő manifest- és futásidejű engedélyekkel. A Hello MR jelenet kód nélküli első buildet biztosít, egy kis Unity C#-komponens pedig egyszerű üzleti utasításpanellel bővítheti, mielőtt a csapat elkészíti és telepíti az APK-t. Indítsa el az alkalmazást a Control Glassesen keresztül, és tesztelje pontosan azzal a telefonnal, firmware-rel, tartalommal és munkafolyamattal, amelyet a pilothoz terveznek. Ez a folyamat segít a vállalatoknak felmérni, hogy a kéz nélkül használható térbeli szoftver megfelel-e az igényeiknek, korán azonosítani a műszaki és adatvédelmi követelményeket, és megalapozottabb döntéseket hozni, mielőtt szélesebb körű bevezetésbe fektetnének.
Tekintse meg az XREAL One Pro termékoldalát a termék részleteiért, majd vegye fel a kapcsolatot a VR Experttel, hogy megbeszéljék, megfelel-e az eszköz és a szoftveres konfiguráció szervezete fejlesztési és pilotkövetelményeinek.
Javasolt kapcsolódó link: XREAL One Pro értékelés szakembereknek

























