文档:exitPictureInPicture() 方法
exitPictureInPicture() 方法是 Document 接口的一部分,它请求退出当前文档中浮动的视频的画中画模式,并恢复屏幕的先前状态。这通常会撤销之前调用 HTMLVideoElement.requestPictureInPicture() 的效果。
语法
js
exitPictureInPicture()
参数
无。
返回值
一个 Promise,一旦 用户代理 完成退出画中画模式,该 Promise 就会被解析。如果在尝试退出全屏模式时发生错误,则会调用 Promise 的 catch() 处理程序。
异常
InvalidStateErrorDOMException-
如果
document.pictureInPictureElement为null,则会抛出此错误。
示例
此示例会在用户在此文档内单击鼠标按钮时,使当前文档退出画中画模式。
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 元素的 enterpictureinpicture 和 exitpictureinpicture 事件。或者,您也可以检查 Document.pictureInPictureElement 是否引用了当前的 HTMLVideoElement 元素。
规范
| 规范 |
|---|
| 画中画 # dom-document-exitpictureinpicture |
浏览器兼容性
加载中…