使用VLCKit播放m3u8流时进度拖动异常的问题排查

针对你在SwiftUI中使用VLCKit 3.5.0时遇到的m3u8视频拖动进度条失效问题，结合桌面VLC可正常工作的情况，问题大概率出在代码的Seek逻辑、状态同步或媒体加载时机上，以下是具体排查点和修复方案：

1. 媒体未加载完成时的Seek无效 #

你的代码在onAppear直接调用player.play()，但HLS媒体需要时间加载元数据（如时长、片段列表），此时直接获取videoLength或执行Seek，可能因媒体未就绪导致失败。

修复方案：监听媒体的加载状态，等待媒体准备完成后再启用Seek功能：

class VideoPlayerViewModel: ObservableObject {
    @Published var player = VLCMediaPlayer()
    @Published var seekTime: Float = 0
    @Published var isMediaReady = false // 新增状态标记
    var videoLength: Float {
        return (player.media?.length.value?.floatValue ?? 0) / 1000
    }

    func setupPlayer() {
        let media = VLCMedia(url: URL(string: "https://bradmax.com/static/video/tos/440272.m3u8")!)
        player.media = media
        // 添加媒体状态监听
        player.addObserver(self, forKeyPath: "media.state", options: .new, context: nil)
        player.play()
    }

    override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
        if keyPath == "media.state", let state = change?[.newKey] as? VLCMedia.State {
            isMediaReady = state == .ready
        }
    }

    // 记得在deinit移除监听
    deinit {
        player.removeObserver(self, forKeyPath: "media.state")
    }
}

然后在View中根据isMediaReady启用Slider：

Slider(value: $viewModel.seekTime, in: 0...viewModel.videoLength, onEditingChanged: { editing in
    if editing, viewModel.isMediaReady {
        viewModel.seekVideo(to: viewModel.seekTime)
    }
})
.disabled(!viewModel.isMediaReady)

2. SeekTime与播放器实际进度不同步 #

当前代码仅在拖动Slider时更新seekTime，但播放器播放过程中seekTime不会自动同步，导致Slider位置和实际播放位置偏差，再次拖动时Seek位置计算错误。

修复方案：添加定时器同步进度：

class VideoPlayerViewModel: ObservableObject {
    private var progressTimer: Timer?

    func setupPlayer() {
        // ... 原有代码
        player.play()
        // 启动定时器同步进度
        progressTimer = Timer.scheduledTimer(withTimeInterval: 0.5, repeats: true) { [weak self] _ in
            guard let self = self, let currentTime = self.player.time?.value?.floatValue else { return }
            self.seekTime = currentTime / 1000
        }
    }

    deinit {
        progressTimer?.invalidate()
        // ... 原有移除监听代码
    }
}

3. Seek方法调用方式错误 #

直接设置player.time可能不适用于HLS流，VLCKit提供了更明确的seek(to:method:)方法，可指定Seek精度，HLS流通常需要使用合适的Seek方法。

修复方案：修改seekVideo方法：

func seekVideo(to time: Float) {
    let targetTime = VLCTime(seconds: Double(time))
    // 使用accurate方法确保HLS Seek准确
    player.seek(to: targetTime, method: .accurate)
}

4. VLCTime创建的精度问题 #

用NSNumber(value: time * 1000)创建VLCTime可能因浮点精度丢失导致Seek位置偏差，改用VLCTime(seconds:)直接传入秒数更可靠。

补充验证点 #

• 确认测试的m3u8是点播流而非直播流：直播流通常不支持Seek，桌面VLC可能因缓存已播放片段允许有限Seek，但VLCKit默认可能未开启该策略。可通过查看m3u8文件是否包含EXT-X-ENDLIST标签判断（包含则为点播流）。
• 尝试更新VLCKit到最新版本：3.5.0可能存在HLS Seek的已知bug，新版本可能已修复。

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