Atributos de áudio

Os reprodutores de áudio suportam atributos que definem como o sistema de áudio lida com decisões de roteamento, volume e foco para a fonte especificada. Os aplicativos podem anexar atributos a uma reprodução de áudio (como música tocada por um serviço de streaming ou uma notificação para um novo e-mail) e depois passar os atributos da fonte de áudio para a estrutura, onde o sistema de áudio usa os atributos para tomar decisões de mixagem e notificar os aplicativos. sobre o estado do sistema.

No Android 4.4 e versões anteriores, a estrutura tomava decisões de mixagem usando apenas o tipo de fluxo de áudio. No entanto, basear tais decisões no tipo de fluxo era muito limitante para produzir resultados de qualidade em vários aplicativos e dispositivos. Por exemplo, em um dispositivo móvel, alguns aplicativos (por exemplo, Google Maps) reproduziam instruções de direção no tipo de fluxo STREAM_MUSIC; entretanto, em dispositivos móveis no modo de projeção (ou seja, Android Auto), os aplicativos não podem misturar instruções de direção com outros fluxos de mídia.

Usando a API Audio Attribute , os aplicativos fornecem ao sistema de áudio informações detalhadas sobre uma fonte de áudio específica, incluindo uso (por que a fonte está sendo reproduzida), tipo de conteúdo (o que a fonte está reproduzindo), sinalizadores (como a fonte deve ser reproduzida), e contextos (novo no Android 9). Sintaxe:

AudioAttributes {
    mUsage
    mContentType
    mSource
    mFlags
    mTags / mFormattedTags / mBundle    (key value pairs)
}

• Uso . Especifica por que a fonte está sendo reproduzida e controla as decisões de roteamento, foco e volume.
• Tipo de conteúdo . Especifica qual fonte está sendo reproduzida (música, filme, fala, sonificação, desconhecido).
• Contexto . Valores de uso abstraídos para o HAL de áudio.
• Bandeiras . Especifica como a fonte deve ser reproduzida. Inclui suporte para aplicação de audibilidade (sons do obturador da câmera exigidos em alguns países) e sincronização de áudio/vídeo por hardware.

Para processamento dinâmico, os aplicativos devem distinguir entre conteúdo de filme, música e fala. As informações sobre os dados em si também podem ser importantes, como volume e valor de pico da amostra.

Usar atributos

O uso especifica o contexto no qual o fluxo é usado, fornecendo informações sobre por que o som está sendo reproduzido e para que serve o som. As informações de uso são mais expressivas do que um tipo de fluxo e permitem que plataformas ou políticas de roteamento refinem decisões de volume ou roteamento.

Forneça um dos seguintes valores de uso para qualquer instância:

• USAGE_UNKNOWN
• USAGE_MEDIA
• USAGE_VOICE_COMMUNICATION
• USAGE_VOICE_COMMUNICATION_SIGNALLING
• USAGE_ALARM
• USAGE_NOTIFICATION
• USAGE_NOTIFICATION_TELEPHONY_RINGTONE
• USAGE_NOTIFICATION_COMMUNICATION_REQUEST
• USAGE_NOTIFICATION_COMMUNICATION_INSTANT
• USAGE_NOTIFICATION_COMMUNICATION_DELAYED
• USAGE_NOTIFICATION_EVENT
• USAGE_ASSISTANCE_ACCESSIBILITY
• USAGE_ASSISTANCE_NAVIGATION_GUIDANCE
• USAGE_ASSISTANCE_SONIFICATION
• USAGE_GAME
• USAGE_VIRTUAL_SOURCE
• USAGE_ASSISTANT

Os valores de uso do atributo de áudio são mutuamente exclusivos. Para obter exemplos, consulte as definições USAGE_MEDIA e USAGE_ALARM ; para exceções, consulte a definição AudioAttributes.Builder .

Tipo de conteúdo

O tipo de conteúdo define qual é o som e expressa a categoria geral do conteúdo, como filme, fala ou bipe/toque. A estrutura de áudio usa informações de tipo de conteúdo para configurar seletivamente blocos de pós-processamento de áudio. Embora o fornecimento do tipo de conteúdo seja opcional, você deve incluir informações de tipo sempre que o tipo de conteúdo for conhecido, como usar CONTENT_TYPE_MOVIE para um serviço de streaming de filmes ou CONTENT_TYPE_MUSIC para um aplicativo de reprodução de música.

Forneça um dos seguintes valores de tipo de conteúdo para qualquer instância:

• CONTENT_TYPE_UNKNOWN (padrão)
• CONTENT_TYPE_MOVIE
• CONTENT_TYPE_MUSIC
• CONTENT_TYPE_SONIFICATION
• CONTENT_TYPE_SPEECH

Os valores do tipo de conteúdo do atributo de áudio são mutuamente exclusivos. Para obter detalhes sobre os tipos de conteúdo, consulte a API do atributo de áudio .

Contextos

Cada som no Android é identificado pelo aplicativo responsável e pelo motivo da geração do som; e o dispositivo Android usa essas informações para determinar como apresentar o som. No Android 8.x e versões anteriores, os aplicativos podem relatar o motivo da geração de som usando tipos de stream herdados (por exemplo, AudioSystem.STREAM_MUSIC ) ou AudioAttributes . No Android 9, os valores AudioAttributes.usage são abstraídos no nível HAL como Contexts .

Você pode fornecer um dos seguintes valores CONTEXT_NUMBER para qualquer instância:

• MUSIC_CONTEXT // Reprodução de música
• NAVIGATION_CONTEXT // Direções de navegação
• VOICE_COMMAND_CONTEXT // Sessão de comando de voz
• CALL_RING_CONTEXT // Chamada de voz tocando
• CALL_CONTEXT // Chamada de voz
• ALARM_CONTEXT // Som de alarme do Android
• NOTIFICATION_CONTEXT // Notificações
• SYSTEM_SOUND_CONTEXT // Sons de interação do usuário (cliques em botões, etc)

Bandeiras

Os sinalizadores especificam como a estrutura de áudio aplica efeitos à reprodução de áudio. Forneça um ou mais dos seguintes sinalizadores para uma instância:

• FLAG_AUDIBILITY_ENFORCED . Solicita ao sistema que garanta a audibilidade do som. Use para atender às necessidades do legado STREAM_SYSTEM_ENFORCED (como forçar sons do obturador da câmera).
• HW_AV_SYNC . Solicita que o sistema selecione um fluxo de saída que suporte sincronização A/V de hardware.

Os sinalizadores de atributos de áudio não são exclusivos e podem ser combinados. Para obter detalhes sobre esses sinalizadores, consulte a API do atributo de áudio .

Exemplo

Neste exemplo, AudioAttributes.Builder define os AudioAttributes a serem usados ​​por uma nova instância AudioTrack :

AudioTrack myTrack = new AudioTrack(
  new AudioAttributes.Builder()
 .setUsage(AudioAttributes.USAGE_MEDIA)
    .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
    .build(),
  myFormat, myBuffSize, AudioTrack.MODE_STREAM, mySession);

Compatibilidade

Os desenvolvedores de aplicativos devem usar atributos de áudio ao criar ou atualizar aplicativos para Android 5.0 e versões posteriores. Entretanto, os aplicativos não são obrigados a aproveitar os atributos; eles podem lidar apenas com tipos de fluxo herdados ou permanecer inconscientes dos atributos (ou seja, um reprodutor de mídia genérico que não sabe nada sobre o conteúdo que está reproduzindo).

Nesses casos, a estrutura mantém compatibilidade retroativa com dispositivos mais antigos e versões do Android, traduzindo automaticamente tipos de fluxo de áudio legados em atributos de áudio. No entanto, a estrutura não impõe nem garante esse mapeamento entre dispositivos, fabricantes ou versões do Android.

Mapeamentos de compatibilidade:

Tipos de fluxo obsoletos

O Android 9 descontinua os seguintes tipos de stream para uso automotivo:

• STREAM_DEFAULT
• STREAM_VOICE_CALL
• STREAM_SYSTEM
• STREAM_RING
• STREAM_MUSIC
• STREAM_ALARM
• STREAM_NOTIFICATION
• STREAM_BLUETOOTH_SCO
• STREAM_SYSTEM_ENFORCED
• STREAM_DTMF
• STREAM_TTS
• STREAM_ACCESSIBILITY

Para mais detalhes, veja Áudio Automotivo .