文档:exitPictureInPicture() 方法

有限可用性

此功能不是基线功能,因为它在一些最常用的浏览器中无法正常工作。

**Document 接口的** exitPictureInPicture() **方法请求退出当前文档中处于浮动状态的视频的画中画模式,恢复屏幕之前的状态。这通常会撤销之前对** HTMLVideoElement.requestPictureInPicture() **的调用产生的效果。

语法

js
exitPictureInPicture()

参数

无。

返回值

一个 Promise,当 用户代理 完成退出画中画模式后,该 Promise 会被解析。如果在尝试退出画中画模式时发生错误,则会调用 Promise 的 catch() 处理程序。

异常

InvalidStateError DOMException

如果 document.pictureInPictureElementnull,则抛出此异常。

示例

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

js
document.onclick = (event) => {
  if (document.pictureInPictureElement) {
    document
      .exitPictureInPicture()
      .then(() => console.log("Document Exited from Picture-in-Picture mode"))
      .catch((err) => console.error(err));
  } else {
    video.requestPictureInPicture();
  }
};

请注意,如果您想跟踪页面上哪个视频当前正在画中画模式下播放,则应侦听相关 HTMLVideoElement 元素上的 enterpictureinpictureexitpictureinpicture 事件。或者,您可以检查 Document.pictureInPictureElement 是否引用当前的 HTMLVideoElement 元素。

规范

规范
画中画
# ref-for-dom-document-exitpictureinpicture

浏览器兼容性

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

另请参阅