文档:exitPictureInPicture() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

exitPictureInPicture() 方法是 Document 接口的一部分,它请求退出当前文档中浮动的视频的画中画模式,并恢复屏幕的先前状态。这通常会撤销之前调用 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 元素。

规范

规范
画中画
# dom-document-exitpictureinpicture

浏览器兼容性

另见