Attributs audio

Les lecteurs audio sont compatibles avec les attributs qui définissent la manière dont le système audio gère de routage, de volume et de ciblage pour la source spécifiée. Applications vous pouvez associer des attributs à une lecture audio (comme la musique jouée par service de streaming ou une notification pour un nouvel e-mail), puis transmettre le son les attributs sources au framework, où le système audio utilise les attributs pour prendre des décisions de combinaison et pour informer les applications de l'état du du système d'exploitation.

Remarque:Les applications peuvent également joindre à un enregistrement audio (par exemple, du contenu audio capturé dans une vidéo d'enregistrement), mais cette fonctionnalité n'est pas disponible dans l'API publique.

Dans Android 4.4 et versions antérieures, le framework a pris des décisions de combinaison en n'utilisant le type de flux audio. Toutefois, baser ces décisions sur le type de flux était trop pour produire un résultat de qualité sur plusieurs applications et appareils. Par exemple, sur un appareil mobile, certaines applications (comme Google Maps) jouaient les itinéraires routiers sur le type de flux STREAM_MUSIC ; Toutefois, sur les appareils mobiles, en mode projection (Android Auto), les applications ne peuvent pas utiliser la même conduite des directions avec d'autres flux multimédias.

Avec les Audio Attribute d'une API, les applications fournissent au système audio des informations détaillées des informations sur une source audio spécifique, y compris son utilisation (pourquoi la source est de lecture), le type de contenu (ce que la source lit), les indicateurs (comment la source à lire) et les contextes (nouveauté d'Android 9). Syntaxe:

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

• Utilisation. Spécifie la raison pour laquelle la source est lue et les commandes en matière de routage, d'orientation et de volume.
• Type de contenu : Spécifie ce que la source lit (musique, film, voix, sonification, inconnue).
• Contexte. Valeurs d'utilisation extraites dans le HAL audio.
• Indicateurs : Spécifie la manière dont la source doit être lue. Compatible avec l'application de l'audibilité (son de l'obturateur de l'appareil photo est requis dans certains pays) et la synchronisation audio/vidéo matérielle.

Pour le traitement dynamique, les applications doivent faire la distinction entre les films, et contenus vocaux. Les informations sur les données elles-mêmes peuvent également avoir leur importance, par exemple : le volume sonore et la valeur maximale d'échantillon.

Utiliser des attributs

"Utilisation" spécifie le contexte dans lequel le flux est utilisé des informations sur les raisons pour lesquelles le son est diffusé et à quoi il sert. Les informations d'utilisation sont plus expressives qu'un type de flux et permettent aux plates-formes ou règles de routage pour affiner les décisions de volume ou de routage.

Indiquez l'une des valeurs d'utilisation suivantes pour n'importe quelle instance:

• UTILISATION_INCONNUE
• USAGE_MEDIA
• COMMUNICATION VOCALE D'UTILISATION
• SIGNALLING_VOICE_COMMUNICATION_USAGE
• ALARME_USAGE
• NOTIFICATION_D'UTILISATION
• TÉLÉPHONIE_DE_NOTIFICATION_D'UTILISATION
• DEMANDE_DE_COMMUNICATION_D'USAGE_NOTIFICATIONS
• USAGE_NOTIFICATION_COMMUNICATION_INSTANT
• USAGE_NOTIFICATION_COMMUNICATION_DELAYED
• USAGE_NOTIFICATION_EVENT
• USAGE_ASSISTANCE_ACCESSIBILITY
• USAGE_ASSISTANCE_NAVIGATION_guidelines
• SONIFICATION_ASSISTANCE_D'UTILISATION
• JEU_D'UTILISATION
• USAGE_VIRTUAL_SOURCE
• ASSISTANT_D'UTILISATION

Les valeurs d'utilisation de l'attribut audio s'excluent mutuellement. Pour obtenir des exemples, consultez USAGE_MEDIA et USAGE_ALARM définitions ; Pour connaître les exceptions, consultez la AudioAttributes.Builder définition.

Type de contenu

Le type de contenu définit le son et exprime la catégorie générale le contenu (film, discours ou sonnerie/sonnerie, par exemple). Le framework audio utilise des informations sur le type de contenu pour configurer de manière sélective le post-traitement de l'audio blocs. Bien que la spécification du type de contenu soit facultative, vous devez inclure le type des informations chaque fois que le type de contenu est connu, par exemple en utilisant CONTENT_TYPE_MOVIE pour un service de streaming de films ou CONTENT_TYPE_MUSIC pour une application de lecture de musique

Fournissez l'une des valeurs de type de contenu suivantes pour n'importe quelle instance:

• CONTENT_TYPE_UNKNOWN (par défaut)
• CONTENT_TYPE_MOVIE
• CONTENT_TYPE_MUSIC
• CONTENT_TYPE_SONIFICATION
• CONTENT_TYPE_SPEECH

Les valeurs du type de contenu des attributs audio s'excluent mutuellement. Pour en savoir plus sur les types de contenus, reportez-vous au audio d'attribut.

Contexts (Contextes)

Chaque son dans Android est identifié par l'application responsable et le motif pour générer le son, et l'appareil Android utilise ces informations pour déterminer comment présenter le son. Dans Android 8.x et versions antérieures, les applications peuvent signaler le motif de génération du son en utilisant d'anciens types de flux (par exemple, AudioSystem.STREAM_MUSIC) ou AudioAttributes. Dans Android 9, valeurs AudioAttributes.usage sont extraites au niveau du HAL en tant que contextes.

Contextes audio HAL	Utilisation d'AudioAttributes
MUSIQUE	CONTENU MULTIMÉDIA
COMMANDE_VOCALE	ASSISTANT_D'UTILISATION
NAVIGATION	CONSEILS_NAVIGATION_ASSISTANCE
APPELER	COMMUNICATION VOCALE
SONNER	NOTIFICATION_SONNERIE
NOTIFICATION	NOTIFICATION
ALARME	ALARME
SON SYSTÈME	SONIFICATION_ASSISTANCE
INCONNUE	INCONNUE

Vous pouvez indiquer l'une des valeurs CONTEXT_NUMBER suivantes pour les Instance:

• MUSIC_CONTEXT // Lecture de la musique
• NAVIGATION_CONTEXT // Itinéraires de navigation
• VOICE_COMMAND_CONTEXT // Session de commande vocale
• CALL_RING_CONTEXT // Sonnerie des appels vocaux
• CALL_CONTEXT // Appel vocal
• ALARM_CONTEXT // Son de l'alarme Android
• NOTIFICATION_CONTEXT // Notifications
• SYSTEM_Sound_CONTEXT // Sons d'interaction de l'utilisateur (clics sur un bouton, etc.)

Drapeaux

Les options spécifient la manière dont le framework audio applique des effets à la lecture audio. Fournissez une ou plusieurs des options suivantes pour une instance:

• FLAG_AUDIBILITY_ENFORCED Demande au système de s'assurer que l'audibilité du son. Pour répondre aux besoins des clients existants STREAM_SYSTEM_ENFORCED (par exemple, en forçant le son de l'obturateur de l'appareil photo).
• HW_AV_SYNC Demande au système de sélectionner un flux de sortie qui prend en charge la synchronisation A/V du matériel.

Les indicateurs d'attributs audio ne sont pas exclusifs et peuvent être combinés. Pour en savoir plus sur ces options, reportez-vous à la audio d'attribut.

Exemple

Dans cet exemple, AudioAttributes.Builder définit AudioAttributes à utiliser par un nouveau AudioTrack Instance:

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

Compatibilité

Les développeurs d'applications doivent utiliser des attributs audio lors de la création ou de la mise à jour pour Android 5.0 et versions ultérieures. Cependant, les applications ne sont pas pour tirer parti des attributs ; ils peuvent gérer d'anciens types de flux ou ignorer certains attributs (c'est-à-dire un lecteur multimédia générique vous n'en savez rien sur le contenu diffusé).

Dans de tels cas, le framework conserve la rétrocompatibilité appareils et versions Android en traduisant automatiquement les anciens flux audio aux attributs audio. Cependant, le framework n'applique pas ce mappage entre les appareils, les fabricants et les versions d'Android.

Mappages de compatibilité:

Android 5.0 ou version ultérieure	Android 4.4 et versions antérieures
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	(@masquer) STREAM_BLUETOOTH_SCO
FLAG_AUDIBILITY_ENFORCED	(@masquer) STREAM_SYSTEM_ENFORCED
CONTENT_TYPE_SONIFICATION USAGE_VOICE_COMMUNICATION_SIGNALLING	(@masquer) STREAM_DTMF

Remarque:Les flux @hide sont utilisés en interne par du framework, mais ne font pas partie de l'API publique.

Types de flux obsolètes

Android 9 abandonne les types de flux suivants pour utilisation automobile:

• STREAM_DEFAULT
• APPEL_VOIX_DIFFUSION
• SYSTÈME DE DIFFUSION
• ANNEAU_DIFFUSION
• MUSIQUE_STREAMING
• ALARME_FLUX
• NOTIFICATION_STREAM
• FLUX_BLUETOOTH_SCO
• FLUX_SYSTEM_ENFORCÉ
• STREAM_DTMF
• FLUX_TTS
• ACCESSIBILITÉ_DIFFUSION

Pour en savoir plus, consultez Audio pour voitures.