哪些浏览器支持文档画中画 API？有哪些已知限制？

文档画中画 API (Document Picture-in-Picture API) 目前支持桌面端 Chrome 116+、Edge 116+、Opera 102+ 和 Firefox 151+。该 API 不支持任何移动浏览器，包括 Android Chrome、Android Firefox 和 iOS Safari。macOS Safari 也不支持。根据 Can I Use 的数据，全球浏览器覆盖率约为 26.39%。

DualPiP 完全依赖这个 API 来创建始终置顶的浮动播放器，包括字幕、控制面板和学习模式等功能。如果你的浏览器不支持文档画中画 API，DualPiP 的核心功能将无法使用。

哪些桌面浏览器支持文档画中画？

所有基于 Chromium 内核的桌面浏览器 116 版本及以上均完全支持文档画中画 API。Firefox 从 2026 年的 151 版本开始支持。截至 2026 年 8 月，macOS Safari 不支持该 API。

文档画中画在手机上能用吗？

不能。文档画中画 API 不支持任何移动浏览器。Android Chrome、Android Firefox、iOS Safari、Samsung Internet 以及所有其他移动浏览器都不支持。

Google Chromium 团队表示，Android 的窗口系统不容易支持带有交互内容的始终置顶窗口。Android 文档画中画的开发正在实验性标志后面进行，但没有公布稳定版发布日期。

如果你在移动端有双语字幕需求，CaptionGo 可以直接在视频页面上显示字幕，无需画中画。

PiP 窗口的标题栏可以隐藏吗？

不可以。PiP 窗口始终显示标题栏，包含网站来源信息和关闭按钮。这是浏览器强制的安全措施，目的是防止内容欺骗 — 用户必须能够识别哪个网站创建了浮动窗口。

disallowReturnToOpener 选项可以隐藏标题栏内的"返回标签页"按钮，但标题栏本身无法移除或隐藏。Chrome 工程师在 WICG Issue #121 中确认了这一限制。

PiP 窗口内可以全屏吗？

不可以。全屏 API 在文档画中画窗口内被明确禁用。这一限制已通过 WICG Issue #133 和 PR #153 正式写入规范。

PiP 窗口可以手动调整到浏览器允许的最大尺寸。使用 DualPiP 的「适应窗口」按钮（快捷键 T）可以在限制范围内最大化观看区域。

PiP 窗口会抢占键盘焦点吗？

会。打开文档画中画窗口时可能会从当前浏览器标签页抢占键盘焦点。例如按 Ctrl+T 打开新标签页时，PiP 窗口可能会捕获焦点而不是地址栏。这是一个已知问题，记录在 WICG Issue #146。

解决方法是在 PiP 窗口打开后，点击浏览器标签页或地址栏来恢复焦点。

同时可以打开几个 PiP 窗口？

每个浏览器同一时间只允许打开一个文档画中画窗口。打开第二个 PiP 窗口会自动关闭第一个。这是 API 规范中浏览器强制执行的限制。

关闭或导航原始标签页时 PiP 窗口会怎样？

PiP 窗口与打开它的标签页永久绑定。如果原始标签页被关闭、导航到新页面或刷新，PiP 窗口会自动关闭。这意味着使用 DualPiP 画中画播放器时，原始视频页面必须保持在后台打开。

如何获得最佳 DualPiP 使用体验？

• •使用受支持的桌面浏览器：Chrome、Edge、Brave、Vivaldi 或 Arc（116+ 版本），或 Firefox 151+
• •最大化 PiP 窗口：按 T 键使视频适应窗口，或拖拽边缘调整大小
• •使用键盘快捷键：按 Ctrl+Shift+E 快速切换画中画模式
• •保持原始标签页打开：使用画中画时不要关闭或导航离开视频页面
• •移动端字幕需求：试试 CaptionGo，可在任何平台的视频页面上直接显示双语字幕

参考资料

• •Document Picture-in-Picture API — Chrome 开发者文档
• •Can I Use: DocumentPictureInPicture API
• •WICG 文档画中画规范
• •WICG GitHub Issues