如何在Swift AVPlayer中通过HLS(m3u8)为不同画质视频播放单一音频

问题背景 #

开发基于Swift的视频流应用，采用HLS协议（支持多画质），使用AVPlayer框架播放。主m3u8文件已定义不同视频画质及独立音频流，但不清楚如何配置AVPlayer，确保选中的视频画质对应播放正确的音频流——是需要手动监控用户画质选择并更新音频轨道，还是有自动化的关联方式？

主m3u8文件片段 #

#EXTM3U

#EXT-X-INDEPENDENT-SEGMENTS

#EXT-X-MEDIA:TYPE=AUDIO,URI="audio/audio.m3u8",GROUP-ID="audio",LANGUAGE="en",NAME="ENGLISH",AUTOSELECT=YES,CHANNELS="2"

#EXT-X-STREAM-INF:BANDWIDTH=745697,AVERAGE-BANDWIDTH=508245,CODECS="avc1.4d401e,mp4a.40.2",RESOLUTION=854x480,FRAME-RATE=25.000,VIDEO-RANGE=SDR,AUDIO="audio",CLOSED-CAPTIONS=NONE
480p/22534041-c4c5-4b5b-be4e-e7035e4ffdb6.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=961804,AVERAGE-BANDWIDTH=663000,CODECS="avc1.4d401f,mp4a.40.2",RESOLUTION=1280x720,FRAME-RATE=25.000,VIDEO-RANGE=SDR,AUDIO="audio",CLOSED-CAPTIONS=NONE
720p/04b4f73f-3f43-4c88-895f-931c22564e3d.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=534811,AVERAGE-BANDWIDTH=389186,CODECS="avc1.4d401e,mp4a.40.2",RESOLUTION=640x360,FRAME-RATE=25.000,VIDEO-RANGE=SDR,AUDIO="audio",CLOSED-CAPTIONS=NONE
360p/df767a2b-833a-4772-94cd-099e8ccf48e4.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2914202,AVERAGE-BANDWIDTH=2041333,CODECS="avc1.640028,mp4a.40.2",RESOLUTION=1920x1080,FRAME-RATE=25.000,VIDEO-RANGE=SDR,AUDIO="audio",CLOSED-CAPTIONS=NONE
1080p/f0c10df4-df65-4800-9e45-ff684357d4d7.m3u8

解决方案 #

1. 自动化关联（默认行为） #

你提供的m3u8结构已经做了正确的关联配置：所有#EXT-X-STREAM-INF标签都通过AUDIO="audio"属性，关联到了GROUP-ID为audio的音频流。AVPlayer加载主m3u8后，会自动解析这种关联关系：

• 当AVPlayer自动切换画质（比如根据网络带宽调整），或者用户手动切换画质时，AVPlayer会自动保持与同一GROUP-ID的音频流同步播放，不需要手动干预音频轨道。

2. 手动实现画质切换（如果需要用户自定义选择） #

如果要提供用户手动选择画质的功能，只需要处理视频流的选择逻辑，音频流会自动匹配，步骤如下：

步骤1：获取可用的视频画质选项

guard let asset = player.currentItem?.asset as? AVURLAsset else { return }

// 异步加载媒体特性
asset.loadValuesAsynchronously(forKeys: ["availableMediaCharacteristicsWithMediaSelectionOptions"]) {
    DispatchQueue.main.async {
        // 获取视频特性对应的媒体组
        guard let videoCharacteristic = asset.availableMediaCharacteristicsWithMediaSelectionOptions.first(where: { $0 == AVMediaCharacteristicVisual }),
              let videoGroup = asset.mediaSelectionGroup(forMediaCharacteristic: videoCharacteristic) else {
            return
        }
        
        // videoGroup.options包含所有可用的视频画质选项，可提取分辨率、码率等信息展示给用户
        let videoOptions = videoGroup.options
        // 示例：遍历选项提取分辨率
        for option in videoOptions {
            if let resolution = option.commonMetadata.first(where: { $0.commonKey == .commonKeyResolution })?.stringValue {
                print("可用画质：\(resolution)")
            }
        }
    }
}

步骤2：响应用户选择切换画质

当用户选中某个画质选项后，直接更新AVPlayerItem的媒体选择：

// 假设selectedOption是用户选中的视频画质选项
if let videoGroup = player.currentItem?.asset.mediaSelectionGroup(forMediaCharacteristic: AVMediaCharacteristicVisual) {
    player.currentItem?.select(selectedOption, in: videoGroup)
}

执行此代码后，AVPlayer会切换到选中的视频流，同时自动关联到对应的音频流，无需额外处理音频。

3. 特殊场景处理（多音频组） #

如果你的m3u8包含多个音频组（比如多语言音频），才需要手动选择音频流。但当前场景下只有一个音频组，完全依赖AVPlayer的自动关联即可。

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