DocumentPictureInPicture:窗口属性

有限可用性

此功能并非基线,因为它在一些使用最广泛的浏览器中无法正常工作。

实验性: 这是一个 实验性技术
在生产环境中使用之前,请仔细查看 浏览器兼容性表

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,在一些或所有 支持的浏览器 中。

windowDocumentPictureInPicture 接口的只读属性,它返回一个表示画中画窗口内浏览上下文的 Window 实例。

如果画中画窗口已使用 DocumentPictureInPicture.requestWindow() 打开,则返回一个 Window 对象实例,否则返回 null

示例

js
const videoPlayer = document.getElementById("player");

// ...

await window.documentPictureInPicture.requestWindow({
  width: videoPlayer.clientWidth,
  height: videoPlayer.clientHeight,
});

// ...

const pipWindow = window.documentPictureInPicture.window;
if (pipWindow) {
  // Mute video playing in the Picture-in-Picture window.
  const pipVideo = pipWindow.document.querySelector("#video");
  pipVideo.muted = true;
}

规范

规范
Document Picture-in-Picture
# dom-documentpictureinpicture-window

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

参见