Objective-C实现视频通话画中画（PIP）模式问题排查与方案

• 视图层级混乱：直接把self.view添加到AVPictureInPictureVideoCallViewController的视图中，self.view本身已属于当前控制器的视图层级，重复添加会导致视图管理冲突，且PIP需要的是独立的视频渲染视图而非整个控制器的根视图。
• 未验证PIP兼容性：没有提前检查设备是否支持画中画功能，直接启动可能因设备/系统版本不兼容失败。
• 内容源配置错误：AVPictureInPictureControllerContentSource的activeVideoCallSourceView应当是承载视频流的核心视图（比如AVCaptureVideoPreviewLayer的容器视图），而非控制器的根视图。
• 缺失错误反馈：未实现AVPictureInPictureControllerDelegate的失败回调方法，无法定位启动失败的具体原因。

前置准备 #

1. 项目配置：在Info.plist中添加NSPictureInPictureUsageDescription键，填写PIP功能的使用场景描述，否则会触发权限报错。
2. 系统版本：确保目标设备iOS版本≥15.0（AVPictureInPictureVideoCallViewController是iOS15新增API）。

实现步骤 #

1. 准备独立视频视图：创建专门用于承载摄像头预览或远程视频流的视图，避免与控制器根视图耦合。
2. 配置通话专用控制器：将视频视图添加到AVPictureInPictureVideoCallViewController的视图中，并设置合适的尺寸。
3. 初始化内容源与PIP控制器：关联视频视图和通话控制器，设置代理监听状态变化。
4. 检查支持性后启动PIP：确认设备支持PIP后再调用启动方法，同时处理可能的失败情况。

完整代码示例 #

// 假设self.videoPreviewView是承载视频流的自定义视图（比如AVCaptureVideoPreviewLayer的容器）
- (void)startVideoCallPIP {
    // 1. 检查设备是否支持PIP
    if (![AVPictureInPictureController isPictureInPictureSupported]) {
        NSLog(@"设备不支持画中画功能");
        return;
    }
    
    // 2. 初始化通话专用控制器
    AVPictureInPictureVideoCallViewController *pipCallVC = [[AVPictureInPictureVideoCallViewController alloc] init];
    pipCallVC.preferredContentSize = CGSizeMake(300, 400);
    
    // 将视频视图添加到通话控制器（确保videoPreviewView未被添加到其他视图层级）
    self.videoPreviewView.frame = pipCallVC.view.bounds;
    self.videoPreviewView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
    [pipCallVC.view addSubview:self.videoPreviewView];
    
    // 3. 创建PIP内容源
    AVPictureInPictureControllerContentSource *contentSource = [[AVPictureInPictureControllerContentSource alloc] initWithActiveVideoCallSourceView:self.videoPreviewView contentViewController:pipCallVC];
    
    // 4. 初始化PIP控制器
    self.pictureInPictureController = [[AVPictureInPictureController alloc] initWithContentSource:contentSource];
    self.pictureInPictureController.delegate = self;
    self.pictureInPictureController.canStartPictureInPictureAutomaticallyFromInline = YES;
    
    // 5. 启动PIP并处理错误
    NSError *error;
    BOOL success = [self.pictureInPictureController startPictureInPictureWithError:&error];
    if (!success) {
        NSLog(@"画中画启动失败：%@", error.localizedDescription);
    }
}

// 实现代理方法监听PIP状态变化
- (void)pictureInPictureControllerDidStartPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
    NSLog(@"画中画已启动");
    // 启动后隐藏原控制器中的视频视图
    self.videoPreviewView.hidden = YES;
}

- (void)pictureInPictureControllerDidStopPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
    NSLog(@"画中画已停止");
    // 恢复原控制器中的视频视图显示
    self.videoPreviewView.hidden = NO;
}

- (void)pictureInPictureController:(AVPictureInPictureController *)pictureInPictureController failedToStartPictureInPictureWithError:(NSError *)error {
    NSLog(@"画中画启动失败：%@", error.localizedDescription);
}

额外注意事项 #

• 视频视图必须处于可见且完成布局的状态，否则PIP启动会失败。
• PIP启动后，避免修改视频视图的层级或尺寸，确保画中画窗口内容稳定。
• 远程视频通话场景下，需确保视频流在PIP模式下持续传输，不会因控制器生命周期问题中断。

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