文件: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

瀏覽器相容性

另見