Audio Spasial adalah pengalaman audio imersif yang menempatkan pengguna di pusat tindakan, sehingga membuat konten Anda terdengar lebih realistis. Suara "dispasialkan" untuk menciptakan efek multi-speaker, mirip dengan penyiapan suara surround, tetapi melalui headphone.
Misalnya, dalam film, suara mobil mungkin dimulai di belakang pengguna, bergerak maju, dan bergerak ke kejauhan. Dalam 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 Android 13 (API level 33).
Kueri terkait kemampuan
Gunakan class Spatializer
untuk
mengkueri kemampuan dan perilaku spasial perangkat. Mulailah dengan mengambil
instance Spatializer
dari
AudioManager
:
Kotlin
val spatializer = audioManager.spatializer
Java
Spatializer spatializer = AudioManager.getSpatializer();
Setelah 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 spasialisasi tersedia? Ketersediaan bergantung pada kompatibilitas dengan perutean output audio saat ini. |
isAvailable() adalah true |
Apakah spasialisasi diaktifkan? | isEnabled() adalah true |
Dapatkah trek audio dengan parameter tertentu dispasialkan? | canBeSpatialized() adalah true |
Kondisi tersebut 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 pelacak kepala
tersedia untuk pemilihan rute 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 memerlukan AudioAttributes
dan AudioFormat
, yang keduanya
dijelaskan secara lebih mendetail di bawah ini.
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
Anda. 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 spasial untuk menonaktifkan spasialisasi sepenuhnya dengan memanggil
setSpatializationBehavior(AudioAttributes.SPATIALIZATION_BEHAVIOR_NEVER)
.
AudioFormat
Objek AudioFormat
menjelaskan
detail 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 spasialisasi default untuk mendapatkan panduan tentang
nilai tertentu yang akan digunakan.
Proses perubahan pada Spatializer
Untuk memproses perubahan status Spatializer
, Anda dapat menambahkan pemroses
dengan Spatializer.addOnSpatializerStateChangedListener()
.
Demikian pula, untuk memproses perubahan ketersediaan pelacak kepala,
panggil Spatializer.addOnHeadTrackerAvailableListener()
.
Hal ini dapat berguna jika Anda ingin menyesuaikan pilihan trek selama pemutaran
menggunakan callback pemroses. Misalnya, saat pengguna menghubungkan atau memutuskan koneksi
headset dari perangkat, callback onSpatializerAvailableChanged
akan menunjukkan apakah efek spatializer tersedia untuk perutean output audio
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 mempermudah penggunaan 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 memperbarui dependensi ExoPlayer Anda ke rilis terbaru, aplikasi Anda hanya perlu menyertakan konten yang dapat dispasialisasi.
Batasan jumlah saluran audio
Saat keempat kondisi untuk audio spasial terpenuhi, ExoPlayer memilih
trek audio multi-saluran. Jika tidak, ExoPlayer akan 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 saluran 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 seperti 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 menonaktifkan batasan jumlah saluran audio, jika konten memiliki beberapa trek audio, ExoPlayer pada awalnya akan 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
Saat perilaku batasan jumlah saluran audio ExoPlayer dinonaktifkan, ExoPlayer tidak secara 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 terkait jenis MIME (encoding), jumlah saluran, dan frekuensi sampel.
Mengubah parameter pemilihan trek
Untuk mengubah parameter pemilihan jalur ExoPlayer, gunakan
Player.setTrackSelectionParameters()
.
Demikian pula, 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 cara menyesuaikan parameter pemilihan jalur pemain tersedia di bagian pemilihan jalur pada dokumen ExoPlayer.
Perilaku spasial default
Perilaku spasialisasi default di Android mencakup perilaku berikut yang dapat disesuaikan oleh OEM:
Hanya konten multi-channel yang memiliki spasial, 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 sejumlah besar. Hal ini memastikan bahwa dekoder audio menghasilkan PCM multi-saluran agar platform dapat melakukan spasialisasi.
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 spasial 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. Pada 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 spatial.
- Untuk headset nirkabel, buka Setelan sistem > Perangkat terhubung > Ikon roda gigi untuk perangkat nirkabel > Audio spasial.
Guna 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)