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

HTMLVideoElement:requestPictureInPicture() 方法

· 52CE 我爱测

HTMLVideoElement** 接口提供的 **`requestPictureInPicture()`** 方法会发出异步请求,并以画中画的模式显示视频。

Picture-in-Picture API

HTMLVideoElement 接口提供的 requestPictureInPicture() 方法会发出异步请求,并以画中画的模式显示视频。

该方法不能保证视频进入画中画。如果授予了进入画中画的权限,则返回的 Promise 会兑现,且视频将收到一个 HTMLVideoElement.enterpictureinpicture_event 事件,来表示它现在处于画中画状态。

语法

requestPictureInPicture()

参数

无。

返回值

Promise,会兑现一个可用于监听用户何时调整该浮动窗口的大小的 PictureInPictureWindow 对象。

异常

  • NotSupportedError DOMException
    • : 如果该特性不受支持(例如,被用户偏好设置或平台限制禁用),则抛出该异常。
  • SecurityError DOMException
    • : 如果该功能被权限策略阻止,则抛出该异常。
  • InvalidStateError DOMException
    • : 如果视频元素的 readState 为 HAVE_NOTHING,或者视频元素没有视频轨道,或者视频元素的 disablePictureInPicture 属性为 true,则抛出该异常。
  • NotAllowedError DOMException
    • : 如果 document.pictureInPictureElement 为 null 且文档没有transient activation,则抛出错误。

安全

需要瞬态用户激活。用户必须与页面或 UI 元素进行交互,才能使用此特性。

示例

本示例请求视频进入画中画模式,并设置事件监听以处理窗口大小的调整。

function enterPictureInPicture() {
  videoElement.requestPictureInPicture().then((pictureInPictureWindow) => {
    pictureInPictureWindow.addEventListener(
      "resize",
      () => onPipWindowResize(),
      false,
    );
  });
}

规范

浏览器兼容性

参见

  • video 元素
  • HTMLVideoElement.disablePictureInPicture
  • Document.pictureInPictureEnabled
  • Document.exitPictureInPicture()
  • Document.pictureInPictureElement
  • :picture-in-picture

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

资料来源与适用范围

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

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

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