Streszczenie
XREAL One Pro nie uruchamia samodzielnie niestandardowej aplikacji. Aplikację tworzy się w Unity na komputerze, instaluje jako plik APK systemu Android na XREAL Beam Pro lub innym obsługiwanym urządzeniu hosta z Androidem, a następnie wyświetla w okularach One Pro. Ten model z urządzeniem hosta to najważniejsza rzecz, którą programiści muszą zrozumieć przed rozpoczęciem pracy.
Konfiguracja przebiega według jasnego schematu: przygotuj Beam Pro, zainstaluj Unity z obsługą Androida, dodaj XREAL SDK, otwórz i przetestuj przykład HelloMR, zbuduj APK, zainstaluj go na Beam Pro za pomocą ADB, podłącz One Pro i uruchom aplikację przez MyGlasses. Dla firm taka architektura ułatwia tworzenie i testowanie niestandardowych procesów XREAL przy użyciu znanych narzędzi Androida i Unity, a jednocześnie logika aplikacji pozostaje na osobnym urządzeniu hosta, którym można zarządzać, które można aktualizować i integrować z istniejącymi systemami firmy.
Błąd, którego należy unikać: nie planuj projektu, w którym APK instaluje się bezpośrednio na [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro). APK instaluje się na urządzeniu hosta z Androidem.
Czym jest XREAL One Pro?
XREAL One Pro to przewodowy wyświetlacz AR z polem widzenia 57 stopni, wyświetlaczami Sony Micro-OLED i układem przetwarzania przestrzennego X1 firmy XREAL. Układ X1 zapewnia natywne 3DoF, dzięki czemu ekran pozostaje na miejscu, gdy obracasz głowę, a od wersji SDK 3.1.0 seria One obsługuje także śledzenie ruchów głowy w 6DoF z opcjonalną kamerą XREAL Eye po aktualizacji oprogramowania układowego. Nic z tego nie czyni jednak okularów samodzielnym komputerem z Androidem.
Przy tworzeniu niestandardowych aplikacji z XREAL SDK aplikację obsługuje podłączony host z Androidem. One Pro pełni rolę noszonego wyświetlacza i punktu końcowego śledzenia.
Czego potrzebujesz do tego przewodnika
· Komputer z systemem Windows lub macOS.
· XREAL Beam Pro lub flagowy telefon Samsung przetestowany przez XREAL: Galaxy S24 z Androidem 14 albo Galaxy S25 z Androidem 15. XREAL obsługuje wyłącznie flagowe modele Samsunga i prosi programistów, aby nie używali telefonów zaktualizowanych do Androida 16, dopóki obowiązuje jego komunikat o zgodności. W głównych krokach jako host wykorzystywany jest Beam Pro.
· Kabel USB-C do podłączenia One Pro do Beam Pro.
· Unity Hub i obsługiwana wersja Unity LTS z modułem Android Build Support. (Instrukcja w artykule)
· Aktualna wersja XREAL SDK dla Unity ze strony pobierania dla programistów XREAL. (Instrukcja w artykule)
· Android Debug Bridge (ADB) do instalacji APK na Beam Pro. (Instrukcja w artykule)
Jak stworzyć pierwszą aplikację dla XREAL One Pro
Krok 1: Przygotuj Beam Pro, czyli urządzenie, na którym będzie działać aplikacja
Zacznij od Beam Pro, ponieważ to na nim zostanie zainstalowana gotowa aplikacja na Androida. Beam Pro to fizyczne urządzenie przenośne, a nie coś, co się pobiera.
1. Zdobądź XREAL Beam Pro. Kup urządzenie Beam Pro od XREAL lub autoryzowanego sprzedawcy. Jest to sprzęt oddzielny od okularów One Pro.
2. Włącz urządzenie i połącz je z siecią Wi-Fi. Przeprowadź na Beam Pro standardową wstępną konfigurację Androida/nebulaOS.
3. Otwórz MyGlasses na Beam Pro. MyGlasses to aplikacja XREAL do zarządzania okularami, używana na Beam Pro.
4. Zaktualizuj Beam Pro i MyGlasses, jeśli pojawi się monit. SDK 3.1.0 współpracuje z MyGlasses 1.11.0. Według informacji o wydaniu XREAL należy najpierw zaktualizować MyGlasses, a następnie podłączyć okulary, co automatycznie uruchamia aktualizację ich oprogramowania układowego. Beam Pro działa pod kontrolą nebulaOS opartego na Androidzie 14, więc ostrzeżenie XREAL dotyczące Androida 16 odnosi się do telefonów, a nie do Beam Pro.
5. Podłącz One Pro do Beam Pro jeden raz. Użyj kabla USB-C okularów. Jeśli pojawi się aktualizacja oprogramowania układowego okularów, dokończ ją przed rozpoczęciem prac programistycznych.
****
Krok 2: Zainstaluj Unity Hub na komputerze programistycznym
1. Otwórz stronę Unity na komputerze. Pobierz Unity Hub dla systemu Windows lub macOS.
2. Zainstaluj i otwórz Unity Hub. Unity Hub to osobny program komputerowy służący do instalacji Unity Editor.
3. Zaloguj się lub utwórz konto Unity, jeśli pojawi się taka prośba. Dzięki temu Unity Hub uzyska dostęp do procesu instalacji edytora i licencjonowania
Krok 3: Zainstaluj wersję Unity Editor z obsługą Androida
XREAL SDK działa w Unity, dlatego Unity Editor musi być zainstalowany, zanim będzie można zaimportować SDK.
1. Otwórz Unity Hub > Installs. Wybierz Install Editor.
2. Wybierz obsługiwaną wersję LTS. XREAL obsługuje Unity 2021.3.X, 2022.3.X i 6000.0.X LTS. Użyj obsługiwanej wersji wymienionej w aktualnej dokumentacji XREAL.
3. Zaznacz Android Build Support. Minimalne wymaganie XREAL to Android SDK z poziomem API 31 (Android 12) lub nowszym, co zapewnia dołączony SDK.
4. Dokończ instalację. Poczekaj, aż Unity Hub wyświetli edytor w sekcji Installs.
Przejdź do kroku 4, gdy: Unity Editor jest zainstalowany wraz z Android Build Support.
Krok 4: Pobierz XREAL SDK na komputer
XREAL SDK to plik, który później importuje się do Unity. Nie próbuj instalować go na Beam Pro ani w okularach.
1. Otwórz stronę XREAL Developer Download. Na komputerze programistycznym przejdź do developer.xreal.com/download.
2. Znajdź XREAL SDK for Unity. Zaakceptuj warunki API XREAL i pobierz aktualny SDK.
3. Zachowaj pobrany plik. Pakiet jest dostarczany jako plik, np. com.xreal.xr.tar.gz.
Przejdź do kroku 5, gdy: plik XREAL SDK jest zapisany na komputerze. Nie otwieraj ręcznie pliku tar.gz.
Krok 5: Utwórz projekt Unity
Teraz użyj Unity Hub, aby utworzyć projekt, który później stanie się aplikacją na Androida instalowaną na Beam Pro.
1. Otwórz Unity Hub > Projects. Wybierz New project.
2. Wybierz zwykły szablon 3D. Nadaj projektowi prostą nazwę, np. XREAL-One-Pro-Test, i wybierz miejsce zapisu.
3. Utwórz projekt. Poczekaj, aż otworzy się Unity Editor.
4. Przełącz projekt na Androida. W Unity Editor otwórz File > Build Settings. Wybierz Android i kliknij Switch Platform. W Unity 6 użyj File > Build Profiles, jeśli wyświetlane jest to menu.
Przejdź do kroku 6, gdy: Android jest aktywną platformą kompilacji w Unity.
Krok 6: Zainstaluj pakiet Unity wymagany przez XREAL
Pozostań w Unity Editor. Kolejne narzędzia dodaje się do tego samego projektu.
1. Otwórz Window > Package Manager. W oknie Package Manager ustaw źródło pakietów na Unity Registry. Wyświetlą się wtedy pakiety udostępniane przez Unity.
2. Znajdź XR Interaction Toolkit. Zaznacz go i kliknij Install. XREAL podaje jako obsługiwane wersje 2.5.x i 3.0.x; jeśli Package Manager zainstaluje nowszą, a przykład będzie działał nieprawidłowo, wybierz zamiast niej wersję 3.0.x z listy wersji.
3. Otwórz jego kartę Samples. Znajdź Starter Assets i kliknij Import, a następnie zaimportuj również Hands Interaction Demo. Według strony rozwiązywania problemów XREAL bez niego w HelloMR pojawiają się brakujące prefaby.
Krok 7: Zaimportuj XREAL SDK do tego samego projektu Unity
Nadal pracujesz w Unity. Teraz użyj pliku XREAL SDK pobranego w kroku 4.
1. Pozostań w Window > Package Manager. Kliknij przycisk + w lewym górnym obszarze. Następnie wybierz „Add package from tarball”.
2. Znajdź pobrany wcześniej plik XREAL SDK. Przejdź do folderu Pobrane, zaznacz plik o nazwie podobnej do com.xreal.xr.tar.gz i kliknij Otwórz. Unity doda teraz XREAL XR Plugin do projektu.
3. Otwórz XREAL XR Plugin w Package Manager > Samples. Zaimportuj Interaction Basics. Spowoduje to dodanie gotowej przykładowej sceny HelloMR, której użyjesz, aby sprawdzić, czy konfiguracja XREAL działa.
Krok 8: Włącz XREAL w projekcie
SDK jest już dostępny, ale Unity nadal musi wiedzieć, że ten projekt na Androida ma korzystać z wtyczki XREAL.
1. Otwórz Edit > Project Settings > XR Plug-in Management. Wybierz kartę Android.
2. Zaznacz XREAL. Włącza to dostawcę XREAL XR dla kompilacji na Androida.
3. Otwórz Project Validation. Kliknij Fix All dla wszystkich wymaganych zmian XREAL.
4. Otwórz XR Plug-in Management > XREAL. W przypadku One Pro bez XREAL Eye ustaw Initial Tracking Type na MODE_3DOF, Initial Input Source na Controller (Beam Pro lub telefon działa jako kontroler 3DoF), a Support Devices na XREAL_DEVICE_CATEGORY_VISION, czyli kategorię XREAL dla okularów 3DoF, takich jak seria One. Wszystkie pozostałe ustawienia zostaw domyślne, dopóki przykład nie zacznie działać.
Przejdź do kroku 9, gdy: Project Validation nie wyświetla już nierozwiązanych wymaganych ustawień XREAL.
Krok 9: Otwórz przykład HelloMR od XREAL
Zanim napiszesz własną aplikację, użyj przykładu XREAL. Potwierdza on, że Unity, XREAL SDK, Beam Pro i okulary mogą ze sobą współpracować.
1. Otwórz panel Project w Unity. Przejdź do Assets > Samples > XREAL XR Plugin > [twoja wersja SDK] > Interaction Basics.
2. Znajdź HelloMR.unity. Kliknij dwukrotnie scenę, aby ją otworzyć.
3. Na razie jej nie modyfikuj. Najpierw zbuduj niezmieniony przykład, aby mieć pewność, że środowisko programistyczne działa.
Krok 10: Zbuduj plik APK na Androida na komputerze
Unity przekształca teraz projekt HelloMR w plik aplikacji na Androida. Taki plik nazywa się APK.
1. Otwórz File > Build Settings lub Build Profiles. Wybierz Add Open Scenes, aby uwzględnić HelloMR.
2. Sprawdź, czy Android jest aktywny. Jeśli nie jest, przełącz na Androida.
3. Kliknij Build. Skonfiguruj Player Settings, a następnie zbuduj aplikację. W Player Settings wypełnij pola Company Name i Product Name (MyGlasses wyświetla Product Name, więc użyj XREAL-HelloMR) i sprawdź, czy Scripting Backend ma wartość IL2CPP, a docelową architekturą jest ARM64; XREAL wymaga obu tych ustawień. Następnie kliknij Build, wybierz folder na komputerze i zapisz plik jako XREAL-HelloMR.apk
4. Poczekaj na zakończenie kompilacji. Plik APK znajduje się teraz na komputerze, ale jeszcze nie na Beam Pro.
Czym jest APK: APK to plik służący do instalowania aplikacji na Androida. W tym procesie APK trafia na Beam Pro, a nie na [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro).
Krok 11: Zainstaluj APK na Beam Pro
ADB: Android Debug Bridge, narzędzie komputerowe służące do instalowania i testowania aplikacji na Androida na Beam Pro lub telefonie.
Aplikacja jest zbudowana. W kolejnym kroku przeniesiesz plik APK z komputera na Beam Pro.
1. Podłącz Beam Pro do komputera kablem USB-C.
2. Otwórz Terminal lub PowerShell na komputerze.
3. Włącz debugowanie USB na Beam Pro. Przewodnik XREAL mówi jedynie, aby włączyć na hoście Opcje programisty i debugowanie USB; w Androidzie oznacza to siedmiokrotne stuknięcie „Numer kompilacji” w sekcji „Informacje”, aby odblokować Opcje programisty, a następnie włączenie tam debugowania USB. Jeśli Beam Pro wyświetli komunikat z pytaniem, czy zezwolić na debugowanie USB z tego komputera, wybierz Zezwól.
4. Sprawdź, czy komputer widzi Beam Pro. W PowerShell wpisz:
adb devices
Beam Pro widoczny jako device oznacza, że połączenie działa i możesz kontynuować.
5. Zainstaluj APK. Najpierw znajdź plik XREAL-HelloMR.apk na komputerze. Jeśli na przykład zapisano go w folderze o nazwie XREAL Test na pulpicie, ścieżka w systemie Windows może wyglądać tak:
C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk
W PowerShell wpisz:
adb install -r "C:\Users\YourName\Desktop\XREAL Test\XREAL-HelloMR.apk"
Zastąp przykładową ścieżkę rzeczywistą lokalizacją pliku APK, a następnie naciśnij Enter.
6. Poczekaj na komunikat Success. Gdy ADB zgłosi Success, aplikacja jest zainstalowana na Beam Pro.
Przejdź do kroku 12, gdy: instalacja APK zgłosi Success na komputerze.:
Krok 12: Podłącz One Pro do Beam Pro i otwórz aplikację
Aplikacja na Androida jest już na Beam Pro. Dopiero teraz przełączasz połączenie USB-C z komputera na okulary.
1. Odłącz Beam Pro od komputera.
2. Podłącz [XREAL One Pro](https://ai.vr-expert.com/en/ai-glasses/xreal-one-pro) do Beam Pro. Użyj kabla USB-C XREAL.
3. Otwórz MyGlasses na Beam Pro. Jest to środowisko XREAL służące do zarządzania podłączonymi okularami i uruchamiania aplikacji 3D XREAL.
4. Znajdź swoją aplikację w MyGlasses. Jest wyświetlana pod nazwą Product Name z Player Settings, a nie pod nazwą pliku APK. Zaznacz ją i otwórz. Jeśli jej brakuje lub MyGlasses informuje, że aplikacja nie jest obsługiwana na tym urządzeniu, stuknij dziesięć razy ikonę okularów w lewym górnym rogu MyGlasses przy odłączonych okularach, aby otworzyć tryb programisty, a następnie użyj opcji „select other MR App”, aby ją wybrać.
5. Zatwierdź uprawnienia, jeśli pojawi się prośba.
6. Spójrz przez One Pro. Scena HelloMR powinna teraz pojawić się w okularach, podczas gdy aplikacja działa na Beam Pro.
Krok 13: Wprowadź pierwszą drobną własną zmianę
Gdy niezmieniony przykład HelloMR zadziała, wróć do Unity i zmień jedną rzecz. Dzięki temu unikniesz debugowania własnego kodu, zanim potwierdzisz, że podstawowa konfiguracja XREAL działa.
1. Wróć do Unity na komputerze. Otwórz scenę HelloMR. Otwórz kartę Scene. To tutaj możesz zbudować interfejs i rozmieścić obiekty, które będą widoczne w XREAL One Pro.
2. Dodaj obiekt Cube. Wybierz GameObject > 3D Object > Cube i umieść go około metra przed kamerą. Tekst, przyciski, panele i zaimportowane modele dodaje się później w ten sam sposób. (HelloMR nie zawiera obiektu Cube; przykład XREAL pokazuje obiekt z logo, więc Cube używany w punktach 6 i 7 trzeba utworzyć tutaj.)
3. Zaznacz obiekt w panelu Hierarchy. Za pomocą panelu Inspector zmień jego położenie, rozmiar, obrót i inne ustawienia.
4. Rozmieść elementy układu aplikacji. Zbuduj interfejs potrzebny w projekcie, np. instrukcje, model produktu, panel stanu lub przycisk Start Inspection.
5. Dodawaj kod C# tylko wtedy, gdy potrzebne jest niestandardowe zachowanie. Kod nie jest wymagany do samego rozmieszczania i projektowania obiektów. Utwórz skrypt w Assets > Scripts tylko wtedy, gdy obiekt ma się poruszać, reagować na dane wejściowe, zmieniać informacje lub łączyć się z danymi zewnętrznymi.
Na przykład ten opcjonalny skrypt sprawia, że obiekt się obraca:
using UnityEngine;
public class SpinObject : MonoBehaviour
{
public float speed = 30f;
void Update()
{
transform.Rotate(0f, speed * Time.deltaTime, 0f);
}
}
6. Przypisz skrypt do obiektu Cube. Przeciągnij SpinObject z Assets > Scripts na obiekt Cube w panelu Hierarchy.
7. Ponownie zbuduj i zainstaluj aplikację. Powtórz kroki od 10 do 12. Cube powinien się obracać, gdy aplikacja działa na Beam Pro i jest wyświetlana w One Pro.
Co to pokazuje: Twój własny kod C# jest wykonywany przez aplikację na Androida na Beam Pro. Okulary wyświetlają wynik.
Jeśli chcesz użyć telefonu z Androidem zamiast Beam Pro
Ogólna architektura pozostaje taka sama, ale hostem staje się obsługiwany telefon z Androidem. W tym wariancie nie używasz MyGlasses.
· Użyj telefonu zatwierdzonego przez XREAL. SDK 3.1.0 wymienia Samsunga Galaxy S25 z Androidem 15; strona zgodności XREAL wymienia także Galaxy S24 z Androidem 14 i podaje, że obsługiwane są wyłącznie flagowe modele Samsunga. Sprawdź wersję Androida w telefonie przed zakupem lub aktualizacją: XREAL prosi programistów, aby nie aktualizowali urządzeń programistycznych do Androida 16, a Samsung od września 2025 roku udostępnia Androida 16 (One UI 8) na oba modele. Podczas prac programistycznych wyłącz Samsung DeX.
· Zainstaluj APK na telefonie zamiast na Beam Pro.
· Podłącz XREAL One Pro do telefonu kablem USB-C.
· Otwórz ControlGlasses, znajdź zainstalowaną aplikację XREAL i uruchom ją.
Nie mieszaj tych dwóch wariantów: Beam Pro korzysta z MyGlasses. Obsługiwany telefon z Androidem korzysta z ControlGlasses.
Typowe błędy podczas tworzenia aplikacji
- Próba zainstalowania APK w okularach: Zainstaluj go na Beam Pro lub obsługiwanym telefonie z Androidem.
- Traktowanie Beam Pro jako aplikacji: Beam Pro to oddzielny fizyczny sprzęt. MyGlasses to aplikacja XREAL używana na Beam Pro.
- Używanie MyGlasses na zwykłym telefonie z Androidem: Przy tworzeniu na telefonie używa się zamiast tego ControlGlasses.
- Pisanie własnego kodu, zanim zadziała HelloMR: Najpierw uruchom niezmodyfikowany przykład, a potem go dostosuj.
- Pozostawienie Beam Pro podłączonego do komputera podczas próby korzystania z okularów: Po zainstalowaniu APK odłącz Beam Pro od komputera i podłącz One Pro do Beam Pro.
Podsumowanie
Tworzenie aplikacji dla XREAL One Pro zaczyna się od rozróżnienia trzech części systemu: na komputerze powstaje projekt Unity, na Beam Pro lub obsługiwanym telefonie z Androidem faktycznie działa plik APK, a XREAL One Pro to noszone urządzenie wyświetlające i śledzące. Wybierając Beam Pro jako najprostszą ścieżkę, najpierw skonfiguruj fizyczne urządzenie Beam Pro, zainstaluj na komputerze Unity Hub i obsługiwany Unity Editor, pobierz i zaimportuj XREAL SDK, włącz wtyczkę XREAL, otwórz przykład HelloMR, zbuduj APK, zainstaluj go na Beam Pro za pomocą ADB, a następnie odłącz Beam Pro od komputera, podłącz One Pro i uruchom aplikację przez MyGlasses. W przypadku firm zrozumienie tej architektury przed rozpoczęciem prac pomaga określić właściwy plan sprzętowy, bezpieczeństwa i wdrożenia, ułatwia rozwiązywanie problemów w projektach pilotażowych i sprawia, że zespoły nie tracą czasu na tworzenie aplikacji dla modelu samodzielnych okularów, którego One Pro nie wykorzystuje.
Planujesz aplikację dla XREAL One Pro? Zacznij od jednego Beam Pro, jednych okularów One Pro i przykładu HelloMR, najpierw sprawdź działanie przepływu od hosta do okularów, a dopiero potem dodawaj tylko te funkcje Unity, których wymaga dany przypadek biznesowy.
