iOS应用内多个AVAudioSession配置切换不生效如何解决

两个核心问题导致配置不生效：

1. 基础认知偏差：AVAudioSession是应用级全局单例，不是每个播放器实例独立持有的对象。当前实现里每个视频组件各自维护自己的_ignoreSilentSwitch、_mixWithOthers属性，切换某个组件状态时直接修改全局session，既没有处理多实例之间的配置冲突，也没有在配置修改后做激活操作，系统不会采纳未激活的配置。
2. 代码逻辑bug：
   • 类型判断错误：AVAudioSessionCategory是C字符串枚举，AVAudioSessionCategoryOptions是无符号整型，两者都不是OC对象，初始值设为nil、用!= nil做判断在64位系统下会出现判断逻辑失效，很多场景下根本走不到setCategory的调用分支。
   • 缺少激活步骤：调用setCategory:withOptions:之后必须调用setActive:error:提交配置变更，尤其是有其他音频流占用session的时候，不主动激活新配置会被系统直接忽略。
   • 时序问题：setPaused方法里先执行播放/配置逻辑，再更新_paused状态标记，会导致重复触发配置、状态判断错乱。
   • 无多实例仲裁：多个视频组件同时存在时，没有统一的配置权限控制，暂停的组件和正在播放的组件可能先后触发configureAudio，把正确的配置覆盖掉。

1. 修正configureAudio的基础逻辑 #

把原来的nil判断、缺少激活的问题修掉，加上错误捕获方便调试：

- (void)configureAudio
{
    AVAudioSession *session = [AVAudioSession sharedInstance];
    AVAudioSessionCategory targetCategory = NULL;
    AVAudioSessionCategoryOptions targetOptions = 0;
    BOOL needUpdateConfig = NO;

    if([_ignoreSilentSwitch isEqualToString:@"ignore"]) {
      targetCategory = AVAudioSessionCategoryPlayback;
      needUpdateConfig = YES;
    } else if([_ignoreSilentSwitch isEqualToString:@"obey"]) {
      targetCategory = AVAudioSessionCategoryAmbient;
      needUpdateConfig = YES;
    }

    if([_mixWithOthers isEqualToString:@"mix"]) {
      targetOptions = AVAudioSessionCategoryOptionMixWithOthers;
      needUpdateConfig = YES;
    } else if([_mixWithOthers isEqualToString:@"duck"]) {
      targetOptions = AVAudioSessionCategoryOptionDuckOthers;
      needUpdateConfig = YES;
    } 

    if (!needUpdateConfig) return;

    NSError *configErr = nil;
    if (targetCategory != NULL) {
        [session setCategory:targetCategory withOptions:targetOptions error:&configErr];
    } else {
        [session setCategory:session.category withOptions:targetOptions error:&configErr];
    }
    // 必须激活配置才能生效，通知其他音频应用当前session状态变更
    [session setActive:YES withOptions:AVAudioSessionSetActiveOptionNotifyOthersOnDeactivation error:&configErr];
    // 调试阶段打开下面的打印，能直接看到配置失败的系统原因
    // if (configErr) NSLog(@"AVAudioSession配置失败: %@", configErr);
}

2. 增加全局多实例仲裁逻辑 #

因为AVAudioSession是全局单例，必须保证任意时刻只有当前正在播放的视频实例有权限修改session配置：

• 新增一个全局静态变量，持有当前活跃的播放器实例引用
• 播放器触发播放（setPaused:NO）时，先把自己注册为当前活跃实例，再调用configureAudio
• 播放器触发暂停（setPaused:YES）时，如果自己是当前活跃实例，先释放session控制权：没有其他要播放的实例就调用setActive:NO把session交还系统，有其他待播放实例就把配置权限交给下一个实例

3. 修正setPaused的时序问题 #

先判断状态是否真的变更，先更新状态标记再执行播放/暂停逻辑，避免重复触发无效配置：

- (void)setPaused:(BOOL)paused
{
  // 状态没变化直接返回，不做重复操作
  if (_paused == paused) return;
  _paused = paused;

  if (paused) {
    [_player pause];
    [_player setRate:0.0];
    // 自己是当前活跃播放器的话，释放音频session控制权
    if (self == [self class].globalActivePlayer) {
        [self resignActiveAudioSession];
    }
  } else {
    // 先注册为全局活跃播放器，拿到配置权限
    [self class].globalActivePlayer = self;
    [self configureAudio];

    if (@available(iOS 10.0, *) && !_automaticallyWaitsToMinimizeStalling) {
      [_player playImmediatelyAtRate:_rate];
    } else {
      [_player play];
      [_player setRate:_rate];
    }
  }
}

• AVAudioSessionCategoryAmbient默认自带AVAudioSessionCategoryOptionMixWithOthers属性，如果你需要在 obey 静音键的场景下打断其他后台音频，要显式设置对应options，不要依赖系统默认值
• App退后台、电话中断等系统事件会自动修改AVAudioSession状态，事件结束后需要在对应的通知回调里重新调用configureAudio恢复配置
• 不要在player未完成初始化的时候调用configureAudio，此时系统会直接忽略配置请求

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