Android16音频之获取音频时间戳AudioTrack.getTimestamp：用法实例(一百三十九)

简介： 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.getTimestamp介绍](#🌻2. Android16进阶之获取音频时间戳AudioTrack.getTimestamp介绍)
  - [🌻3. 代码实例](#🌻3. 代码实例)
  - - [🌻3.1 完整流程：视频唇音同步](#🌻3.1 完整流程：视频唇音同步)
    - [🌻3.2 完整流程：直播精准进度条](#🌻3.2 完整流程：直播精准进度条)
    - [🌻3.3 完整流程：性能分析时钟漂移](#🌻3.3 完整流程：性能分析时钟漂移)
  - [🌻3.4 用法总结](#🌻3.4 用法总结)

🌻1. 前言

本篇目的：Android16进阶之获取音频时间戳AudioTrack.getTimestamp：用法实例

🌻2. Android16进阶之获取音频时间戳AudioTrack.getTimestamp介绍

基本概念

getTimestamp通过AudioTrack.AudioTimestamp对象返回系统级播放时钟（nanoTime）及对应帧位置，用于唇音同步、A/V对齐、精准进度计算，误差<1 ms。
功能

返回AudioTimestamp对象；含framePosition与nanoTime；与系统时钟独立；无需权限；适用于任意传输模式。
使用限制

需在play()后调用；若不支持返回false；与采样率、声道数无关；与getPlaybackHeadPosition互补；部分蓝牙设备延迟较大。
性能特性

直接读取共享内存时钟；无JNI阻塞；耗时<0.1 ms；与硬件输出同步；内存恒定。
使用场景

视频唇音同步、直播对齐、精准进度条、性能分析。

🌻3. 代码实例

🌻3.1 完整流程：视频唇音同步

java 复制代码

AudioTrack track = new AudioTrack.Builder()
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(48000)
                .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO)
                .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
                .build())
        .setBufferSizeInBytes(65536)
        .build();
track.play();
track.write(pcmData, 0, pcmData.length);
AudioTimestamp ts = new AudioTimestamp();
if (track.getTimestamp(ts)) {
    long audioFrame = ts.framePosition;
    long audioNano = ts.nanoTime;
    long videoFrame = getVideoFrameAt(audioNano);
    syncVideoTo(videoFrame);
}

代码功能：读取音频时钟及帧位置，对齐视频帧，实现<1 ms唇音同步。

🌻3.2 完整流程：直播精准进度条

java 复制代码

AudioTrack live = new AudioTrack.Builder()
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(44100)
                .setChannelMask(AudioFormat.CHANNEL_OUT_STEREO)
                .setEncoding(AudioFormat.ENCODING_PCM_FLOAT)
                .build())
        .setBufferSizeInBytes(32768)
        .build();
live.play();
live.write(floatPcm, 0, floatPcm.length);
AudioTimestamp ts = new AudioTimestamp();
if (live.getTimestamp(ts)) {
    long ms = (ts.framePosition * 1000) / 44100;
    progressBar.setProgress((int) ms);
}

代码功能：利用nanoTime对齐UI线程，精准刷新进度条。

🌻3.3 完整流程：性能分析时钟漂移

java 复制代码

AudioTrack track = new AudioTrack.Builder()
        .setAudioFormat(new AudioFormat.Builder()
                .setSampleRate(16000)
                .setChannelMask(AudioFormat.CHANNEL_OUT_MONO)
                .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
                .build())
        .setBufferSizeInBytes(640)
        .build();
track.play();
track.write(voipBuf, 0, voipBuf.length);
AudioTimestamp ts = new AudioTimestamp();
if (track.getTimestamp(ts)) {
    long drift = System.nanoTime() - ts.nanoTime;
    Log.i("Perf", "时钟漂移=" + (drift / 1000000.0) + " ms");
}

代码功能：对比系统时钟与音频时钟，测量底层延迟，用于性能调优。

🌻3.4 用法总结

代码关键字	功能描述	典型应用
getTimestamp(ts)	帧+纳秒	唇音同步
getTimestamp(ts)	精准时间	进度条
getTimestamp(ts)	时钟漂移	性能分析