Apple TV上Siri中断处理：AVAudioSession通知回调未触发求助

我之前在做Apple TV音频播放项目时，也碰到过一模一样的情况——按官方文档加了中断通知观察者，可Siri触发中断时回调就是没反应。后来排查下来都是些容易忽略的细节，给你梳理一下具体的解决步骤：

1. 先激活音频会话，再谈通知 #

如果你的AVAudioSession根本没被激活，系统是不会发送任何中断通知的。一定要在注册通知之后，完成会话的配置与激活：

do {
    let session = AVAudioSession.sharedInstance()
    // Apple TV播放类应用的标准配置：playback类别+moviePlayback模式
    try session.setCategory(.playback, mode: .moviePlayback)
    try session.setActive(true)
} catch {
    print("音频会话激活失败: \(error.localizedDescription)")
}

注意：别忽略激活时的错误处理，如果激活失败，后续所有通知逻辑都不会生效。

2. 检查观察者的注册时机与方法签名 #

• 通知注册必须在会话激活之前完成，比如放在viewDidLoad或者sceneDidBecomeActive里，别等到播放开始才去注册。
• 回调方法必须带@objc修饰，参数类型严格为Notification，否则Objective-C runtime找不到这个方法：

@objc func handleInterruption(_ notification: Notification) {
    // 你的中断处理逻辑
}

3. 确认音频会话的类别与模式适配Apple TV #

如果用了.ambient这类非独占的音频类别，可能无法触发Siri中断通知。Apple TV上推荐使用.playback类别（独占音频焦点），搭配.moviePlayback模式，这是视频/音频播放应用的标准配置。

4. 处理App生命周期中的会话状态 #

当App从后台切回前台时，音频会话可能被系统自动停用。这时候需要在sceneDidBecomeActive（SceneDelegate）或者viewDidAppear中重新激活会话，确保通知能正常接收：

func sceneDidBecomeActive(_ scene: UIScene) {
    do {
        try AVAudioSession.sharedInstance().setActive(true)
    } catch {
        print("重新激活音频会话失败: \(error)")
    }
}

5. 排查第三方组件的会话干扰 #

如果你用了AVPlayer或者第三方播放框架，有些组件会自动接管音频会话的管理。这时候要确保你的手动配置和框架的默认配置不冲突，必要时可以手动接管会话控制权（比如调整AVPlayer的usesExternalPlaybackWhileExternalScreenIsActive属性）。

完整可测试示例代码 #

这里给你一个包含所有必要步骤的完整示例，直接替换测试资源URL就能验证：

import UIKit
import AVFoundation

class PlayerViewController: UIViewController {
    private var player: AVPlayer?

    override func viewDidLoad() {
        super.viewDidLoad()
        setupAudioSession()
        setupInterruptionObserver()
        setupPlayer()
    }

    private func setupAudioSession() {
        do {
            let session = AVAudioSession.sharedInstance()
            try session.setCategory(.playback, mode: .moviePlayback)
            try session.setActive(true)
            print("音频会话已激活")
        } catch {
            print("音频会话配置错误: \(error.localizedDescription)")
        }
    }

    private func setupInterruptionObserver() {
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(handleAudioInterruption(_:)),
            name: .AVAudioSessionInterruption,
            object: nil
        )
    }

    private func setupPlayer() {
        // 替换为你的测试音频/视频URL
        guard let url = URL(string: "https://example.com/test-media.mp4") else { return }
        player = AVPlayer(url: url)
        let playerLayer = AVPlayerLayer(player: player)
        playerLayer.frame = view.bounds
        view.layer.addSublayer(playerLayer)
        player?.play()
    }

    @objc private func handleAudioInterruption(_ notification: Notification) {
        guard let userInfo = notification.userInfo else { return }
        
        // 处理中断开始
        if let typeValue = userInfo[AVAudioSessionInterruptionTypeKey] as? UInt,
           let type = AVAudioSession.InterruptionType(rawValue: typeValue) {
            switch type {
            case .began:
                print("Siri中断开始，暂停播放")
                player?.pause()
            case .ended:
                // 处理中断结束，尝试恢复播放
                if let optionValue = userInfo[AVAudioSessionInterruptionOptionKey] as? UInt {
                    let options = AVAudioSession.InterruptionOptions(rawValue: optionValue)
                    if options.contains(.shouldResume) {
                        print("Siri中断结束，恢复播放")
                        player?.play()
                    }
                }
            @unknown default:
                break
            }
        }
    }

    deinit {
        NotificationCenter.default.removeObserver(self, name: .AVAudioSessionInterruption, object: nil)
    }
}

内容的提问来源于stack exchange，提问作者Juan Carlos Ospina Gonzalez