Audio Spasial adalah pengalaman audio imersif yang menempatkan pengguna di bagian tengah aksi, sehingga membuat konten Anda terdengar lebih realistis. Suara "dispasialisasi" untuk membuat efek multi-speaker, yang mirip dengan konfigurasi suara surround, tetapi melalui headphone.
Misalnya, dalam sebuah film, suara dari mobil mungkin berbunyi di belakang pengguna, bergerak maju, dan bergerak ke kejauhan. Di video chat, suara dapat dipisahkan dan ditempatkan di sekitar pengguna sehingga lebih mudah untuk mengidentifikasi pembicara.
Jika konten menggunakan format audio yang didukung, Anda dapat menambahkan audio spasial ke aplikasi mulai dari Android 13 (API level 33).
Mengkueri kemampuan
Gunakan class Spatializer
untuk
mengkueri kemampuan dan perilaku spasial perangkat. Mulai dengan mengambil
instance Spatializer
dari
AudioManager
:
Kotlin
val spatializer = audioManager.spatializer
Java
Spatializer spatializer = AudioManager.getSpatializer();
Setelah Anda mendapatkan Spatializer
, periksa empat kondisi yang harus bernilai
benar agar perangkat dapat menghasilkan audio spasial:
Kriteria | Periksa |
---|---|
Apakah perangkat mendukung spasialisasi? |
getImmersiveAudioLevel() bukan SPATIALIZER_IMMERSIVE_LEVEL_NONE
|
Apakah spasial tersedia? Ketersediaan bergantung pada kompatibilitas dengan pemilihan rute output audio saat ini. |
isAvailable() adalah true |
Apakah spasial diaktifkan? | isEnabled() adalah true |
Dapatkah trek audio dengan parameter yang diberikan dispasialisasi? | canBeSpatialized() adalah true |
Kondisi ini mungkin tidak terpenuhi, misalnya, jika spasialisasi tidak tersedia untuk trek audio saat ini atau dinonaktifkan sepenuhnya di perangkat output audio.
Pelacakan gerak kepala
Dengan headset yang didukung, platform dapat menyesuaikan spasial
audio berdasarkan posisi kepala pengguna. Untuk memeriksa apakah head tracker
tersedia untuk perutean output audio saat ini, panggil
isHeadTrackerAvailable()
.
Konten yang kompatibel
Spatializer.canBeSpatialized()
menunjukkan apakah audio dengan properti yang diberikan dapat dispasialisasi dengan
perutean perangkat output saat ini. Metode ini menggunakan AudioAttributes
dan AudioFormat
, yang keduanya
dijelaskan secara lebih mendetail di bawah.
AudioAttributes
Objek AudioAttributes
menjelaskan penggunaan
streaming audio (misalnya, audio game
atau media standar),
beserta perilaku pemutaran dan jenis kontennya.
Saat memanggil canBeSpatialized()
, gunakan instance
AudioAttributes
yang sama seperti yang ditetapkan untuk Player
. Misalnya, jika
Anda menggunakan library Jetpack Media3 dan belum menyesuaikan
AudioAttributes
, gunakan AudioAttributes.DEFAULT
.
Menonaktifkan audio spasial
Untuk menunjukkan bahwa konten Anda telah dispasialisasi, panggil
setIsContentSpatialized(true)
agar audio tidak diproses dua kali. Atau, sesuaikan
perilaku spasialisasi untuk menonaktifkan spasial sepenuhnya dengan memanggil
setSpatializationBehavior(AudioAttributes.SPATIALIZATION_BEHAVIOR_NEVER)
.
AudioFormat
Objek AudioFormat
menjelaskan
detail tentang format dan konfigurasi saluran trek audio.
Saat membuat instance AudioFormat
untuk diteruskan ke canBeSpatialized()
,
tetapkan encoding
ke sama dengan format output yang diharapkan dari decoder. Anda juga harus menyetel
mask channel
yang cocok dengan konfigurasi channel konten Anda. Lihat bagian
Perilaku spasial default untuk mendapatkan panduan tentang
nilai tertentu yang akan digunakan.
Memproses perubahan pada Spatializer
Untuk memproses perubahan status Spatializer
, Anda dapat menambahkan pemroses
dengan Spatializer.addOnSpatializerStateChangedListener()
.
Demikian pula, untuk memproses perubahan ketersediaan head tracker,
panggil Spatializer.addOnHeadTrackerAvailableListener()
.
Hal ini dapat berguna jika Anda ingin menyesuaikan pemilihan trek selama pemutaran
menggunakan callback pemroses. Misalnya, saat pengguna menghubungkan atau memutuskan sambungan
headset dari perangkat, callback onSpatializerAvailableChanged
akan menunjukkan apakah efek spatializer tersedia untuk perutean output
audio yang baru. Pada tahap ini, Anda dapat mempertimbangkan untuk memperbarui logika pemilihan trek
pemain agar sesuai dengan kemampuan baru perangkat. Untuk mengetahui detail tentang
perilaku pemilihan trek ExoPlayer, lihat bagian
ExoPlayer dan audio spasial.
ExoPlayer dan audio spasial
Rilis terbaru ExoPlayer memudahkan pengadopsian audio spasial. Jika Anda menggunakan
library ExoPlayer mandiri (nama paket com.google.android.exoplayer2
),
versi 2.17 akan mengonfigurasi platform untuk menghasilkan audio yang dispasialisasi, dan versi
2.18 memperkenalkan batasan jumlah saluran audio.
Jika Anda menggunakan modul ExoPlayer dari library Media3, (nama paket
androidx.media3
), versi 1.0.0-beta01
dan yang lebih baru akan menyertakan update yang sama ini.
Setelah mengupdate dependensi ExoPlayer ke rilis terbaru, aplikasi Anda hanya perlu menyertakan konten yang dapat dispasialisasi.
Batasan jumlah channel audio
Saat keempat kondisi untuk audio spasial terpenuhi, ExoPlayer akan memilih
trek audio multi-saluran. Jika tidak, ExoPlayer memilih trek stereo.
Jika properti Spatializer
berubah, ExoPlayer
akan memicu pemilihan trek baru untuk memilih trek audio yang cocok dengan
properti saat ini. Perhatikan bahwa pemilihan trek baru ini dapat menyebabkan periode
buffering ulang yang singkat.
Untuk menonaktifkan batasan jumlah channel audio, tetapkan parameter pemilihan trek pada pemutar seperti yang ditunjukkan di bawah ini:
Kotlin
exoPlayer.trackSelectionParameters = DefaultTrackSelector.Parameters.Builder(context) .setConstrainAudioChannelCountToDeviceCapabilities(false) .build()
Java
exoPlayer.setTrackSelectionParameters( new DefaultTrackSelector.Parameters.Builder(context) .setConstrainAudioChannelCountToDeviceCapabilities(false) .build() );
Demikian pula, Anda dapat memperbarui parameter pemilih trek yang ada untuk menonaktifkan batasan jumlah saluran audio sebagai berikut:
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() );
Dengan batasan jumlah saluran audio dinonaktifkan, jika konten memiliki beberapa trek audio, ExoPlayer awalnya memilih trek yang memiliki jumlah saluran tertinggi dan dapat diputar dari perangkat. Misalnya, jika konten berisi trek audio multi-saluran dan trek audio stereo, dan perangkat mendukung pemutaran keduanya, ExoPlayer akan memilih trek multi-saluran. Lihat Pemilihan trek audio untuk mengetahui detail tentang cara menyesuaikan perilaku ini.
Pilihan trek audio
Jika perilaku batasan jumlah saluran audio ExoPlayer dinonaktifkan, ExoPlayer tidak akan otomatis memilih trek audio yang cocok dengan properti spatializer perangkat. Sebagai gantinya, Anda dapat menyesuaikan logika pemilihan trek ExoPlayer dengan menetapkan parameter pemilihan jalur sebelum atau selama pemutaran. Secara default, ExoPlayer memilih trek audio yang sama dengan trek awal sehubungan dengan jenis MIME (encoding), jumlah saluran, dan frekuensi sampel.
Mengubah parameter pemilihan trek
Untuk mengubah parameter pemilihan jalur ExoPlayer, gunakan
Player.setTrackSelectionParameters()
.
Demikian juga, Anda bisa mendapatkan parameter ExoPlayer saat ini dengan
Player.getTrackSelectionParameters()
.
Misalnya, untuk memilih trek audio stereo di tengah pemutaran:
Kotlin
exoPlayer.trackSelectionParameters = exoPlayer.trackSelectionParameters .buildUpon() .setMaxAudioChannelCount(2) .build()
Java
exoPlayer.setTrackSelectionParameters( exoPlayer.getTrackSelectionParameters() .buildUpon() .setMaxAudioChannelCount(2) .build() );
Perhatikan bahwa mengubah parameter pemilihan trek di tengah pemutaran dapat menyebabkan gangguan dalam pemutaran. Informasi selengkapnya tentang menyesuaikan parameter pemilihan jalur pemain tersedia di bagian pemilihan trek dalam dokumen ExoPlayer.
Perilaku spasial default
Perilaku spasial default di Android mencakup perilaku berikut yang mungkin disesuaikan oleh OEM:
Hanya konten multisaluran yang dispasialisasi, bukan konten stereo. Jika tidak menggunakan ExoPlayer, bergantung pada format konten audio multi-saluran, Anda mungkin perlu mengonfigurasi jumlah maksimum saluran yang dapat dihasilkan oleh decoder audio ke jumlah besar. Hal ini memastikan bahwa decoder audio menghasilkan PCM multi-saluran untuk spasial platform.
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);
Untuk contoh penerapan, lihat
MediaCodecAudioRenderer.java
ExoPlayer. Untuk menonaktifkan spasialisasi sendiri, terlepas dari penyesuaian OEM, lihat Menonaktifkan audio spasial.AudioAttributes
: Audio memenuhi syarat untuk spasial jikausage
disetel keUSAGE_MEDIA
atauUSAGE_GAME
.AudioFormat
: Gunakan mask saluran yang berisi setidaknya saluranAudioFormat.CHANNEL_OUT_QUAD
(kiri depan, kanan depan, kiri belakang, dan kanan belakang) agar audio memenuhi syarat untuk spasialisasi. Dalam contoh di bawah, kami menggunakanAudioFormat.CHANNEL_OUT_5POINT1
untuk trek audio 5.1. Untuk trek audio stereo, gunakanAudioFormat.CHANNEL_OUT_STEREO
.Jika menggunakan Media3, Anda dapat menggunakan
Util.getAudioTrackChannelConfig(int channelCount)
untuk mengonversi jumlah saluran menjadi mask saluran.Selain itu, setel encoding ke
AudioFormat.ENCODING_PCM_16BIT
jika Anda telah mengonfigurasi decoder untuk menghasilkan PCM multi-saluran.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();
Uji audio spasial
Pastikan audio spasial diaktifkan di perangkat pengujian Anda:
- Untuk headset berkabel, buka Setelan sistem > Suara & getaran > Audio spasial.
- Untuk headset nirkabel, buka Setelan sistem > Perangkat terhubung > ikon roda gigi untuk perangkat nirkabel Anda > Audio spasial.
Untuk memeriksa ketersediaan Audio Spasial untuk perutean saat ini, jalankan
perintah adb shell dumpsys audio
di perangkat Anda. Anda akan melihat parameter
berikut dalam output saat pemutaran aktif:
Spatial audio:
mHasSpatializerEffect:true (effect present)
isSpatializerEnabled:true (routing dependent)