O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

Atributos de áudio

Os players de áudio são compatíveis com atributos que definem como o sistema de áudio de roteamento, volume e foco da origem especificada. Aplicativos é possível acrescentar atributos a uma reprodução de áudio (como música tocada por um um serviço de streaming ou uma notificação sobre um novo e-mail) e, em seguida, transmita o áudio atributos de origem para o framework, em que o sistema de áudio usa os atributos para tomar decisões mistas e notificar os aplicativos sobre o estado da sistema.

No Android 4.4 e versões anteriores, o framework tomava decisões combinadas usando apenas o tipo de stream de áudio. No entanto, basear essas decisões no tipo de fluxo era muito com limitações para produzir resultados de qualidade em vários aplicativos e dispositivos. Por exemplo, em um dispositivo móvel, alguns aplicativos (como o Google Maps) abriram rotas de carro no tipo de fluxo STREAM_MUSIC; No entanto, em dispositivos móveis, no modo de projeção (ou seja, Android Auto), os aplicativos não podem misturar condutores direções por outros streams de mídia.

Usar o Áudio Attribute API, os aplicativos fornecem ao sistema de áudio informações sobre uma fonte de áudio específica, incluindo o uso (por que a fonte é reproduzindo), tipo de conteúdo (o que a fonte está reproduzindo), sinalizações (como a fonte está tocando) deve ser reproduzido) e contextos (novidade no Android 9). Sintaxe:

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

Uso. Especifica por que a fonte está tocando e controla de roteamento, foco e volume.
Tipo de conteúdo: Especifica o que a fonte está tocando (música, filme, fala, sonificação, desconhecido).
Context. Valores de uso abstraídos para a HAL de áudio.
Sinalizações. Especifica como a fonte deve ser reproduzida. Inclui suporte para aplicação de audibilidade (som do obturador da câmera necessários em alguns países) e a sincronização de áudio/vídeo de hardware.

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

Usar atributos

Uso especifica o contexto em que o stream é usado, fornecendo informações sobre por que o som está tocando e para que ele é usado. As informações de uso são mais expressivas do que um tipo de stream e permitem que as plataformas políticas de roteamento ou de roteamento para refinar 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_NOTIFICAÇÃO
USAGE_notification_TELEPHONY_RINGTONE
USAGE_notification_COMMUNICATION_REQUEST
USAGE_NOTIFICAÇÃO_COMMUNICATION_INSTANT
USAGE_notification_COMMUNICATION_DELAYED
USAGE_notification_EVENT
USAGE_ASSISTANCE_ACCESSIBILITY
USAGE_ASSISTANCE_NAVIGATION_guidelines
USAGE_ASSISTANCE_SONIFICATION
USAGE_GAME
USAGE_VIRTUAL_SOURCE
USAGE_ASSISTANT

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

Tipo de conteúdo

O tipo de conteúdo define o som e expressa a categoria geral do o conteúdo como filme, fala ou bipe/toque. O framework de áudio usa informações de tipo de conteúdo para configurar seletivamente o pós-processamento de áudio blocos. Embora o fornecimento do tipo de conteúdo seja opcional, você deve incluir o tipo informações 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 app 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 detalhes sobre tipos de conteúdo, consulte o áudio API de atributos.

Contextos

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

Contextos de áudio HAL	Uso de AudioAttributes
MÚSICA	MÍDIA
COMANDO_DE_VOZ	USAGE_ASSISTANT
NAVIGATION	ASSISTANCE_NAVEGAÇÃO_ORIENTAÇÃO
CALL	COMUNICAÇÃO POR VOZ
TOM	TOQUE_DE_NOTIFICAÇÃO
NOTIFICAÇÃO	NOTIFICAÇÃO
ALARME	ALARME
SOM DO SISTEMA	ASSISTÊNCIA_SONIFICAÇÃO
DESCONHECIDO	DESCONHECIDO

É possível 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
NOTE_CONTEXT // Notificações
SYSTEM_INPUT_CONTEXT // Sons de interação do usuário (cliques em botões etc.)

Flags

As flags especificam como o framework aplica efeitos à reprodução do áudio. Forneça uma ou mais das seguintes sinalizações para uma instância:

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

As flags de atributos de áudio não são exclusivas e podem ser combinadas. Para detalhes sobre essas sinalizações, consulte a áudio API de atributos.

Exemplo

Neste exemplo, AudioAttributes.Builder define AudioAttributes para ser usado por um novo AudioTrack instância:

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 o Android 5.0 e superior. No entanto, os aplicativos não são necessárias para aproveitar os atributos. eles podem lidar com tipos de streams legados ou não conhece os atributos (ou seja, um player de mídia genérico que não saber nada sobre o conteúdo que está tocando).

Nesses casos, o framework mantém a compatibilidade com versões anteriores e versões do Android traduzindo automaticamente o stream de áudio legado de tipos a atributos de áudio. No entanto, o framework não impõe nem garantem esse mapeamento entre dispositivos, fabricantes ou versões do Android.

Mapeamentos de compatibilidade:

Android 5.0 e superior	Android 4.4 e anterior
`CONTENT_TYPE_SPEECH` `USAGE_VOICE_COMMUNICATION`	`STREAM_VOICE_CALL`
`CONTENT_TYPE_SONIFICATION` `USAGE_ASSISTANCE_SONIFICATION`	`STREAM_SYSTEM`
`CONTENT_TYPE_SONIFICATION` `USAGE_NOTIFICATION_RINGTONE`	`STREAM_RING`
`CONTENT_TYPE_MUSIC` `USAGE_UNKNOWN` `USAGE_MEDIA` `USAGE_GAME` `USAGE_ASSISTANCE_ACCESSIBILITY` `USAGE_ASSISTANCE_NAVIGATION_GUIDANCE`	`STREAM_MUSIC`
`CONTENT_TYPE_SONIFICATION` `USAGE_ALARM`	`STREAM_ALARM`
`CONTENT_TYPE_SONIFICATION` `USAGE_NOTIFICATION` `USAGE_NOTIFICATION_COMMUNICATION_REQUEST` `USAGE_NOTIFICATION_COMMUNICATION_INSTANT` `USAGE_NOTIFICATION_COMMUNICATION_DELAYED` `USAGE_NOTIFICATION_EVENT`	`STREAM_NOTIFICATION`
`CONTENT_TYPE_SPEECH`	(@ocultar) `STREAM_BLUETOOTH_SCO`
`FLAG_AUDIBILITY_ENFORCED`	(@ocultar) `STREAM_SYSTEM_ENFORCED`
`CONTENT_TYPE_SONIFICATION` `USAGE_VOICE_COMMUNICATION_SIGNALLING`	(@ocultar) `STREAM_DTMF`

Tipos de stream descontinuados

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

PADRÃO_DA_STREAM
STREAM_VOICE_CALL
SISTEMA DE TRANSMISSÕES
TRANSMISSÕES AO VIVO
MÚSICA_STREAM
ALARM_STREAM
NOTIFICAÇÃO DE TRANSMISSÕES
STREAM_BLUETOOTH_SCO
SISTEMA DE TRANSMISSÕES
STREAM_DTMF
TTS_STREAM
ACESSIBILIDADE DAS TRANSMISSÕES

Para mais detalhes, consulte Áudio automotivo.