如何用aad4cj解析AAC的ADTS帧头从4字节同步字到采样率识别的完整教程【免费下载链接】aad4cjaad4cj 是一个基于仓颉Cangjie语言实现的 AAC 音频码流解析与处理组件库。项目地址: https://gitcode.com/Cangjie-SIG/aad4cjaad4cj 是一个基于仓颉Cangjie语言实现的 AAC 音频码流解析与处理组件库它内置了符合 MPEG 标准的 ADTS 帧解析器。本教程带你从零开始用 aad4cj 解析 AAC 音频的 ADTS 帧头先认识 4 字节同步字再用位读取器逐位提取配置文件、采样率索引最终把采样率索引映射为 44100 Hz 这类真实采样率完整走通「ADTS 帧头解析」全流程。ADTS 帧头长什么样先看懂这 7 个字节 ADTSAudio Data Transport Stream是 AAC 音流的常见封装格式每个 AAC 帧前面都带一个 7 字节或带 CRC 时 9 字节的帧头。它的比特布局大致如下字段位数说明syncword12同步字固定为0xFFF即开头的 4 字节FF F1id1MPEG 版本0 MPEG-41 MPEG-2layer2层信息AAC 中固定为00protection_absent1是否为 1 表示无 CRC 校验profile2配置文件0Main1LC2SSRsampling_frequency_index4采样率索引0~15private_bit1私有位channel_configuration3声道配置版权相关位4通常忽略frame_length13帧总长度字节其中前 4 字节最常被拿来「肉眼识别」FF F1 50 80就是一个典型的 AAC-LC、44.1 kHz、立体声帧头开头。aad4cj 的Adts类就是把这些比特逐一还原成结构化属性samplingFrequency、channelConfiguration、profile等核心实现在 src/aac_parser.cj。快速开始搭建 aad4cj 解析环境如果你想在本地跑通本教程只需三步克隆仓库git clone https://gitcode.com/Cangjie-SIG/aad4cj更新依赖并构建cjpm update cjpm build导入两个包即可使用全部解析能力import aad4cj.* import aad4cj.bitreader.* aad4cj 提供的是 AAC 解码流程中的关键基础组件ADTS 解析、Huffman 工具、窗口分组等并不直接做端到端音频解码详见 README.md 的「介绍」章节。一行代码解析 ADTS 帧头parseAdts最省事的姿势是直接调用 parseAdts 函数。它接收一个字节数组返回(Adts, Exception)元组let data ArrayUInt8([0xFF, 0xF1, 0x50, 0x80, 0x22, 0xC2, 0x70]) let (adts, err) parseAdts(data) if (err.message ) { println(MPEG版本: ${adts.mpegVersion}) println(采样率: ${adts.samplingFrequency} Hz) println(声道配置: ${adts.channelConfiguration}) println(帧长度: ${adts.frameLength}) }内部流程由 Adts.adtsFrame() 完成先调adtsFixedHeader()解析固定头部查同步字 → 读版本/层/配置文件/采样率索引/声道再调 adtsVariableHeader() 读 13 位的帧长度、缓冲区充满度和原始数据块数最后解析原始数据块。逐位拆解从 4 字节同步字到采样率索引想真正理解「4 字节同步字」是怎么起作用的可以用BitReader手动走一遍固定头部的读取顺序。以下代码与 adtsFixedHeader() 的实现顺序完全一致let reader BitReader(data) // ① 读取 12 位同步字必须等于 0xFFF let syncWord reader.readBitsAsUInt16(12) // ② MPEG 版本1位0MPEG-41MPEG-2 let mpegId reader.readBit() // ③ 层2位固定 00 是否有 CRC 保护1位 let layer reader.readBitsAsUInt8(2) let protectionAbsent reader.readBitAsBool() // ④ 配置文件2位0Main1LC2SSR let profile reader.readBitsAsUInt8(2) // ⑤ 采样率索引4位——识别采样率的关键 let sfi reader.readBitsAsUInt8(4) // ⑥ 私有位1位跳过 声道配置3位 reader.skipBits(1) let channelConfig reader.readBitsAsUInt8(3)几个值得注意的细节同步字是 12 位而不是 8 位。FF F1前两字节中只有前 12 个比特参与同步1111 1111 1111 1xxx所以判断依据是「读到 12 位0xFFF」BitReader 提供readBitsAsUInt16(12)这类按位读取接口正是为这种跨字节边界读取设计的。aad4cj 自带同步字搜索逻辑adtsFixedHeader()会最多尝试 3 次若 12 位不等于0xFFF就跳过 11 位后重新对齐连续 3 次失败才报「Failed to find ADTS syncword」错误。位读取器完整 APIreadBit、peekBits、skipBits、byteAlign等可参考 doc/feature_api.md。采样率索引 → 真实采样率一张对照表搞定 ADTS 帧头里存的不是「44100」这个数字本身而是一个 4 位的采样率索引sfi。aad4cj 在 getSamplingFrequency() 中内置了 MPEG 标准的对照表sfi01234567采样率9600088200640004800044100320002400022050sfi89101112~15采样率1600012000110258000保留返回 0例如 sfi 4 对应 44100 Hzsfi 3 对应 48000 Hz。解析成功后adts.samplingFrequency字段直接给出映射好的实际采样率无需自己查表。实战验证用真实帧数据确认解析结果仓库测试用例 aac_parser_test.cj 里有一条真实的 AAC-LC ADTS 帧十六进制开头为fff94c80...解析后断言如下mpegVersion 1MPEG-2channelConfiguration 2立体声samplingFrequency 48000注意首字节序列FF F9F9的二进制是1111 1001其中第 13 位id为 1正是 MPEG-2 标志第 21~24 位0011即 sfi 3对应 48000 Hz——与逐位拆解的结论完全吻合。此外getAudioData() 还能在解析头部的同时把 7/9 字节的 ADTS 头剥离提取出纯 AAC 裸数据方便后续接入解码器。常见问题与最佳实践 ⚠️问题建议报「Buffer truncated」传入的字节不足一个完整 ADTS 帧确认数据完整找不到同步字确认数据源是 ADTS 封装而非 AAC-LC 裸流raw AACsamplingFrequency为 0sfi 落在 12~15 保留区间属于非标准数据需自行校验处理大文件内存吃紧建议流式按帧读取避免一次性加载整个文件支持范围当前完整支持 AAC-LCHE-AACv1SBR可用不支持 HE-AACv2详见 README.md「约束与限制」总结用 aad4cj 解析 ADTS 帧头的路径非常清晰parseAdts()一步到位或借助BitReader逐位重放「12 位同步字 → 版本/层/CRC 标志 → 配置文件 → 采样率索引 → 声道配置」的读取顺序最后由内置对照表把 sfi 映射为真实采样率。配合 doc/design.md 的设计文档和 src/test/ 下的单元测试你可以快速构建起自己的 AAC 码流分析工具。【免费下载链接】aad4cjaad4cj 是一个基于仓颉Cangjie语言实现的 AAC 音频码流解析与处理组件库。项目地址: https://gitcode.com/Cangjie-SIG/aad4cj创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
