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

Document:exitPictureInPicture() 方法

· 52CE 我爱测

Document 接口的 **`exitPictureInPicture()`** 方法请求退出以画中画模式浮动在此文档中播放的视频,来恢复屏幕之前的状态。这通常与先前调用的 HTMLVideoElement.requestPictureInPicture() 相反。

Picture-in-Picture API

Document 接口的 exitPictureInPicture() 方法请求退出以画中画模式浮动在此文档中播放的视频,来恢复屏幕之前的状态。这通常与先前调用的 HTMLVideoElement.requestPictureInPicture() 相反。

语法

exitPictureInPicture()

参数

无。

返回值

一个 Promise,在user agent退出画中画模式时兑现。如果在尝试退出全屏模式时发生错误,将会调用 promise 的 catch() 处理程序。

异常

  • InvalidStateError DOMException
    • : 如果 document.pictureInPictureElement 为 null,则抛出该异常。

示例

此示例使当前文档在鼠标点击按钮时退出画中画模式。

document.onclick = (event) => {
  if (document.pictureInPictureElement) {
    document
      .exitPictureInPicture()
      .then(() => console.log("文档已退出画中画模式"))
      .catch((err) => console.error(err));
  } else {
    video.requestPictureInPicture();
  }
};

注意,如果你想要跟踪页面上正在以画中画模式播放的视频,你应该在 HTMLVideoElement 元素上监听 enterpictureinpicture 和 exitpictureinpicture 事件。或者,你可以检查 Document.pictureInPictureElement 元素是否引用了当前的 HTMLVideoElement 元素。

规范

浏览器兼容性

参见

  • HTMLVideoElement.requestPictureInPicture()
  • HTMLVideoElement.disablePictureInPicture
  • Document.pictureInPictureEnabled
  • 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

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

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