Dźwięk przestrzenny to niezwykłe doznania dźwiękowe, które zabierają użytkowników jest w centrum akcji, dzięki czemu filmy brzmią bardziej realistycznie. Dźwięk jest „przestrzenny” aby uzyskać efekt wielu głośników, podobny do dźwięku przestrzennego konfiguracji, ale przez słuchawki.
Na przykład w filmie dźwięk samochodu może rozpoczynać się za plecami użytkownika, poruszać się na przód i dalej. Na czacie wideo głosy mogą być są rozdzielone i rozmieszczone wokół użytkownika, co ułatwia rozpoznanie osób mówiących.
Jeśli Twoje treści są w obsługiwanym formacie audio, możesz dodać dźwięk przestrzenny aplikacji w wersji na Androida 13 (poziom API 33).
Zapytanie o możliwości
Użyj zajęć Spatializer
, aby:
zapytań dotyczących możliwości i działań urządzeń w obszarze przestrzennym. Zacznij od pobrania
wystąpienie Spatializer
z
AudioManager
:
Kotlin
val spatializer = audioManager.spatializer
Java
Spatializer spatializer = AudioManager.getSpatializer();
Po otrzymaniu Spatializer
sprawdź, czy spełnione są 4 warunki
true (prawda) dla urządzenia do odtwarzania dźwięku przestrzennego:
Kryteria | Sprawdź |
---|---|
Czy urządzenie obsługuje stosowanie przestrzeni przestrzennej? |
getImmersiveAudioLevel() nie jest SPATIALIZER_IMMERSIVE_LEVEL_NONE
|
Czy jest dostępna analiza przestrzenna? Dostępność funkcji zależy od zgodności z bieżącym kierowaniem wyjścia audio. |
isAvailable() to true |
Czy przestrzennia jest włączona? | isEnabled() to true |
Czy ścieżkę audio z podanymi parametrami można zastosować w przestrzeni przestrzennej? | canBeSpatialized() to true |
Te warunki mogą nie zostać spełnione, np. jeśli przestrzeń jest niedostępna dla bieżącej ścieżki audio lub całkowicie wyłączone na urządzeniu wyjściowym audio.
Monitorowanie ruchów głowy
W przypadku obsługiwanych zestawów słuchawkowych platforma może dostosować
na podstawie położenia głowy użytkownika. Aby sprawdzić, czy tracker jest
dla bieżącego kierowania wyjścia audio, wywołanie
isHeadTrackerAvailable()
Zgodne treści
Spatializer.canBeSpatialized()
wskazuje, czy dźwięk o podanych właściwościach może zostać przestrzenny za pomocą
aktualne ustawienia routingu urządzenia wyjściowego. Ta metoda wymaga AudioAttributes
i AudioFormat
, oba są
omówiono szczegółowo poniżej.
AudioAttributes
Obiekt AudioAttributes
opisuje użycie
strumień audio (na przykład dźwięk z gry)
lub standardowych multimediów),
oraz sposób odtwarzania i typ treści.
Dzwoniąc pod numer canBeSpatialized()
, użyj tego samego
wystąpienie AudioAttributes
ustawione dla Player
. Na przykład, jeśli
używasz biblioteki Jetpack Media3 i nie dostosowano
AudioAttributes
, użyj AudioAttributes.DEFAULT
.
Wyłączanie dźwięku przestrzennego
Aby wskazać, że treść została już przestrzenna, użyj wywołania
setIsContentSpatialized(true)
aby dźwięk nie został
przetworzony podwójnie. Możesz też dostosować
w celu całkowitego wyłączenia tej funkcji przez wywołanie
setSpatializationBehavior(AudioAttributes.SPATIALIZATION_BEHAVIOR_NEVER)
AudioFormat
Obiekt AudioFormat
opisuje
dane dotyczące formatu i konfiguracji kanału ścieżki audio.
Podczas tworzenia instancji AudioFormat
przekazywanej do canBeSpatialized()
:
ustaw kodowanie
format wyjściowy spodziewany przez dekoder. Skonfiguruj także
maska kanału
która pasuje do konfiguracji kanału. Zapoznaj się z
W sekcji Domyślne zachowanie przestrzenne znajdziesz wskazówki na temat
konkretne wartości.
Wykrywaj zmiany w: Spatializer
Aby wykrywać zmiany stanu urządzenia Spatializer
, możesz dodać detektor
dzięki Spatializer.addOnSpatializerStateChangedListener()
.
Podobnie, aby obserwować zmiany w dostępności trackera,
zadzwoń do: Spatializer.addOnHeadTrackerAvailableListener()
.
Jest to przydatne, gdy chcesz dostosować wybór ścieżek podczas odtwarzania
za pomocą wywołań zwrotnych słuchacza. Na przykład, gdy użytkownik łączy lub rozłącza swoje
zestawu słuchawkowego z urządzenia onSpatializerAvailableChanged
wywołanie zwrotne wskazuje, czy efekt przestrzenny jest dostępny dla nowych
kierowania wyjścia audio. W tym momencie możesz rozważyć zaktualizowanie
śledzić logikę wyboru pod kątem nowych możliwości urządzenia. Więcej informacji:
Sposób wyboru ścieżek przez ExoPlayer znajdziesz w sekcji ExoPlayer i dźwięk przestrzenny.
.
ExoPlayer i dźwięk przestrzenny
Najnowsze wersje ExoPlayer ułatwiają korzystanie z dźwięku przestrzennego. Jeśli używasz
samodzielna biblioteka ExoPlayer (nazwa pakietu com.google.android.exoplayer2
),
wersja 2.17 konfiguruje platformę tak, aby wydawała dźwięk przestrzenny,
2.18 wprowadza ograniczenia liczby kanałów audio.
Jeśli używasz modułu ExoPlayer z biblioteki Media3 (nazwa pakietu
androidx.media3
), wersje 1.0.0-beta01
i nowszych zawierają te same aktualizacje.
Po zaktualizowaniu zależności ExoPlayer do najnowszej wersji aplikacja musi zawierać treści, które można umieścić w przestrzeni przestrzennej.
Ograniczenia liczby kanałów audio
Jeśli zostaną spełnione wszystkie 4 warunki dotyczące dźwięku przestrzennego, ExoPlayer wybierze:
wielokanałową ścieżkę audio. W przeciwnym razie ExoPlayer wybiera ścieżkę stereo.
Jeśli właściwości Spatializer
ulegną zmianie, ExoPlayer
uruchamia wybór nowej ścieżki audio, która pasuje do
obecne właściwości. Pamiętaj, że wybór nowego utworu może spowodować krótką
przez okres ponownego buforowania.
Aby wyłączyć ograniczenia liczby kanałów audio, ustaw parametry wyboru ścieżki w odtwarzaczu, jak pokazano poniżej:
Kotlin
exoPlayer.trackSelectionParameters = DefaultTrackSelector.Parameters.Builder(context) .setConstrainAudioChannelCountToDeviceCapabilities(false) .build()
Java
exoPlayer.setTrackSelectionParameters( new DefaultTrackSelector.Parameters.Builder(context) .setConstrainAudioChannelCountToDeviceCapabilities(false) .build() );
Można również zaktualizować parametry istniejącego selektora ścieżki, aby wyłączyć takie ograniczenia liczby kanałów audio:
Kotlin
val trackSelector = DefaultTrackSelector(context) ... trackSelector.parameters = trackSelector.buildUponParameters() .setConstrainAudioChannelCountToDeviceCapabilities(false) .build()
Java
DefaultTrackSelector trackSelector = new DefaultTrackSelector(context); ... trackSelector.setParameters( trackSelector .buildUponParameters() .setConstrainAudioChannelCountToDeviceCapabilities(false) .build() );
z wyłączonymi ograniczeniami liczby kanałów audio, jeśli treści zawierają wiele ścieżek dźwiękowych; utworów, ExoPlayer początkowo wybiera utwór z największą liczbą kanałów, można odtworzyć na urządzeniu. Jeśli na przykład treści zawierają wielokanałową i stereofoniczną ścieżkę audio, a urządzenie obsługuje jednocześnie, ExoPlayer wybierze ścieżkę wielokanałową. Zobacz Wybór ścieżki dźwiękowej – szczegółowe informacje o tym, jak dostosować to działanie.
Wybór ścieżki audio
Gdy ograniczenia liczby kanałów audio ExoPlayer jest wyłączone, ExoPlayer nie wybiera automatycznie ścieżki dźwiękowej która pasuje do właściwości mechanizmu przestrzennego urządzenia. Zamiast tego możesz: dostosuj logikę wyboru ścieżek w aplikacji ExoPlayer, ustawiając wybór ścieżki przed lub w trakcie odtwarzania. Domyślnie ExoPlayer wybiera dźwięk ścieżki, które są takie same jak ścieżka początkowa pod względem typu MIME. (kodowanie), liczbę kanałów i częstotliwość próbkowania.
Zmiana parametrów wyboru ścieżki
Aby zmienić parametry wyboru ścieżki w odtwarzaczu ExoPlayer, użyj funkcji
Player.setTrackSelectionParameters()
Bieżące parametry ExoPlayer można też uzyskać za pomocą parametru
Player.getTrackSelectionParameters()
Aby na przykład wybrać stereofoniczną ścieżkę dźwiękową w trakcie odtwarzania:
Kotlin
exoPlayer.trackSelectionParameters = exoPlayer.trackSelectionParameters .buildUpon() .setMaxAudioChannelCount(2) .build()
Java
exoPlayer.setTrackSelectionParameters( exoPlayer.getTrackSelectionParameters() .buildUpon() .setMaxAudioChannelCount(2) .build() );
Pamiętaj, że zmiana parametrów wyboru ścieżki w trakcie odtwarzania może spowodować przerwy w odtwarzaniu. Więcej informacji o dostrajaniu ścieżki odtwarzacza parametrów wyboru są dostępne w wybór ścieżki w dokumentacji ExoPlayer.
Domyślne zachowanie przestrzeni
Domyślne zachowanie przestrzenne na Androidzie obejmuje te zachowania które mogą być dostosowywane przez OEM:
Przestrzenne są tylko treści wielokanałowe, a nie materiały stereo. Jeśli nie używasz ExoPlayer, w zależności od formatu Twojego wielokanałowego treści audio, może być konieczne skonfigurowanie maksymalnej liczby kanałów które mogą być wysyłane przez dekoder audio na dużą liczbę. Dzięki temu dekoder dźwięku wysyła wielokanałowy PCM, aby platforma stała się przestrzenna.
Kotlin
val mediaFormat = MediaFormat() mediaFormat.setInteger(MediaFormat.KEY_MAX_OUTPUT_CHANNEL_COUNT, 99)
Java
MediaFormat mediaFormat = new MediaFormat(); mediaFormat.setInteger(MediaFormat.KEY_MAX_OUTPUT_CHANNEL_COUNT, 99);
Przykład działania znajdziesz w przewodniku firmy ExoPlayer
MediaCodecAudioRenderer.java
. Aby samodzielnie wyłączyć przestrzennie, niezależnie od producenta OEM Więcej informacji znajdziesz w sekcji o wyłączaniu dźwięku przestrzennego.AudioAttributes
: dźwięk kwalifikuje się do przekształcenia przestrzennego jeśliusage
jest ustawiona naUSAGE_MEDIA
lubUSAGE_GAME
.AudioFormat
: użyj maski kanału, która zawiera co najmniejAudioFormat.CHANNEL_OUT_QUAD
kanałów (przedni lewy, przedni prawy, tylny lewy i tylny prawy), na który będzie odtwarzany dźwięk. i nie mogą być wykorzystywane w przestrzeni. W poniższym przykładzie używamy wyrażeniaAudioFormat.CHANNEL_OUT_5POINT1
w przypadku ścieżki audio 5.1. W przypadku stereofonicznej ścieżki audio użyjAudioFormat.CHANNEL_OUT_STEREO
.Jeśli korzystasz z Media3, możesz użyć
Util.getAudioTrackChannelConfig(int channelCount)
aby przekonwertować liczbę kanałów na maskę kanału.Dodatkowo ustaw kodowanie na
AudioFormat.ENCODING_PCM_16BIT
jeśli dekoder jest skonfigurowany tak, by wysyłał wielokanałowy PCM.Kotlin
val audioFormat = AudioFormat.Builder() .setEncoding(AudioFormat.ENCODING_PCM_16BIT) .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1) .build()
Java
AudioFormat audioFormat = new AudioFormat.Builder() .setEncoding(AudioFormat.ENCODING_PCM_16BIT) .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1) .build();
Przetestuj dźwięk przestrzenny
Sprawdź, czy na urządzeniu testowym włączony jest dźwięk przestrzenny:
- W przypadku przewodowych zestawów słuchawkowych otwórz Ustawienia systemu > Dźwięk i wibracje > Przestrzenny audio.
- W przypadku słuchawek bezprzewodowych otwórz Ustawienia systemu > Połączone urządzenia > Ikona koła zębatego dla urządzenia bezprzewodowego > Dźwięk przestrzenny.
Aby sprawdzić dostępność dźwięku przestrzennego dla bieżącego routingu, uruchom
adb shell dumpsys audio
na urządzeniu. Strona powinna wyglądać tak:
parametrów w danych wyjściowych, gdy odtwarzanie jest aktywne:
Spatial audio:
mHasSpatializerEffect:true (effect present)
isSpatializerEnabled:true (routing dependent)