iOS Objective-C中AVPlayerViewController设置背景色无效问题排查

核心原因 #

• 层级遮挡：AVPlayerViewController的view并非直接展示背景的顶层容器，其内部包含了承载视频画面的AVPlayerLayer、contentOverlayView等子元素，直接设置view.backgroundColor会被这些上层视图/图层完全遮挡，无法显示。
• 设置时机不当：你在调用presentViewController:animated:completion:nil后立即设置背景色，此时控制器视图可能尚未完成布局渲染，设置的属性可能被后续视图生命周期流程覆盖。

正确修改方案 #

1. 利用contentOverlayView设置背景 #

contentOverlayView是AVPlayerViewController官方提供的用于叠加自定义内容的视图，设置它的背景色可以绕过层级遮挡问题：

// 在present之前设置
controller.contentOverlayView.backgroundColor = [UIColor colorWithRed:3/255.0 green:163/255.0 blue:227/255.0 alpha:1.0];
[self presentViewController:controller animated:YES completion:nil];

2. 调整设置时机到present完成回调 #

确保视图完成初始化后再设置属性：

[self presentViewController:controller animated:YES completion:^{
    controller.contentOverlayView.backgroundColor = [UIColor colorWithRed:3/255.0 green:163/255.0 blue:227/255.0 alpha:1.0];
}];

3. 针对视频播放前后的背景设置 #

如果需要在视频未加载、播放结束后显示背景，可直接设置AVPlayerLayer的背景色：

player.playerLayer.backgroundColor = [[UIColor colorWithRed:3/255.0 green:163/255.0 blue:227/255.0 alpha:1.0] CGColor];

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