大网数据广告活动
Web 标准与前端开发

PictureInPictureWindow

· 52CE 我爱测

`PictureInPictureWindow`** 接口表示一个能够以编程方式获取浮动视频窗口的 **`width`** 和 **`height`** 和 **`resize event`** 的对象。

Picture-in-Picture API

PictureInPictureWindow 接口表示一个能够以编程方式获取浮动视频窗口的 width 和 height 和 resize event 的对象。

通过使用 HTMLVideoElement.requestPictureInPicture() 函数返回的 promise 值,可以获得此接口的对象。

实例属性

PictureInPictureWindow 接口不继承任何属性。

  • PictureInPictureWindow.width
    • : 获取浮动视频窗口的宽度。
  • PictureInPictureWindow.height
    • : 获取浮动视频窗口的高度。

实例方法

PictureInPictureWindow 接口不继承任何方法。

事件

PictureInPictureWindow 接口不继承任何事件。

  • PictureInPictureWindow.resize_event
    • : 当浮动视频窗口的大小改变时,发送给 PictureInPictureWindow。

示例

给定一个 <button> 和一个 <video>,点击按钮会使视频进入画中画模式;接着我们添加一个事件,将浮动视频窗口的尺寸输出到控制台。

const button = document.querySelector("button");
const video = document.querySelector("video");

function printPipWindowDimensions(evt) {
  const pipWindow = evt.target;
  console.log(`浮动窗口的尺寸为:${pipWindow.width}x${pipWindow.height}px`);
  // 将会打印:
  // 浮动窗口的尺寸为:640x360px
}

button.onclick = () => {
  video.requestPictureInPicture().then((pictureInPictureWindow) => {
    pictureInPictureWindow.onresize = printPipWindowDimensions;
  });
};

规范

浏览器兼容性

参见

  • Picture-in-Picture_API

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。