直播HLS流中AVPlayerInterstitialEvent客户端调度失效问题求助

核心原因 #

直播场景下，客户端通过AVPlayerInterstitialEvent的date属性调度事件失效，本质是播放器对直播动态时间轴的处理逻辑与VOD完全不同：

• 直播流的时间线随播放列表更新动态校准，客户端初始化时设置的静态date值无法跟随直播延迟波动、时间轴偏移等变化，导致播放器无法精准匹配触发时机。
• 播放器默认仅将服务器通过EXT-X-DATERANGE声明的事件视为与直播流强绑定的高优先级内容，客户端手动添加的date事件优先级较低，不会触发资源预加载（这也是你看不到事件URL网络请求的原因）。
• joinCue模式生效是因为该模式跳过了时间匹配逻辑，直接在当前播放点插入事件，自然会忽略date属性，不符合你的时间触发需求。

客户端侧可行解决方案 #

不需要修改HLS播放列表，可通过以下方式实现直播场景的事件调度：

1. 将事件Date转换为直播相对播放时间

通过监听AVPlayerItem的currentDate，实时计算目标事件时间与当前直播时间的差值，将date转换为直播流的相对播放时间（time属性）后再调度：

var dateObserver: NSKeyValueObservation?

func scheduleLiveInterstitial(eventURL: URL, targetDate: Date) {
    guard let playerItem = player.currentItem else { return }
    
    dateObserver = playerItem.observe(\.currentDate, options: .new) { [weak self] item, change in
        guard let self = self, let currentDate = change.newValue else { return }
        let timeDiff = targetDate.timeIntervalSince(currentDate)
        
        // 当事件触发前10秒，转换为相对时间并调度
        if timeDiff <= 10 && timeDiff > 0 {
            let currentPlayTime = item.currentTime()
            let eventTriggerTime = CMTimeAdd(currentPlayTime, CMTimeMakeWithSeconds(timeDiff, preferredTimescale: 600))
            let interstitialEvent = AVPlayerInterstitialEvent(url: eventURL, time: eventTriggerTime)
            
            self.interstitialController.scheduleInterstitialEvent(interstitialEvent)
            self.dateObserver?.invalidate() // 避免重复调度
        }
    }
}

2. 强制触发事件预加载

调度事件后，手动调用prerollInterstitialEvents(at:)方法，指定目标时间点触发资源预加载，确保播放器发起事件内容的网络请求：

let interstitialEvent = AVPlayerInterstitialEvent(url: eventURL, date: targetDate)
interstitialController.scheduleInterstitialEvent(interstitialEvent)

// 强制预加载事件内容
if let targetCMTime = player.currentItem?.date(targetDate) {
    interstitialController.prerollInterstitialEvents(at: targetCMTime)
}

3. 高优先级事件直接自定义插播逻辑

对于紧急警报这类高优先级事件，可跳过AVPlayerInterstitialEventController，直接切换播放内容：

func triggerEmergencyAlert(alertURL: URL) {
    let alertPlayerItem = AVPlayerItem(url: alertURL)
    let alertPlayer = AVPlayer(playerItem: alertPlayerItem)
    
    // 暂停主直播流
    player.pause()
    
    // 播放警报
    alertPlayer.play()
    
    // 监听警报播放完成，恢复主直播
    NotificationCenter.default.addObserver(forName: .AVPlayerItemDidPlayToEndTime,
                                           object: alertPlayerItem,
                                           queue: .main) { [weak self] _ in
        self?.player.play()
        NotificationCenter.default.removeObserver(self!, name: .AVPlayerItemDidPlayToEndTime, object: alertPlayerItem)
    }
}

总结 #

直播场景下客户端date属性调度失效，是播放器对直播动态时间轴的管理逻辑导致的。通过转换为相对播放时间、强制预加载，或者直接自定义插播逻辑，都可以在不修改HLS播放列表的前提下实现需求。

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