使用AVPlayer无法读取自研带ID3标签的HLS流问题排查

针对你遇到的自研HLS流ID3标签无法被AVPlayer读取的问题，从流生成、标签注入到客户端读取三个环节逐一排查：

1. 确认流生成与标签注入的正确性 #

检查mediastreamsegmenter运行状态 #

• 用lsof -i :50000确认端口50000被mediastreamsegmenter占用，确保id3taggenerator发送的标签能被正确接收。
• 运行mediastreamvalidator http://damiaantheopro14.local:8081/prog_index.m3u8验证HLS流合规性，重点查看metadata相关报错。
• 确认http-server的运行目录为/tmp/hlsId3/video，若未指定需重启服务：http-server /tmp/hlsId3/video -p 8081，保证播放列表和片段路径正确。

验证ID3标签是否嵌入流中 #

取一个生成的TS片段，用ffprobe检查标签：

ffprobe -show_entries stream=tags:format=tags -i /tmp/hlsId3/video/prog_index0.ts

如果输出无ID3相关字段，说明标签未成功注入，检查id3taggenerator参数，比如-r是重复发送标签，确认是否符合预期。

2. 修复客户端AVPlayer读取逻辑 #

调整PlayerItem与MetadataOutput绑定时机 #

你当前先替换PlayerItem再添加MetadataOutput，可能错过初始metadata推送。修改按钮点击逻辑，先绑定输出再设置给Player，同时避免复用全局PlayerItem实例：

Button("Local") {
    let newLocalItem = AVPlayerItem(url: localUrl)
    newLocalItem.add(observer.metadataOutput)
    player.replaceCurrentItem(with: newLocalItem)
}

显式指定MetadataOutput支持类型 #

在Id3Observer初始化方法中，添加ID3元数据类型声明：

override init() {
    super.init()
    metadataOutput.outputsMetadataForMediaDataTypes = [AVMetadataObjectDataTypeID3Metadata]
    metadataOutput.setDelegate(self, queue: .global())
}

检查代理队列线程安全 #

若需要在代理方法中更新UI，可将代理队列切换为主队列：

metadataOutput.setDelegate(self, queue: DispatchQueue.main)

3. 验证原始视频流兼容性 #

检查5m.ts原始文件编码是否符合Apple HLS要求（H.264视频+AAC音频），用ffprobe查看：

ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of default=noprint_wrappers=1:nokey=1 5m.ts
ffprobe -v error -select_streams a:0 -show_entries stream=codec_name -of default=noprint_wrappers=1:nokey=1 5m.ts

若编码不符合，重新转码后生成流：

ffmpeg -stream_loop -1 -re -i 5m.ts -c:v libx264 -c:a aac -f mpegts -strict -2 - | mediastreamsegmenter -b http://DamiaanTheoPro14.local:8081/ -f /tmp/hlsId3/video -D -m -M 50000 -log /tmp/hlsId3/log.txt

内容的提问来源于stack exchange，提问作者Damiaan Dufaux