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

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

人生格言：人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.

更多原创,欢迎关注：Android系统攻城狮

欢迎关注Android系统攻城狮

文章目录

1. 前言

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

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

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

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

  3. 使用限制
    需API 21及以上；与setLegacyStreamType互斥；内容类型缺省为CONTENT_TYPE_UNKNOWN；通话流需配合MODE_IN_COMMUNICATION；与allowedCapturePolicy联动。

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

  5. 使用场景
    低延迟播放、VoIP通话、游戏音效、音乐播放器。

3. 代码实例

3.1 使用setAudioAttributes设置媒体属性

  1. 应用场景
    音乐播放器构建低延迟输出。

  2. 用法实例

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设置通话属性

  1. 应用场景
    VoIP通话建立低延迟语音流。

  2. 用法实例

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设置游戏属性

  1. 应用场景
    游戏短音效播放，需低延迟。

  2. 用法实例

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游戏属性音效输出