Android16音频之设置音频属性AudioTrack.Builder().setAudioAttributes：用法实例(一百一十九)

简介： CSDN博客专家、《Android系统多媒体进阶实战》作者

博主新书推荐：《Android系统多媒体进阶实战》🚀
Android Audio工程师专栏地址：Audio工程师进阶系列【原创干货持续更新中...... 】🚀
Android多媒体专栏地址：多媒体系统工程师系列【原创干货持续更新中...... 】🚀
推荐1：AAOS车载系统+AOSP14系统攻城狮入门视频实战课 🚀
推荐2：Android14 Binder之HIDL与AIDL通信实战课 🚀
推荐3：Android15快速自定义与集成音效实战课 🚀
推荐4：Android15音频策略实战课 🚀

人生格言： 人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.
更多原创,欢迎关注：Android系统攻城狮

🍉🍉🍉文章目录🍉🍉🍉

- - [🌻1. 前言](#🌻1. 前言)
  - [🌻2. Android16进阶之设置音频属性AudioTrack.Builder().setAudioAttributes介绍](#🌻2. Android16进阶之设置音频属性AudioTrack.Builder().setAudioAttributes介绍)
  - [🌻3. 代码实例](#🌻3. 代码实例)
  - - [🌻3.1 使用setAudioAttributes设置媒体属性](#🌻3.1 使用setAudioAttributes设置媒体属性)
    - [🌻3.2 使用setAudioAttributes设置通话属性](#🌻3.2 使用setAudioAttributes设置通话属性)
    - [🌻3.3 使用setAudioAttributes设置游戏属性](#🌻3.3 使用setAudioAttributes设置游戏属性)
  - [🌻3.4 用法总结](#🌻3.4 用法总结)

🌻1. 前言

本篇目的：Android16进阶之设置音频属性AudioTrack.Builder().setAudioAttributes：用法实例

🌻2. Android16进阶之设置音频属性AudioTrack.Builder().setAudioAttributes介绍

基本概念

setAudioAttributes通过AudioTrack.Builder设置音频流用途、内容类型与策略，系统据此选择路由、焦点、音量、震动策略，替代旧版streamType。
功能

支持USAGE_MEDIA USAGE_VOICE_COMMUNICATION USAGE_GAME等；可标记CONTENT_TYPE_MUSIC CONTENT_TYPE_SPEECH；与音频焦点、设备路由联动；无需权限；立即生效。
使用限制

需API 21及以上；与setLegacyStreamType互斥；内容类型缺省为CONTENT_TYPE_UNKNOWN；通话流需配合MODE_IN_COMMUNICATION；与allowedCapturePolicy联动。
性能特性

Builder链式调用；无JNI阻塞；构建延迟低于1毫秒；与AudioTrack生命周期同步；内存占用恒定。
使用场景

低延迟播放、VoIP通话、游戏音效、音乐播放器。

🌻3. 代码实例

🌻3.1 使用setAudioAttributes设置媒体属性

应用场景

音乐播放器构建低延迟输出。
用法实例

java 复制代码

AudioAttributes attr = new AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_MEDIA)
        .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
        .build();
AudioTrack track = new AudioTrack.Builder()
        .setAudioAttributes(attr)
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(48000)
                .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO)
                .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
                .build())
        .setBufferSizeInBytes(4096)
        .build();

代码功能：声明媒体用途，系统走媒体音量并可选外放或耳机。

🌻3.2 使用setAudioAttributes设置通话属性

应用场景

VoIP通话建立低延迟语音流。
用法实例

java 复制代码

AudioAttributes attr = new AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_VOICE_COMMUNICATION)
        .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
        .build();
AudioTrack track = new AudioTrack.Builder()
        .setAudioAttributes(attr)
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(16000)
                .setChannelMask(AudioFormat.CHANNEL_OUT_MONO)
                .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
                .build())
        .setBufferSizeInBytes(640)
        .build();

代码功能：声明语音通信，系统走通话音量并启用回声消除路由。

🌻3.3 使用setAudioAttributes设置游戏属性

应用场景

游戏短音效播放，需低延迟。
用法实例

java 复制代码

AudioAttributes attr = new AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_GAME)
        .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
        .build();
AudioTrack track = new AudioTrack.Builder()
        .setAudioAttributes(attr)
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(44100)
                .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO)
                .setEncoding(AudioFormat.ENCODING_PCM_FLOAT)
                .build())
        .setBufferSizeInBytes(2048)
        .build();

代码功能：声明游戏用途，系统选小缓冲区路径，降低延迟。

🌻3.4 用法总结

代码关键字	功能描述	典型应用
setAudioAttributes USAGE_MEDIA	媒体属性	音乐播放
setAudioAttributes USAGE_VOICE_COMMUNICATION	通话属性	VoIP语音
setAudioAttributes USAGE_GAME	游戏属性	音效输出