画中画（PiP）是一种将视频显示在浏览器顶层窗口的模式，以便在多任务处理时观看视频。不同浏览器支持的画中画功能各不相同，可用选项也随之不同。

画中画类型

• 视频元素画中画
• 文档画中画
• 浏览器原生 - 浏览器专有的画中画实现，无法通过 API 进行控制

视频元素画中画

此画中画模式现已在大多数浏览器中可用，但值得注意的是 Firefox 除外。视频元素可以被放入一个单独的窗口中。

此模式存在一些局限性，可能使其不适用于某些用例。由于画中画窗口中只有视频，Video.js 播放器控件将不会显示，模拟的文本轨道或任何覆盖层、交互元素也不会显示。如果视频源会发生变化，特别是对于广告，此模式也无用。如果需要，可以禁用它。

默认情况下，如果浏览器支持画中画 API，此模式将启用。如果在支持的浏览器上启用了文档画中画模式，则该模式将优先。

文档画中画

在 v8.3.0 中添加

文档画中画是一种改进的方法，可以将整个播放器元素而不是仅仅是视频放置在画中画窗口中。这允许使用播放器控件、文本轨道和覆盖层。

目前，Chrome 和 Edge 116 及更高版本支持此功能。videojs.com 上的播放器将在支持的浏览器上使用此模式。

目前，此模式默认为关闭，但可以通过播放器选项简单地启用。如果启用，并且浏览器支持，此模式将优先于视频画中画模式。

浏览器原生画中画

Firefox 没有实现画中画 API。它拥有专有的画中画模式，并在视频上方显示一个画中画按钮。

无法通过编程方式自定义或移除此按钮，也无法从自定义控件启动画中画。Video.js 的画中画选项对其无效。

选项

视频元素画中画 (vPiP) 的 disablePictureInPicture 选项和文档画中画 (docPiP) 的 enableDocumentPictureInPicture 选项彼此独立，因此可以在支持文档画中画的浏览器上使用改进的文档画中画模式，同时在不支持视频元素画中画的浏览器上禁用该模式。

* 以上任何选项都对 Firefox 的行为无效。