ExoPlayer DVB AIT 测试数据生成指南从 TSDuck XML 到.bin的完整工作流【免费下载链接】ExoPlayerThis project is deprecated and stale. The latest ExoPlayer code is available in https://github.com/androidx/media项目地址: https://gitcode.com/gh_mirrors/ex/ExoPlayer导读本文围绕 ExoPlayer 仓库中 testdata/src/test/assets/media/dvbsi/README.md 展开系统讲解 DVBDigital Video Broadcasting数字视频广播测试数据Application Information TableAIT 应用信息表的生成、维护与使用全流程。你将掌握如何用 TSDuck 的tstabcomp工具把可读的 XML 描述文件编译为二进制.bin测试资产理解这些资产在 ExoPlayer 的 AIT 解码器单元测试AppInfoTableDecoderTest中如何被断言校验以及源码中 AIT 解析的底层实现原理。文中涉及的命令与文件均以当前仓库实际内容为准可直接照搬复现。一、为什么 ExoPlayer 需要 DVB 测试数据1.1 AIT 在 DVB 体系中的角色AITApplication Information Table是 DVB 广播系统中用于通告与某个服务Service关联的应用程序的信息表例如 HbbTV 应用的位置URL以及启动控制方式。ExoPlayer 在library/extractor模块中提供了 AIT 的解码实现见 AppInfoTableDecoder.java 与 AppInfoTable.java。前者解析 DVB ETSI TS 102 809 规范第 5.3.4 节定义的 AIT 结构的二进制节数据后者以Metadata.Entry形式承载解析结果controlCode与url两个字段。1.2 二进制测试资产的价值单元测试需要喂入真实的字节流才能验证解码器的位级解析逻辑。但原始二进制数据不可读、不易审查、难以修改。因此 ExoPlayer 采用XML 源文件 编译产物双轨策略.xml文件是人类可读、可编辑的源描述明确标出测试断言中每个值的来源.bin文件是由 XML 编译得到的二进制节数据是测试运行时真正被读取并解码的输入。当前仓库testdata/src/test/assets/media/dvbsi/目录下共存六份文件三对一一对应XML 源文件编译产物.bin覆盖场景ait_typical.xmlait_typical.bin常规场景两个应用条目各带 URL base 与路径ait_no_url_base.xmlait_no_url_base.bin缺少 URL base 的异常场景ait_no_url_path.xmlait_no_url_path.bin缺少路径simple application location的异常场景这些.bin文件由测试代码直接引用见 AppInfoTableDecoderTest.java 第 36–38 行对media/dvbsi/ait_typical.bin、media/dvbsi/ait_no_url_base.bin、media/dvbsi/ait_no_url_path.bin三个常量路径的引用。二、测试数据生成工具与完整命令2.1 工具TSDuck 的tstabcompREADME 明确指出本目录下的.bin文件是由.xml文件通过TSDuck一个开源的 TS/DVB 工具集提供的tstabcomp工具编译生成的。tstabcomp负责在 XML 表示与二进制 TS 表数据之间进行双向转换compile/decompile。2.2 重新生成全部.bin文件的命令在原文档给出的基础上整理为完整、可复现的命令在仓库根目录执行tstabcomp -c testdata/src/test/assets/media/dvbsi/*.xml参数说明-c--compile将 XML 文件编译为二进制表数据。tstabcomp的默认输出文件会替换/生成与输入 XML 同名的.bin文件即ait_typical.xml → ait_typical.bin、ait_no_url_base.xml → ait_no_url_base.bin、ait_no_url_path.xml → ait_no_url_path.bin通配符*.xml一次处理目录下全部 XML 源文件与重新生成所有.bin文件的目标一致。2.3 何时需要重新生成根据 README 的约定在以下两类情况下必须重新编译并提交新生成的.bin新增测试数据文件为新的解码分支添加 XML 源文件后修改既有测试数据调整现有 XML 中的字段值后。原则是先改 XML再重新生成 .bin最后一起提交——避免出现 XML 与.bin不同步导致测试断言与实际输入不符的隐患。README 特别强调.bin是在提交committing之前用上述命令重新生成的属于仓库维护的强制流程。三、深入解读 XML 测试数据源文件3.1 常规场景ait_typical.xmlait_typical.xml 描述了一个包含两个应用条目的 AIT?xml version1.0 encodingUTF-8? tsduck AIT version30 currenttrue test_application_flagfalse application_type0x0010 application control_code0x01 application_identifier organization_id0x00000120 application_id0x0071/ transport_protocol_descriptor transport_protocol_label0x00 http url basehttp://example.com// /http /transport_protocol_descriptor simple_application_location_descriptor initial_pathpath/foo/ /application application control_code0x02 application_identifier organization_id0x00000120 application_id0x0072/ transport_protocol_descriptor transport_protocol_label0x00 http url basehttp://google.com// /http /transport_protocol_descriptor simple_application_location_descriptor initial_pathpath/bar/ /application /AIT /tsduck要点拆解表级属性version30、currenttrue、test_application_flagfalse、application_type0x0010AIT 的 application_type 字段0x0010 对应 HbbTV 等常用值application_identifier由organization_id与application_id共同唯一标识一个应用transport_protocol_descriptor内嵌httpurl base...//http给出应用的 URL 基址basesimple_application_location_descriptor initial_path...给出应用的初始路径。对照测试断言AppInfoTableDecoderTest.java 第 40–56 行decode_typical解码结果与 XML 完全对应第一个条目controlCode AppInfoTable.CONTROL_CODE_AUTOSTART0x01url http://example.com/path/foobase initial_path 拼接第二个条目controlCode AppInfoTable.CONTROL_CODE_PRESENT0x02url http://google.com/path/barmetadata.length() 2两个条目均为AppInfoTable实例。这组断言直接印证了XML 是断言值的来源这一设计初衷。3.2 异常场景一缺少 URL baseait_no_url_base.xml 中transport_protocol_descriptor内是空的http/http没有url base.../transport_protocol_descriptor transport_protocol_label0x00 http /http /transport_protocol_descriptor simple_application_location_descriptor initial_pathfoo/bar/对应测试decode_noUrlBase第 58–64 行解码结果metadata为null。原因可回溯到 AppInfoTableDecoder.java 第 135–137 行的判定逻辑只有当urlBase ! null urlExtension ! null时才把条目加入列表urlBase缺失时该条目被丢弃最终列表为空则返回null第 140 行。3.3 异常场景二缺少路径ait_no_url_path.xml 中只有 URL base、没有simple_application_location_descriptortransport_protocol_descriptor transport_protocol_label0x00 http url basehttp://google.com// /http /transport_protocol_descriptor对应测试decode_noUrlPath第 66–72 行解码结果同样为null。同样符合源码中base 与 extension 必须同时存在的合并条件。四、源码级原理.bin如何被解码4.1 注册链路从 MIME 到解码器AIT 数据在 ExoPlayer 中的流转路径为TS 提取器识别到TS_STREAM_TYPE_AIT流类型由 DefaultTsPayloadReaderFactory.java 第 198–199 行通过PassthroughSectionPayloadReader以MimeTypes.APPLICATION_AIT的 MIME 类型透传节数据MIME 常量定义于 MimeTypes.java 第 154 行APPLICATION_AIT application/vnd.dvb.aitMetadataDecoderFactoryMetadataDecoderFactory.java 第 94–95 行根据该 MIME 类型创建AppInfoTableDecoder实例并同时声明supportsFormat第 78 行。4.2 解码器核心解析流程AppInfoTableDecoder.java 的解析要点表 ID 校验第 56–60 行读取首字节tableId仅当等于APPLICATION_INFORMATION_TABLE_ID 0x74第 51 行对应 ETSI TS 102 809 表 16时才继续解析否则返回null节头部跳过第 65–73 行跳过section_syntax_indication等保留位读取section_length并据此计算节结束位置扣除 4 字节 CRC公共描述符跳过第 74–78 行由于当前只保留 URL 与控制码按应用唯一公共描述符中无有用信息直接skipBytes跳过应用循环第 84–138 行逐应用读取 48 位application_identifier、8 位control_code与描述符循环其中识别两类描述符DESCRIPTOR_TRANSPORT_PROTOCOL 0x02第 43 行见规范 5.3.6 节读取 16 位protocolId当protocolId TRANSPORT_PROTOCOL_HTTP 3第 48 行时按 5.3.6.2 节解析 URL baseUS-ASCII 字符串DESCRIPTOR_SIMPLE_APPLICATION_LOCATION 0x15第 45 行见规范 5.3.7 节读取 URL extension即 initial pathbase 与 extension 均存在时拼接为完整 URL 并创建AppInfoTable(controlCode, urlBase urlExtension)第 135–137 行。4.3AppInfoTable条目的语义AppInfoTable.java 定义了两种控制码常量第 41–46 行语义引自规范常量值语义CONTROL_CODE_AUTOSTART0x01服务被选中时应自动启动该应用若尚未运行CONTROL_CODE_PRESENT0x02应用允许在服务选中期间运行但不会自动启动该类实现Metadata.Entry支持 Parcelable 序列化第 67–70 行写入 url 与 controlCodetoString()输出形如Ait(controlCode1,urlhttp://example.com/path/foo)。4.4 边界防护输入缓冲区校验decode_failsIfPositionNonZero、decode_failsIfBufferHasNoArray、decode_failsIfArrayOffsetNonZero测试第 74–100 行分别验证输入缓冲区位非零、无可访问数组、数组偏移非零时解码器会抛出IllegalArgumentException。这体现了SimpleMetadataDecoder.decode对底层ByteBuffer的严格前置约束——调用方必须保证缓冲区的 position 为 0、具备可直接访问的数组且 offset 为 0。五、实操如何新增一个 DVB 测试场景结合 README 流程与源码结构新增测试数据的标准步骤为编写 XML 源文件在 testdata/src/test/assets/media/dvbsi/ 目录新增xxx.xml参照ait_typical.xml的tsduck结构描述目标 AIT 内容编译生成二进制在仓库根目录执行tstabcomp -c testdata/src/test/assets/media/dvbsi/xxx.xml生成同名的xxx.bin引用测试资产在 AppInfoTableDecoderTest.java 中新增测试方法用TestUtil.getByteArray(...)加载media/dvbsi/xxx.bin并构造MetadataInputBuffer随后对解码产物的controlCode与url编写 Truth 断言提交XML、.bin与测试代码三者一并提交保证资产与断言同步。六、注意事项与维护约束必须保持 XML 与.bin同步任何对 XML 的修改都要重新执行编译命令禁止直接手工编辑.bin二进制不可读且易出错编译命令的路径前提README 中的命令基于仓库根目录相对路径testdata/src/test/assets/media/dvbsi/*.xml执行时需确保位于仓库根目录且本机已安装 TSDucktstabcomp在 PATH 中适用范围本文数据面向 ExoPlayer 的AppInfoTableDecoder单元测试AppInfoTableDecoderTest.javaAIT 的完整二进制语法以 DVB ETSI TS 102 809 规范为准本仓库的com.google.android.exoplayer2包已标记Deprecated源码注释中说明建议迁移至 androidx.media3 中对应的同名实现。总结ExoPlayer 以XML 源文件 tstabcomp编译产物的方式维护 DVB AIT 测试数据兼顾了测试数据的可读性与二进制真实性。本文完整覆盖了 README 中的生成命令、XML 样例的字段语义、三个测试场景与解码断言的对应关系并下沉到AppInfoTableDecoder、AppInfoTable、MetadataDecoderFactory与 TS 提取器注册链路等源码细节可作为理解与维护该测试数据目录的完整参考。【免费下载链接】ExoPlayerThis project is deprecated and stale. The latest ExoPlayer code is available in https://github.com/androidx/media项目地址: https://gitcode.com/gh_mirrors/ex/ExoPlayer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考