Android16音频之获取Track状态AudioTrack.getState：用法实例(一百二十九)

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

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

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

🍉🍉🍉文章目录🍉🍉🍉

- - [🌻1. 前言](#🌻1. 前言)
  - [🌻2. Android16进阶之获取Track状态AudioTrack.getState介绍](#🌻2. Android16进阶之获取Track状态AudioTrack.getState介绍)
  - [🌻3. 代码实例](#🌻3. 代码实例)
  - - [🌻3.1 完整流程：媒体播放器构建校验](#🌻3.1 完整流程：媒体播放器构建校验)
    - [🌻3.2 完整流程：游戏音效构建失败重试](#🌻3.2 完整流程：游戏音效构建失败重试)
    - [🌻3.3 完整流程：VoIP释放前状态检查](#🌻3.3 完整流程：VoIP释放前状态检查)
  - [🌻3.4 用法总结](#🌻3.4 用法总结)

🌻1. 前言

本篇目的：Android16进阶之获取Track状态AudioTrack.getState：用法实例

🌻2. Android16进阶之获取Track状态AudioTrack.getState介绍

基本概念

getState返回AudioTrack生命周期状态：STATE_UNINITIALIZED、STATE_INITIALIZED、STATE_NO_STATIC_DATA、STATE_STATIC_DATA，用于判断对象是否就绪、资源分配成功。
功能

立即返回int状态；与构建结果、write()前置条件联动；线程安全；无需权限；适用于任意传输模式。
使用限制

需在构造后调用；STATE_INITIALIZED仅表示资源就绪，非播放；与getPlayState职责分离；与缓冲区大小、格式合法性相关。
性能特性

直接读取内存位；无JNI阻塞；耗时低于0.05 ms；与生命周期同步；内存恒定。
使用场景

构建失败兜底、写入前就绪检查、资源释放前验证。

🌻3. 代码实例

🌻3.1 完整流程：媒体播放器构建校验

java 复制代码

AudioTrack track = new AudioTrack.Builder()
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(44100)
                .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO)
                .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
                .build())
        .setBufferSizeInBytes(65536)
        .build();
if (track.getState() == AudioTrack.STATE_INITIALIZED) {
    track.write(pcmData, 0, pcmData.length);
    track.play();
} else {
    Log.e("Audio", "Track初始化失败");
}

代码功能：构造后立即校验状态，成功才写入播放，失败记录日志。

🌻3.2 完整流程：游戏音效构建失败重试

java 复制代码

AudioTrack sfx = new AudioTrack.Builder()
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(48000)
                .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO)
                .setEncoding(AudioFormat.ENCODING_PCM_FLOAT)
                .build())
        .setBufferSizeInBytes(2048)
        .build();
if (sfx.getState() != AudioTrack.STATE_INITIALIZED) {
    // 降级格式重试
    sfx = new AudioTrack.Builder()
            .setAudioFormat(new AudioFormat.Builder()
                    .setSampleRate(44100)
                    .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
                    .build())
            .build();
}
sfx.play();

代码功能：首次构造失败则降级采样率与位深，再次校验后播放。

🌻3.3 完整流程：VoIP释放前状态检查

java 复制代码

AudioTrack voice = new AudioTrack.Builder()
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(16000)
                .setChannelMask(AudioFormat.CHANNEL_OUT_MONO)
                .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
                .build())
        .setBufferSizeInBytes(640)
        .build();
// 挂断前确认已初始化再释放
if (voice.getState() == AudioTrack.STATE_INITIALIZED) {
    voice.stop();
    voice.release();
}

代码功能：构造-播放-挂断前用状态确认资源已就绪，避免异常。

🌻3.4 用法总结

代码关键字	功能描述	典型应用
getState == STATE_INITIALIZED	生命周期检查	媒体播放
getState != STATE_INITIALIZED	生命周期检查	格式降级
getState == STATE_INITIALIZED	生命周期检查	安全释放