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’u | Obserwacja w grze | Co można stwierdzić |
Lista zawiera XR_ENVIRONMENT_BLEND_MODE_ALPHA_BLEND | Obraz gry i Room View są widoczne jednocześnie | Runtime udostępnia ten tryb dla zapytanej konfiguracji, a badana gra wyświetla zmieszaną kompozycję. |
Lista zawiera XR_ENVIRONMENT_BLEND_MODE_ALPHA_BLEND | Obraz gry nie łączy się z Room View | Potwierdzona jest obsługa runtime’u; zachowanie aplikacji wymaga osobnej oceny. |
Lista nie zawiera XR_ENVIRONMENT_BLEND_MODE_ALPHA_BLEND | Dowolny wynik w grze | Runtime 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.