iOS应用运行AVPlayer视频播放或WebRTC通话时push notification无提示音

正常运行基准状态 #

• 应用核心能力配置：
  • 基于WebRTC框架实现端到端实时音频通话功能
  • 基于原生AVPlayer实现HLS流媒体视频播放
  • 已接入系统Push通知能力，通知配置绑定了系统默认提示音
• 无媒体播放的日常运行场景下，Push通知可正常弹出展示，同步触发默认提示音与振动反馈，功能完全符合预期

异常触发表现 #

两类场景下通知展示正常，但提示音、振动反馈完全失效：

• 场景1：应用处于前台/后台状态，通过AVPlayer持续播放HLS流媒体过程中接收到Push通知
  • 通知横幅/列表展示完全正常
  • 无对应提示音播放、无振动反馈
• 场景2：应用处于WebRTC音频通话的全流程中（发起、通话中、暂停通话阶段）接收到Push通知
  • 通知横幅/列表展示完全正常
  • 无对应提示音播放、无振动反馈

问题根因与可落地解决方案 #

核心根因：iOS系统对应用级音频会话的优先级、通道占用规则有强管控，当应用主动激活了独占模式的高优先级音频会话时，系统会接管App的全量音频输出通道，此时即便是系统层面的Push通知提示音，也会因为通道被App独占、会话配置冲突，被系统静默拦截，不会触发播放与振动。

AVPlayer播放HLS流场景适配方案 #

• 校验AVPlayer关联的AVAudioSession配置：
  • 不要在HLS播放场景下将音频会话配置为完全独占模式
  • 给音频会话补充AVAudioSession.CategoryOptions.mixWithOthers配置项，允许系统级音频（包括Push提示音、铃声音频）与App的播放音频混音共存，避免App抢占全量音频通道
  • 避免在视频播放时主动硬激活音频会话抢占焦点，除非是明确的沉浸式无干扰观影场景
• 体验优化可选方案：如果不希望HLS播放的声音被Push提示音干扰，可以在监测到Push通知到达的瞬时，临时将AVPlayer播放音量调低30%，待提示音播放完成后再恢复原音量，兼顾播放体验与通知提示效果

WebRTC音频通话场景适配方案 #

• 调整WebRTC模块的内置音频会话配置：
  • WebRTC默认会为通话场景配置AVAudioSessionCategoryPlayAndRecord类别，默认状态下不支持与其他系统音频混音，需要在WebRTC的RTCAudioSession初始化阶段开启isMixWithOthersEnabled = true
  • 通话过程中不要主动禁用系统其他音频的输出通道，避免系统判定当前音频会话为需要完全独占通道的最高优先级状态
• 避坑校验：检查WebRTC初始化逻辑中，是否在调用overrideOutputAudioPort(.speaker)时，同步强制设置了音频会话的最高优先级，这类配置会直接拦截系统Push提示音的播放通道

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