Wprowadzenie do biblioteki OpenXR

Można opracowywać przy użyciu biblioteki OpenXR na HoloLens 2 lub Windows Mixed Reality immersywny zestaw słuchawkowy na pulpicie. Jeśli nie masz dostępu do zestawu słuchawkowego, możesz zamiast tego użyć HoloLens 2 Emulator lub symulatora Windows Mixed Reality.

Wprowadzenie do usługi OpenXR dla HoloLens 2

Aby rozpocząć tworzenie aplikacji OpenXR dla HoloLens 2:

  1. Skonfiguruj urządzenie HoloLens 2 lub zainstaluj najnowszą wersję emulatora HoloLens 2.

Gotowe. Środowisko uruchomieniowe interfejsu API OpenXR jest wstępnie instalowane na urządzeniach HoloLens 2 i będziesz otrzymywać aktualizacje automatyczne za pośrednictwem Sklepu.

Aby upewnić się, że masz najnowsze środowisko uruchomieniowe OpenXR ze wszystkimi dostępnymi rozszerzeniami, możesz uruchomić aplikację Ze sklepu na urządzeniu HoloLens lub emulatorze. Otwórz menu w prawym górnym rogu aplikacji ze Sklepu, wybierz pozycję Pliki do pobrania i aktualizacje, a następnie wybierz pozycję Pobierz aktualizacje.

Uwaga

Jeśli używasz emulatora, obraz emulatora zostanie zresetowany za każdym razem, gdy go uruchomisz, więc najlepszym rozwiązaniem jest po prostu upewnienie się, że masz najnowszą wersję obrazu emulatora HoloLens 2.

Wprowadzenie do platformy OpenXR na potrzeby zestawów słuchawkowych Windows Mixed Reality

Aby rozpocząć tworzenie aplikacji OpenXR na potrzeby immersyjnych zestawów słuchawkowych Windows Mixed Reality:

  1. Upewnij się, że używasz co najmniej Windows 10 aktualizacji z października 2020 r. (20H2), która jest minimalną obsługiwaną wersją systemu operacyjnego dla użytkowników końcowych Windows Mixed Reality do uruchamiania aplikacji OpenXR. Wcześniejsze wersje Windows 10 nadal powinny działać z programem OpenXR, ale mogą nie mieć idealnej wydajności ani jakości. Jeśli korzystasz z wcześniejszej wersji Windows 10, możesz przeprowadzić uaktualnienie przy użyciu asystenta aktualizacji Windows 10.
  2. Skonfiguruj zestaw słuchawkowy Windows Mixed Reality lub włącz symulator Windows Mixed Reality.

Gotowe. Środowisko uruchomieniowe Windows Mixed Reality OpenXR jest instalowane i automatycznie aktywne dla wszystkich użytkowników Windows Mixed Reality. Następnie Microsoft Store zachowuje aktualność środowiska uruchomieniowego.

Jeśli używasz wielu zestawów słuchawkowych VR na komputerze, pamiętaj, że aktywne środowisko uruchomieniowe OpenXR może zostać zmienione przez oprogramowanie systemowe innego dostawcy. Aby ponownie uaktywnić środowisko uruchomieniowe openXR Windows Mixed Reality, w menu Start uruchom polecenie "Mixed Reality Portal", a następnie wybierz pozycję "Napraw" w górnej części okna. Jeśli brakuje tego przycisku, środowisko uruchomieniowe OpenXR jest już aktywne.

Pobieranie narzędzi OpenXR dla Windows Mixed Reality

Jeśli tworzysz aplikacje OpenXR dla HoloLens 2 lub PC VR, możesz znaleźć te narzędzia OpenXR dla Windows Mixed Reality aplikacji przydatne. Udostępnia pokaz różnych funkcji OpenXR i stronę środowiska uruchomieniowego OpenXR zawierającą kluczowe informacje o aktywnym środowisku uruchomieniowym i bieżącym zestawie słuchawkowym.

Aby znaleźć i zainstalować aplikację OpenXR Tools, w HoloLens 2 przejdź do aplikacji Ze sklepu i wyszukaj ciąg "OpenXR".

W przypadku korzystania z emulatora HoloLens 2 najłatwiej zainstalować narzędzia OpenXR Tools for Windows Mixed Reality jest za pośrednictwem portalu Windows Device Portal. W portalu przejdź do strony "OpenXR", a następnie w obszarze Funkcje dla deweloperów wybierz przycisk Zainstaluj . Działa to również na urządzeniach fizycznych HoloLens 2.

OpenXR Tools for Windows Mixed Reality app

Eksplorowanie interfejsu API openXR i przykładowej aplikacji

Pamiętaj, aby zainstalować narzędzia potrzebne do programowania w usłudze OpenXR, jeśli jeszcze tego nie zrobiono.

Projekt BasicXrApp przedstawia prosty przykład OpenXR z plikami projektów Win32 i UWP HoloLens 2 w Visual Studio. Ponieważ rozwiązanie zawiera projekt platformy uniwersalnej systemu Windows HoloLens, potrzebne będzie obciążenie deweloperskie platforma uniwersalna systemu Windows zainstalowane w Visual Studio, aby w pełni go otworzyć.

Chociaż pliki projektów Win32 i UWP są oddzielone ze względu na różnice w pakowaniu i wdrażaniu, kod aplikacji wewnątrz każdego projektu jest prawie dokładnie taki sam!

Aby zapoznać się z przewodnikiem po interfejsie API OpenXR, zapoznaj się z tym 60-minutowym filmem z przykładu BasicXrApp w Visual Studio. W filmie pokazano, jak każdy z głównych składników interfejsu API OpenXR może być używany we własnym akompilatorze, a także pokazuje niektóre z aplikacji utworzonych obecnie na platformie OpenXR:

Uruchamianie aplikacji OpenXR

Po utworzeniu pulpitu OpenXR Win32 .EXE można go użyć z zestawem słuchawkowym VR na dowolnej platformie VR, która obsługuje OpenXR, niezależnie od typu zestawu słuchawkowego.

Po utworzeniu pakietu aplikacji platformy UWP openXR można wdrożyć ten pakiet na urządzeniu HoloLens 2 lub HoloLens 2 Emulator.

Korzystanie z biblioteki OpenXR w istniejącym projekcie

Aby rozpocząć pracę z programem OpenXR w istniejącym projekcie, dołączysz moduł ładujący OpenXR. Moduł ładujący odnajduje aktywne środowisko uruchomieniowe OpenXR na urządzeniu i zapewnia dostęp do podstawowych funkcji i funkcji rozszerzenia, które implementuje.

Możesz odwołać się do oficjalnego pakietu openXR NuGet z projektu Visual Studio lub dołączyć oficjalne źródło modułu ładującego OpenXR z repozytorium Khronos GitHub. Dowolne podejście zapewnia dostęp do podstawowych funkcji OpenXR 1.0, a także opublikowanych KHREXT rozszerzeń i MSFT .

Jeśli interesuje Cię również eksperymentowanie z MSFT_preview rozszerzeniami, możesz skopiować w wersji zapoznawczej nagłówki OpenXR z repozytorium Mixed Reality GitHub.

Oficjalny pakiet NuGet OpenXR

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

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

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt, który będzie używać biblioteki OpenXR i wybierz polecenie Zarządzaj pakietami NuGet....
  2. Przejdź do karty Przeglądaj i wyszukaj ciąg 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 akcji, zapoznaj się z przykładową aplikacją BasicXrApp .

Uwzględnij oficjalne źródło modułu ładującego OpenXR

Jeśli chcesz utworzyć moduł ładujący samodzielnie, na przykład aby uniknąć dodatkowego modułu ładującego .DLL, możesz ściągnąć oficjalne źródła modułu ładującego Khronos OpenXR do projektu. Zapewni to dostęp do funkcji podstawowych openXR 1.0 oraz opublikowanych KHREXT rozszerzeń i MSFT .

Aby rozpocząć pracę tutaj, postępuj zgodnie z instrukcjami w repozytorium Khronos OpenXR-SDK w GitHub. Projekt jest skonfigurowany do kompilowania za pomocą narzędzia CMake — jeśli używasz MSBuild, musisz skopiować kod do własnego projektu.

Korzystanie z rozszerzeń w wersji zapoznawczej

Rozszerzenia MSFT_preview wymienione w planie rozszerzenia są eksperymentalnymi rozszerzeniami dostawcy, które są w wersji zapoznawczej w celu zebrania opinii. Te rozszerzenia są przeznaczone tylko dla urządzeń deweloperskich i zostaną usunięte po wysłaniu rzeczywistego rozszerzenia.

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

  1. Postępuj zgodnie z jednym z powyższych podejść, aby zintegrować moduł ładujący OpenXR z projektem.
  2. Zastąp standardowe nagłówki OpenXR w projekcie nagłówkami wersji zapoznawczej z repozytorium Mixed Reality OpenXR w GitHub.

Aby następnie aktywować obsługę rozszerzeń w wersji zapoznawczej na komputerze docelowym HoloLens 2 lub na komputerze stacjonarnym:

  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ę Pobrane i aktualizacje , a następnie wybierz pozycję Pobierz aktualizacje.
  2. Zainstaluj aplikację OpenXR Tools for Windows Mixed Reality z Microsoft Store na urządzeniu docelowym i uruchom ją.
  3. Przejdź do karty Ustawienia i włącz opcję Użyj najnowszej wersji zapoznawczej środowiska uruchomieniowego OpenXR. Umożliwia to środowisko uruchomieniowe w wersji zapoznawczej na urządzeniu, które ma aktywowane rozszerzenia w wersji zapoznawczej. OpenXR Tools for Windows Mixed Reality app Settings tab
  4. Upewnij się, że wersja środowiska uruchomieniowego wyświetlana na karcie Środowisko uruchomieniowe OpenXRTools for Windows Mixed Reality jest zgodna z wymaganą wersją rozszerzeń wersji zapoznawczej, które planujesz wypróbować. Jeśli tak, na liście Rozszerzenia powinno zostać wyświetlone rozszerzenie. Po udostępnieniu stabilnego rozszerzenia zostanie usunięte jego rozszerzenie w wersji zapoznawczej.
    OpenXR Tools for Windows Mixed Reality app OpenXR Runtime tab

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

Rozwiązywanie problemów

Jeśli masz problemy z rozpoczęciem programowania w usłudze OpenXR, zapoznaj się z naszymi wskazówkami dotyczącymi rozwiązywania problemów.