Audio spaziale

L'audio spaziale è un'esperienza audio immersiva che mette gli utenti al centro centro dell'azione, rendendo i tuoi contenuti più realistici. Il suono è "spazializzato" per creare un effetto multi-speaker, simile all'audio surround ma tramite le cuffie.

Ad esempio, in un film, il suono di un'auto potrebbe iniziare dietro l'utente, spostare in avanti e scivolare verso la distanza. In una videochiamata, le voci possono essere separate e posizionate intorno all'utente, consentendo l'identificazione più facilmente della persona.

Se i tuoi contenuti utilizzano un formato audio supportato, puoi aggiungere l'audio spaziale al tuo a partire da Android 13 (livello API 33).

Query sulle capacità

Utilizza il corso Spatializer per interrogare le funzionalità e il comportamento di spazializzazione del dispositivo. Inizia recuperando un'istanza di Spatializer dall'istanza AudioManager:

Kotlin

val spatializer = audioManager.spatializer

Java

Spatializer spatializer = AudioManager.getSpatializer();

Dopo aver ricevuto Spatializer, controlla le quattro condizioni che devono essere valide true per il dispositivo per riprodurre l'audio spaziale:

Criteri	Assegno
Il dispositivo supporta la spazializzazione?	getImmersiveAudioLevel() non è SPATIALIZER_IMMERSIVE_LEVEL_NONE
La spazializzazione è disponibile? La disponibilità dipende dalla compatibilità con il routing corrente dell'uscita audio.	isAvailable() è true
La spazializzazione è attivata?	isEnabled() è true
Una traccia audio con i determinati parametri può essere spaziale?	canBeSpatialized() è true

Queste condizioni potrebbero non essere soddisfatte, ad esempio se la spazializzazione non è disponibile per la traccia audio corrente o disattivata del tutto sul dispositivo di output audio.

Rilevamento dei movimenti della testa

Con le cuffie supportate, la piattaforma può regolare l'audio la spazializzazione in base alla posizione della testa dell'utente. Per controllare se un tracker per la testa è disponibile per il routing dell'uscita audio corrente, isHeadTrackerAvailable()

Nota: quando testi l'audio spaziale con tracciamento della testa su Android 13 o versioni successive, assicurati che che il tracciamento della testa sulle cuffie che stai utilizzando sia compatibile con il tuo dispositivo mobile. Ad esempio, puoi utilizzare i Pixel Buds Pro con gli smartphone Pixel.

Contenuti compatibili

Spatializer.canBeSpatialized() indica se l'audio con le proprietà specificate può essere spaziale con il l'attuale routing del dispositivo di output. Questo metodo richiede un valore AudioAttributes e AudioFormat, entrambi descritti più dettagliatamente di seguito.

AudioAttributes

Un oggetto AudioAttributes descrive l'utilizzo di un stream audio (ad esempio, audio del gioco o contenuti multimediali standard), oltre ai comportamenti di riproduzione e al tipo di contenuti.

Quando chiami canBeSpatialized(), utilizza lo stesso AudioAttributes istanza impostata per Player. Ad esempio, se stai utilizzando la libreria Jetpack Media3 e non hai personalizzato AudioAttributes, usa AudioAttributes.DEFAULT.

Nota: quando utilizzi il corso AudioAttributes Media3, assicurati di chiamare AudioAttributes.getAudioAttributesV21().audioAttributes per ottenere l'equivalente della piattaforma AudioAttributes.

Disattivare l'audio spaziale

Per indicare che i tuoi contenuti sono già stati spazializzati, chiama setIsContentSpatialized(true) in modo che l'audio non venga elaborato due volte. In alternativa, modifica il comportamento della spazializzazione per disabilitare completamente la spazializzazione chiamando setSpatializationBehavior(AudioAttributes.SPATIALIZATION_BEHAVIOR_NEVER)

AudioFormat

Un oggetto AudioFormat descrive dettagli sul formato e sulla configurazione del canale di una traccia audio.

Quando crei un'istanza di AudioFormat da passare in canBeSpatialized(), imposta la codifica uguale al formato di output previsto dal decoder. Devi inoltre impostare Una maschera del canale che corrisponda alla configurazione del canale dei tuoi contenuti. Consulta le Sezione Comportamento di spazializzazione predefinito per indicazioni su come specifici valori da utilizzare.

Monitora le modifiche a Spatializer

Per ascoltare le modifiche nello stato di Spatializer, puoi aggiungere un listener con Spatializer.addOnSpatializerStateChangedListener(). Analogamente, per ascoltare cambiamenti nella disponibilità di un tracker per la testa, chiama Spatializer.addOnHeadTrackerAvailableListener().

Questa opzione può essere utile se vuoi regolare la selezione delle tracce durante la riproduzione. usando i callback del listener. Ad esempio, quando un utente connette o disconnette il proprio le cuffie dal dispositivo, onSpatializerAvailableChanged indica se l'effetto spazializzato è disponibile per il nuovo il routing dell'uscita audio. A questo punto dovresti prendere in considerazione l'aggiornamento della logica di selezione del monitoraggio per adattarla alle nuove funzionalità del dispositivo. Per maggiori dettagli su Per il comportamento di selezione delle tracce di ExoPlayer, consulta ExoPlayer e l'audio spaziale .

ExoPlayer e audio spaziale

Le recenti versioni di ExoPlayer semplificano l'adozione dell'audio spaziale. Se utilizzi la libreria ExoPlayer autonoma (nome pacchetto com.google.android.exoplayer2), la versione 2.17 configura la piattaforma per l'uscita di audio spazializzato, mentre 2.18 introduce i limiti del numero di canali audio. Se utilizzi il modulo ExoPlayer della libreria Media3, (nome del pacchetto androidx.media3), versioni 1.0.0-beta01 e più recenti includono gli stessi aggiornamenti.

Dopo aver aggiornato la dipendenza ExoPlayer all'ultima release, l'app deve includere contenuti che possono essere spaziali.

Vincoli per il numero di canali audio

Quando vengono soddisfatte tutte e quattro le condizioni per l'audio spaziale, ExoPlayer sceglie una traccia audio multicanale. In caso contrario, ExoPlayer sceglie una traccia stereo. Se le proprietà Spatializer cambiano, ExoPlayer attiverà una nuova selezione di tracce per selezionare una traccia audio che corrisponda al proprietà correnti. Tieni presente che questa nuova selezione di tracce può causare una breve periodo di rebuffering.

Importante: il comportamento del vincolo per il numero di canali audio descritto in questa sezione si applica solo ai dispositivi portatili con Android 12L o versioni successive. Sui dispositivi meno recenti o su altri tipi di dispositivi, come Android TV, questi vincoli sono disattivati La selezione delle tracce di ExoPlayer può essere personalizzata come specificato Selezione delle tracce audio.

Per disattivare i vincoli relativi al numero di canali audio, imposta i parametri di selezione delle tracce sul player, come mostrato di seguito:

Kotlin

exoPlayer.trackSelectionParameters = DefaultTrackSelector.Parameters.Builder(context)
  .setConstrainAudioChannelCountToDeviceCapabilities(false)
  .build()

Java

exoPlayer.setTrackSelectionParameters(
  new DefaultTrackSelector.Parameters.Builder(context)
    .setConstrainAudioChannelCountToDeviceCapabilities(false)
    .build()
);

Analogamente, puoi aggiornare i parametri di un selettore di traccia esistente per disattivarli i limiti per il numero di canali audio, come indicato di seguito:

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()
);

Con i vincoli relativi al numero di canali audio disattivati se i contenuti hanno più audio tracce, ExoPlayer seleziona inizialmente la traccia con il maggior numero di canali e può essere riprodotto dal dispositivo. Ad esempio, se i contenuti includono un una traccia audio multicanale e una traccia audio stereo; il dispositivo supporta riproducendo entrambi i brani, ExoPlayer seleziona la traccia multicanale. Consulta le Selezione delle tracce audio per i dettagli su come personalizzare questo comportamento.

Selezione della traccia audio

Quando i limiti del numero di canali audio di ExoPlayer è disabilitato, ExoPlayer non seleziona automaticamente una traccia audio che corrisponde alle proprietà dello spazializzatore del dispositivo. Puoi invece personalizzare la logica di selezione delle tracce di ExoPlayer impostando la selezione delle tracce prima o durante la riproduzione. Per impostazione predefinita, ExoPlayer seleziona audio tracce equivalenti alla traccia iniziale per quanto riguarda il tipo MIME (codifica), conteggio canali e frequenza di campionamento.

Modificare i parametri di selezione delle tracce

Per modificare i parametri di selezione delle tracce di ExoPlayer, utilizza Player.setTrackSelectionParameters() Allo stesso modo, puoi ottenere i parametri attuali di ExoPlayer con Player.getTrackSelectionParameters() Ad esempio, per selezionare una traccia audio stereo durante la riproduzione:

Kotlin

exoPlayer.trackSelectionParameters = exoPlayer.trackSelectionParameters
  .buildUpon()
  .setMaxAudioChannelCount(2)
  .build()

Java

exoPlayer.setTrackSelectionParameters(
  exoPlayer.getTrackSelectionParameters()
    .buildUpon()
    .setMaxAudioChannelCount(2)
    .build()
);

Tieni presente che la modifica dei parametri di selezione delle tracce durante la riproduzione potrebbe causare un durante la riproduzione. Ulteriori informazioni sulla regolazione della traccia del player è disponibile in selezione delle tracce della documentazione di ExoPlayer.

Comportamento di spazializzazione predefinito

Il comportamento predefinito della spazializzazione in Android include i seguenti comportamenti che possono essere personalizzati dagli OEM:

• Solo i contenuti multicanale sono spazializzati, non i contenuti stereo. Se non utilizzi ExoPlayer, a seconda del formato della tua rete multicanale contenuti audio, potresti dover configurare il numero massimo di canali che può essere emesso da un decoder audio a un numero elevato. Ciò garantisce che il decoder audio emette un PCM multicanale affinché la piattaforma possa spazializzare.

  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);
  

  Per un esempio pratico, vedi MediaCodecAudioRenderer.java di ExoPlayer. Disattivare la spazializzazione autonomamente, indipendentemente dall'OEM personalizzazione, vedi Disattivare l'audio spaziale.

• AudioAttributes: l'audio è idoneo per la spazializzazione se usage è impostato su USAGE_MEDIA o USAGE_GAME.

• AudioFormat: utilizza una maschera del canale contenente almeno i AudioFormat.CHANNEL_OUT_QUAD canali (anteriore sinistro, anteriore destro, retro sinistro e posteriore destro) per l'audio essere idonei per la spazializzazione. Nell'esempio riportato di seguito, utilizziamo AudioFormat.CHANNEL_OUT_5POINT1 per una traccia audio 5.1. Per una traccia audio stereo, usa AudioFormat.CHANNEL_OUT_STEREO.

  Se utilizzi Media3, puoi usare Util.getAudioTrackChannelConfig(int channelCount) per convertire un conteggio dei canali in una maschera del canale.

  Inoltre, imposta la codifica su AudioFormat.ENCODING_PCM_16BIT se è stato configurato il decoder per l'uscita PCM multicanale.

  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();
  

Testare l'audio spaziale

Assicurati che l'audio spaziale sia abilitato sul tuo dispositivo di test:

• Per le cuffie con cavo, vai a Impostazioni di sistema > Audio e vibrazione > Spaziale audio.
• Per le cuffie wireless, vai a Impostazioni di sistema > Dispositivi connessi > Icona a forma di ingranaggio per il tuo dispositivo wireless > Audio spaziale.

Per verificare la disponibilità dell'audio spaziale per il routing attuale, esegui il comando adb shell dumpsys audio sul dispositivo. Dovresti vedere quanto segue nell'output mentre la riproduzione è attiva:

Spatial audio:
mHasSpatializerEffect:true (effect present)
isSpatializerEnabled:true (routing dependent)