Wprowadzenie do openXR

Możesz programować przy użyciu technologii OpenXR na HoloLens 2 lub Windows Mixed Reality immersyjnym na pulpicie. Jeśli nie masz dostępu do zestawu nagłownego, możesz zamiast tego użyć HoloLens 2 Emulator lub Windows Mixed Reality Simulator.

Wprowadzenie do openXR for HoloLens 2

Aby rozpocząć tworzenie aplikacji OpenXR dla HoloLens 2:

  1. Skonfiguruj HoloLens 2 lub postępuj zgodnie z instrukcjami, aby zainstalować najnowszą wersję emulatora HoloLens 2. Środowisko OpenXR 1.0 powinno być już gotowe do użycia, jeśli używasz najnowszego obrazu emulatora lub urządzenie zaktualizowało jego system operacyjny.
  2. Upewnij się, że masz najnowsze środowisko uruchomieniowe OpenXR ze wszystkimi rozszerzeniami, uruchamiając aplikację ze sklepu z urządzenia lub emulatora.
    • Otwórz menu w prawym górnym rogu, wybierz pozycję Pliki do pobrania i aktualizacje, a następnie wybierz pozycję Pobierz aktualizacje.

Uwaga

Jeśli używasz emulatora, obraz emulatora będzie resetowany przy każdym uruchomieniu, dlatego najlepiej jest upewnić się, że masz najnowszą wersję obrazu emulatora HoloLens 2.

Wprowadzenie do openXR dla Windows Mixed Reality nagłownych

Aby rozpocząć tworzenie aplikacji OpenXR dla immersywnych zestawów Windows Mixed Reality nagłownych:

  1. Upewnij się, że używasz co najmniej Aktualizacja systemu Windows 10 z maja 2019 (1903), co jest minimalnym wymaganiem, aby użytkownicy końcowi Windows Mixed Reality uruchamiali aplikacje OpenXR. Jeśli korzystasz ze starszej wersji programu Windows 10, możesz uaktualnić za pomocą narzędzia Windows 10 Update Assistant.
  2. Skonfiguruj zestaw Windows Mixed Reality lub postępuj zgodnie z instrukcjami, aby włączyć Windows Mixed Reality urządzenia.

Gotowe. Środowisko Windows Mixed Reality OpenXR jest instalowane i automatycznie aktywne dla wszystkich Windows Mixed Reality użytkowników. Następnie Microsoft Store zapewnia aktualne środowisko uruchomieniowe.

Aby ponownie Windows Mixed Reality środowisko uruchomieniowe OpenXR, uruchom polecenie Portal rzeczywistości mieszanej z menu Start, a następnie wybierz pozycję "Napraw" w górnej części okna. Jeśli brakuje tego przycisku, środowisko uruchomieniowe OpenXR jest już aktywne.

Pobieranie danych OpenXR Narzędzia deweloperskie for Windows Mixed Reality

Aby wypróbować środowisko Windows Mixed Reality OpenXR Runtime, możesz zainstalować aplikację OpenXR Narzędzia deweloperskie for Windows Mixed Reality . Ta aplikacja udostępnia pokaz różnych funkcji OpenXR wraz ze stroną Stan systemu z kluczowymi informacjami o aktywnym środowisku uruchomieniowym i bieżącym zestawie nagłownym.

W przypadku korzystania z HoloLens 2 najprostszym sposobem zainstalowania programu OpenXR Narzędzia deweloperskie for Windows Mixed Reality jest użycie Windows Portal urządzeń. Przejdź do strony "OpenXR", a następnie kliknij przycisk "Zainstaluj" w obszarze "Funkcje dewelopera", który działa również na urządzeniach fizycznych HoloLens 2.

OpenXR Narzędzia deweloperskie for Windows Mixed Reality app

Eksplorowanie interfejsu API OpenXR i przykładowej aplikacji

Pamiętaj, aby zainstalować narzędzia potrzebne do tworzenia aplikacji OpenXR, jeśli nie zostały jeszcze zainstalowane.

W projekcie BasicXrApp przedstawiono prosty przykład OpenXR z plikami projektu Win32 i UWP HoloLens 2 w Visual Studio. Ponieważ rozwiązanie zawiera projekt platformy HoloLens platformy uniwersalnej systemu Windows, w celu pełnego otwarcia tego projektu Windows platformie Visual Studio platformie uniwersalnej systemu Windows.

Chociaż pliki projektu Win32 i platformy uniwersalnej systemu Windows są oddzielone ze względu na różnice w pakowaniu i wdrażaniu, kod aplikacji w każdym projekcie jest prawie dokładnie taki sam!

Uruchamianie aplikacji OpenXR

Po sbudowania zestawu openXR Win32 desktop .EXE można go używać z zestawem VR na dowolnej platformie pulpitu VR, która obsługuje openXR, niezależnie od typu zestawu.

Po s zbudowaniu pakietu aplikacji openXR platformy uniwersalnej systemu Windows możesz wdrożyć ten pakiet na urządzeniu z systemem HoloLens 2 lub HoloLens 2 Emulator.

Edukacja interfejsu API OpenXR

Aby uzyskać przewodnik po interfejsie API OpenXR, zapoznaj się z tym 60-minutowym wideo z przykładu BasicXrApp w Visual Studio. W tym filmie wideo pokazano, jak można używać poszczególnych głównych składników interfejsu API OpenXR we własnym aucie, a także przedstawiono niektóre z aplikacji sbudowaną obecnie w oparciu o openXR:

Korzystanie z openXR w istniejącym projekcie

Aby rozpocząć pracę z openXR w istniejącym projekcie, należy dołączyć modułu ładującego OpenXR. Ten modułu ładującego odnajduje aktywne środowisko uruchomieniowe OpenXR na urządzeniu i zapewnia dostęp do podstawowych funkcji i funkcji rozszerzeń, które implementuje.

Możesz odwołać się do oficjalnego pakietu NuGet OpenXR z projektu Visual Studio lub dołączyć oficjalne źródło modułu ładującego OpenXR z GitHub w ładziwce Wronos. Każde z tych podejść zapewni dostęp do podstawowych funkcji OpenXR 1.0 oraz KHR opublikowanych rozszerzeń i EXT MSFT .

Jeśli chcesz również poeksperymentować z rozszerzeniami, możesz skopiować nagłówki OpenXR w wersji zapoznawczej z MSFT_preview Mixed Reality GitHub.

Odwołanie do oficjalnego pakietu NuGet OpenXR

Pakiet NuGet OpenXR.Loader jest najprostszym sposobem odwołania się do wstępnie utworzonego modułu ładującego OpenXR .DLL w rozwiązaniu Visual Studio C++. Zapewni to dostęp do podstawowych funkcji OpenXR 1.0 oraz KHR opublikowanych rozszerzeń i EXT MSFT .

Aby dodać odwołanie do pakietu OpenXR.Loader NuGet do rozwiązania Visual Studio C++:

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt, który będzie używać openXR, a następnie wybierz pozycję Zarządzaj NuGet pakietów....
  2. Przejdź do karty Przeglądaj i wyszukaj pozycję OpenXR.Loader.
  3. Wybierz pakiet OpenXR.Loader i wybierz pozycję Zainstaluj w okienku szczegółów po prawej stronie.
  4. Wybierz przycisk OK, aby zaakceptować zmiany w projekcie.
  5. Dodaj #include <openxr/openxr.h> do pliku źródłowego, aby rozpocząć korzystanie z interfejsu API OpenXR.

Aby zobaczyć przykładowy interfejs API OpenXR w działaniu, zapoznaj się z przykładową aplikacją BasicXrApp.

Dołącz oficjalne źródło modułu ładującego OpenXR

Jeśli chcesz samodzielnie skompilować modułu ładującego, na przykład w celu uniknięcia dodatkowego modułu ładującego .DLL, możesz ściągnąć do projektu oficjalne źródła modułu ładującego OpenXR dla systemu Chronoronos. Zapewni to dostęp do podstawowych funkcji OpenXR 1.0 oraz KHR opublikowanych rozszerzeń i EXT MSFT .

Aby rozpocząć pracę w tym miejscu, postępuj zgodnie z instrukcjami w repocie zestawu OpenXR-SDK dla systemu Chronoronos na stronie GitHub. Projekt jest skompilowany za pomocą narzędzia CMake — jeśli używasz narzędzia MSBuild, musisz skopiować kod do własnego projektu.

Korzystanie z rozszerzeń w wersji zapoznawczej

Rozszerzenia MSFT_preview wymienione w planie rozszerzenia to eksperymentalne rozszerzenia dostawcy w wersji zapoznawczej w celu zebrania opinii. Te rozszerzenia są tylko dla urządzeń dewelopera i zostaną usunięte, gdy rzeczywiste rozszerzenie zostanie nadane.

Jeśli chcesz wypróbować dostępne rozszerzenia, przejdź przez następujące kroki, aby MSFT_preview zaktualizować projekt:

  1. Postępuj zgodnie z jedną z powyższych metod, aby zintegrować modułu ładującego OpenXR z projektem.
  2. Zastąp standardowe nagłówki OpenXR w projekcie nagłówkami podglądu z Mixed Reality OpenXRw GitHub .

Aby aktywować obsługę rozszerzenia w wersji zapoznawczej na komputerze docelowym HoloLens 2 lub komputera stacjonarnego:

  1. Aby upewnić się, że masz najnowsze środowisko uruchomieniowe OpenXR ze wszystkimi dostępnymi rozszerzeniami, uruchom aplikację Ze sklepu z poziomu urządzenia docelowego lub emulatora, otwórz menu w prawym górnym rogu, wybierz pozycję Pliki do pobrania i aktualizacje, a następnie wybierz pozycję Pobierz aktualizacje.
  2. Zainstaluj aplikację OpenXR Narzędzia deweloperskie for Windows Mixed Reality z Microsoft Store na urządzeniu docelowym i uruchom ją.
  3. Przejdź do karty Developer Ustawienia i włącz opcję Użyj najnowszej wersji zapoznawczej środowiska uruchomieniowego OpenXR. Umożliwia to korzystanie ze środowiska uruchomieniowego w wersji zapoznawczej na urządzeniu z aktywowanymi rozszerzeniami w wersji zapoznawczej. OpenXR Narzędzia deweloperskie for Windows Mixed Reality developer Ustawienia kartę
  4. Upewnij się, że wersja środowiska uruchomieniowego wyświetlana na karcie Stan systemu biblioteki OpenXR Narzędzia deweloperskie for Windows Mixed Reality jest Windows Mixed Reality wymaganą wersją rozszerzeń w wersji zapoznawczej, które planujesz wypróbować. Jeśli tak, rozszerzenie powinno zostać wyświetlona na liście Rozszerzenia. Gdy stabilne rozszerzenie będzie dostępne, jego rozszerzenie w wersji zapoznawczej zostanie usunięte.
    Karta Stan systemu Narzędzia deweloperskie OpenXR Windows Mixed Reality dla aplikacji

Zobacz Mixed Reality OpenXR, aby uzyskać dokumentację rozszerzeń w wersji zapoznawczej i przykłady sposobu ich używania.

Rozwiązywanie problemów

Jeśli masz problemy z uruchomieniem aplikacji OpenXR, zapoznaj się z naszymi poradami dotyczącymi rozwiązywania problemów.