我差点就放弃了，蘑菇视频ios的画中画问题我终于定位到原因了

蘑菇视频512026-01-28 12:08:02

前情提要：最近收到不少用户投诉，蘑菇视频 iOS 版的画中画（Picture in Picture，PiP）有时无法启动——按下主屏回到桌面，视频就消失了；或者点击 PiP 按钮没有任何反应。作为产品负责人兼用户体验拥护者，我把这件事当成燃眉之急。经过几天的排查、复现和代码层面的试验，终于把问题锁定并解决。把我的完整思路、排查方法和最终结论写出来，供同类问题参考，也方便你在遇到类似坑时少走弯路。

一、问题概述（用户能看到的症状）

有些机型/系统版本上点击 PiP 没响应。
视频在后台播放时没有出现浮窗。
在某些页面内播放的内容（内嵌网页、广告、某些流媒体）不支持 PiP。
问题偶发，复现不稳定，给定位增加难度。

二、我如何复现与收集线索

固定测试环境：iPhone（iOS 14/15/16）和 iPad（相同版本）各一台。
按步骤复现：打开蘑菇视频——播放同一条视频——点击 PiP（或按主页手势）——观察是否出现 PiP。
使用 Xcode 的 Devices & Simulators 和 macOS Console 监听设备日志，捕捉 PiP 相关报错和系统提示。
对比正常与异常场景的日志，尤其留意 AVFoundation、AVPictureInPictureController、WKWebView 的输出。
在内嵌网页播放器、原生播放器、第三方 SDK 播放器间做区分测试。

三、排查过程与关键发现（技术要点）通过日志和测试，我把可能性逐一排除，最终把问题锁定在两个常见但易被忽视的点上：

1) 内嵌网页（WKWebView）播放没有正确开启 PiP 支持

如果视频是在 WKWebView 中播放，必须在 WKWebViewConfiguration 中设置 allowsPictureInPictureMediaPlayback = true，且页面的 video 元素需要 webkit-playsinline / playsinline。
测试中发现部分内嵌页面缺少 playsinline，或 WKWebView 未开启 allowsInlineMediaPlayback/带 PiP 的配置，导致无法触发系统 PiP。

2) 使用自定义渲染或第三方播放器时未满足 AVPictureInPictureController 的要求

AVPictureInPictureController 仅支持以 AVPlayerLayer 渲染的视频，或者实现了对应 SampleBuffer 委托的场景（更复杂的自渲染要求额外接口）。
部分老版、定制化播放器把画面渲染到 OpenGL/Metal 层，未提供给系统标准的 AVPlayerLayer，从而系统拒绝进入 PiP。日志中通常会看到 “pictureInPicture not possible” 或者 “AVPictureInPictureController is not available” 的提示。
DRM/受保护内容也可能被系统禁止进入 PiP（FairPlay/其他加密策略）。测试时先用非 DRM 的公开视频做对比。

四、最终定位与解决方案（我在代码里的具体改动）定位后，我按两条主线分别修复：

A. 对内嵌网页播放器的修复

初始化 WKWebView 时： let config = WKWebViewConfiguration() config.allowsInlineMediaPlayback = true config.allowsPictureInPictureMediaPlayback = true let webView = WKWebView(frame: .zero, configuration: config)
确保内嵌页面的 video 标签含 playsinline/webkit-playsinline，并且没有被 autoplay 限制在后台阻止。
让前端同学在可控制的页面统一添加 playsinline，或在需要 PiP 的页面用原生播放器替代。

B. 对原生/第三方播放器的修复

优先使用 AVPlayer + AVPlayerLayer，如果必须使用自定义渲染，评估并实现 AVPictureInPictureSampleBufferPlaybackDelegate 的方法，保证 PiP 能接收到视频帧。
检查 AVAudioSession 的 category：使用 playback 类别能确保音频在后台持续，从而 PiP 更稳定。
针对第三方 SDK（尤其是广告或直播插件），和 SDK 提供方确认是否支持 PiP，或在无法支持时回退到原生播放器。

五、用户侧的临时解决办法（给非技术用户的快速排查）