Sprawdzanie możliwości dźwięku przestrzennego

Odpowiednie urządzenia XR
Te wskazówki pomogą Ci tworzyć treści na te urządzenia XR.
Więcej informacji o typach urządzeń XR →
Gogle XR
Przewodowe okulary XR
Więcej informacji o typach urządzeń XR →

Możliwości przestrzenne mogą się różnić w zależności od urządzenia i zmieniać się w miarę interakcji użytkowników z aplikacją lub systemem. Mogą one być nawet zmieniane przez samą aplikację, np. podczas przechodzenia do przestrzeni domowej lub pełnej. Aby uniknąć problemów, aplikacja musi sprawdzać możliwości przestrzenne, aby określić, które interfejsy API są obsługiwane w bieżącym środowisku.

Sprawdzanie możliwości przestrzennych za pomocą Jetpack Compose na potrzeby XR

Jetpack Compose for XR tworzy lokalną kompozycję do sprawdzania możliwości przestrzennych. Sprawdź, czy włączone są interfejs przestrzenny, dźwięk przestrzenny, środowiska, widok passthrough lub treści 3D.

Za pomocą LocalSpatialCapabilities.current możesz sprawdzić, czy te funkcje przestrzenne są obecnie dostępne:

Przykład poniżej pokazuje, jak sprawdzić, czy interfejs przestrzenny jest włączony:

if (LocalSpatialCapabilities.current.isSpatialUiEnabled) {
    Subspace {
        SpatialPanel(
            modifier = SubspaceModifier
                .width(1488.dp)
                .fillMaxHeight()
        ) {
            AppContent()
        }
    }
} else {
    AppContent()
}
SpatialCapabilities.kt

Sprawdzanie możliwości przestrzennych za pomocą SceneCore

Jeśli używasz biblioteki SceneCore, musisz utworzyć sesję. Po utworzeniu sesji użyj polecenia spatialCapabilities z scene sesji, aby sprawdzić, które funkcje przestrzenne są obecnie dostępne.

Możesz też zasubskrybować wywołanie zwrotneaddSpatialCapabilitiesChangedListener, które powiadomi Cię o zmianach w funkcjach przestrzennych.

// Example 1: check if enabling passthrough mode is allowed
if (xrSession.scene.spatialCapabilities.contains(
        SpatialCapability.PASSTHROUGH_CONTROL
    )
) {
    xrSession.scene.spatialEnvironment.preferredPassthroughOpacity = 1f
}
// Example 2: multiple capability flags can be checked simultaneously:
if (xrSession.scene.spatialCapabilities.contains(SpatialCapability.PASSTHROUGH_CONTROL) &&
    xrSession.scene.spatialCapabilities.contains(SpatialCapability.SPATIAL_3D_CONTENT)
) {
    // ...
}
SpatialCapabilities.kt

Sprawdzanie możliwości wyświetlania urządzenia za pomocą trybu mieszania

Na Androidzie XR gogle XR i przewodowe okulary XR mają różne możliwości sprzętowe, zwłaszcza jeśli chodzi o typ wyświetlacza. Może być konieczne dostosowanie kolorów interfejsu aplikacji i renderowanych obiektów, aby zmaksymalizować widoczność, na którą może wpływać typ wyświetlacza i preferowany tryb mieszania używany przez urządzenie. Interfejs DisplayBlendMode API udostępnia funkcję trybu mieszania urządzenia na potrzeby renderowania. Za pomocą tego interfejsu API możesz określić, w jaki sposób wirtualne treści są dodawane do świata rzeczywistego.

Oto kilka rodzajów trybów mieszania, o których warto pamiętać:

  • ADDITIVE: wirtualne treści są dodawane do rzeczywistego świata przez dodanie wartości pikseli dla każdego z komponentów: czerwonego, zielonego i niebieskiego. Kanał alfa jest ignorowany, a czarne piksele są przezroczyste.
  • ALPHA_BLEND: wirtualne treści są dodawane do świata rzeczywistego przez mieszanie alfa wartości pikseli na podstawie komponentu alfa.
  • NO_DISPLAY: mieszanie nie jest obsługiwane na tym urządzeniu.

Użyj XrDevice.getCurrentDevice(session).getPreferredDisplayBlendMode() z biblioteki środowiska wykonawczego Jetpack XR, aby sprawdzić, jakiego typu tryb mieszania jest używany, i w razie potrzeby wprowadzić zmiany.

Zobacz również