Test passthrough OpenXR na Steam Frame składa się z dwóch etapów: sprawdzenia, czy aktywny runtime udostępnia XR_ENVIRONMENT_BLEND_MODE_ALPHA_BLEND, a następnie obserwacji, czy gra rzeczywiście łączy swój obraz z Room View. Pierwszy etap mówi o możliwościach konkretnego systemu i konfiguracji widoku; o zachowaniu aplikacji rozstrzyga dopiero drugi.

Wynik zapytania o runtime traktuj jako początek testu. Gra musi jeszcze wybrać tryb alpha blend i prawidłowo przygotować obraz.

Przygotuj Steam Frame do streamingu z PC

Valve zaleca korzystanie z gałęzi beta dla Steam Frame, klienta Steam i SteamVR, aby otrzymywać najnowsze aktualizacje. W ustawieniach gogli wybierz Steam Settings > System > System Update Channel > Beta. Następnie włącz gałęzie beta klienta Steam i SteamVR na komputerze. Valve opisuje te ustawienia w instrukcji przygotowania Steam Frame dla deweloperów.

Do połączenia z komputerem sparuj dołączony adapter bezprzewodowy, uruchom SteamVR i połącz gogle z komputerem z poziomu Steam Menu na pulpicie Steam Frame. Uruchom sondę OpenXR w tym samym środowisku runtime, z którego korzysta sprawdzana gra; zanotuj identyfikację systemu i konfigurację widoku, aby wynik dotyczył właściwego zestawu.

Sprawdź tryby obsługiwane przez runtime

Wywołaj xrEnumerateEnvironmentBlendModes dla identyfikatora systemu (XrSystemId) i konfiguracji widoku (XrViewConfigurationType) używanej w teście. Funkcja zwraca tryby obsługiwane przez tę parę, w kolejności od najwyższego do najniższego priorytetu runtime’u. Khronos wymaga, by lista dla tego samego systemu i konfiguracji pozostawała identyczna przez cały czas życia instancji XrInstance (opis funkcji).

Na liście mogą pojawić się trzy tryby: OPAQUE, w którym obraz aplikacji zasłania widok świata; ADDITIVE, który dodaje obraz aplikacji do świata rzeczywistego; oraz ALPHA_BLEND, w którym kanał alfa obrazu RGBA steruje jego mieszaniem z widokiem rzeczywistym (definicje trybów). Obecność ALPHA_BLEND oznacza więc, że runtime udostępnia ten tryb dla właśnie sprawdzanego systemu i konfiguracji widoku. Kolejność na liście opisuje preferencje runtime’u, a nie wybór dokonany przez grę.

Przy implementacji sondy sprawdzaj wynik każdego wywołania OpenXR, zanim użyjesz zwróconych danych. Dotyczy to także xrGetSystemProperties: jeśli wywołanie się nie powiedzie, nie traktuj zawartości struktury jako wiarygodnej. Khronos opisuje możliwe wyniki błędu tej funkcji w specyfikacji OpenXR.

Sprawdź osobno kompozycję obrazu w grze

Sama lista trybów nie mówi, jaki tryb wybiera aplikacja. Gra wskazuje tryb kompozycji dla każdej klatki w xrEndFrame; żeby uzyskać alpha blend, musi też dostarczyć warstwę obrazu z właściwą obsługą kanału alfa. Jeśli format swapchaina nie zawiera kanału alfa albo warstwa nie ma ustawionej flagi użycia alfy, jej kanał alfa jest inicjalizowany wartością jeden. W takiej sytuacji przezroczystość nie wynika z samej obecności ALPHA_BLEND na liście runtime’u (specyfikacja kompozycji OpenXR).

Uruchom badaną grę przez streaming z PC i sprawdź w Room View, czy jej obraz oraz widok pomieszczenia są widoczne jednocześnie. Wynik odczytuj w odniesieniu do konkretnego runtime’u, systemu, konfiguracji widoku i gry:

Wynik zapytania runtime’uObserwacja w grzeCo można stwierdzić
Lista zawiera XR_ENVIRONMENT_BLEND_MODE_ALPHA_BLENDObraz gry i Room View są widoczne jednocześnieRuntime udostępnia ten tryb dla zapytanej konfiguracji, a badana gra wyświetla zmieszaną kompozycję.
Lista zawiera XR_ENVIRONMENT_BLEND_MODE_ALPHA_BLENDObraz gry nie łączy się z Room ViewPotwierdzona jest obsługa runtime’u; zachowanie aplikacji wymaga osobnej oceny.
Lista nie zawiera XR_ENVIRONMENT_BLEND_MODE_ALPHA_BLENDDowolny wynik w grzeRuntime nie reklamuje tego trybu dla sprawdzanej pary systemu i konfiguracji widoku.

Test kończy się dopiero wtedy, gdy osobno zapiszesz wynik zapytania runtime’u i obserwację z gry. Pozytywna odpowiedź API dotyczy konkretnej konfiguracji; nie zastępuje sprawdzenia kompozycji aplikacji.