文件: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 |
瀏覽器相容性
載入中…