iPhone锁屏时调度播放YouTube视频失败的闹钟APP问题

核心问题分析 #

当前代码的问题在于：

1. Timer在后台/锁屏状态下不可靠：iOS会暂停后台APP的RunLoop，导致Timer无法按时触发播放指令
2. 音频会话未正确配置：后台启动播放时未激活音频会话，引发调试中的AQME Default-InputOutput错误
3. 未遵循iOS后台播放规范：缺少必要的后台权限和系统级调度逻辑

解决方案步骤 #

1. 开启后台音频权限

在Xcode项目中：

• 进入Signing & Capabilities标签页
• 点击+ Capability，添加Background Modes
• 勾选Audio, AirPlay, and Picture in Picture选项

2. 配置AVAudioSession

必须在播放前激活音频会话，确保后台播放权限：

import AVFoundation

func configureAudioSession() {
    let session = AVAudioSession.sharedInstance()
    do {
        // .playback类别支持静音状态下播放，适合闹钟场景
        try session.setCategory(.playback, mode: .default, options: [.mixWithOthers])
        try session.setActive(true, options: .notifyOthersOnDeactivation)
    } catch {
        print("音频会话配置失败: \(error.localizedDescription)")
    }
}

3. 替换Timer为系统级调度（本地通知）

Timer在后台不可靠，改用UNUserNotificationCenter触发播放，这是iOS后台调度的标准方式：

import UserNotifications

// 获取YouTube视频并调度播放
XCDYouTubeClient.default().getVideoWithIdentifier(videoId) { [self] video, error in
    guard let video = video, let streamURL = video.streamURL else {
        print(error?.localizedDescription ?? "获取视频失败")
        return
    }
    
    // 初始化播放器并设置后台策略
    self.player = AVPlayer(url: streamURL)
    self.player?.audiovisualBackgroundPlaybackPolicy = .continuesIfPossible
    AVPlayerViewControllerManager.shared.video = video
    
    // 先配置音频会话
    configureAudioSession()
    
    // 请求通知权限（需提前向用户申请）
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound]) { granted, _ in
        guard granted else { return }
        
        // 创建3秒后触发的本地通知
        let content = UNMutableNotificationContent()
        content.title = "闹钟提醒"
        content.sound = .none // 自定义播放YouTube音频，不使用系统通知音效
        
        let trigger = UNTimeIntervalNotificationTrigger(timeInterval: 3, repeats: false)
        let request = UNNotificationRequest(identifier: "YouTubeAlarmTrigger", content: content, trigger: trigger)
        
        // 添加通知请求
        UNUserNotificationCenter.current().add(request) { error in
            if let error = error {
                print("添加调度通知失败: \(error.localizedDescription)")
            }
        }
    }
}

// 处理通知回调（在App结构体或AppDelegate中实现）
func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
    guard response.notification.request.identifier == "YouTubeAlarmTrigger" else {
        completionHandler()
        return
    }
    
    // 再次激活音频会话（确保后台状态下可用）
    do {
        try AVAudioSession.sharedInstance().setActive(true)
    } catch {
        print("激活音频会话失败: \(error.localizedDescription)")
    }
    
    // 启动播放
    self.player?.play()
    completionHandler()
}

4. 确保播放器强引用

将player声明为ViewModel或全局对象的强引用属性，避免被ARC释放：

class AlarmViewModel: ObservableObject {
    var player: AVPlayer?
    // ...其他逻辑
}

关键注意事项 #

• 必须提前向用户申请通知权限，否则本地通知无法触发
• 音频会话使用.playback类别，确保手机静音时仍能播放闹钟音频
• 避免使用Timer进行后台调度，iOS后台限制会导致Timer失效

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