Dokument: exitPictureInPicture() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Die exitPictureInPicture() Methode des Document-Interfaces
fordert an, dass ein Video, das sich derzeit in diesem Dokument befindet und im Floating-Modus ist, aus dem Picture-in-Picture-Modus herausgenommen wird und der vorherige Bildschirmzustand wiederhergestellt wird. Dies kehrt normalerweise die Effekte eines vorherigen Aufrufs von HTMLVideoElement.requestPictureInPicture() um.
Syntax
exitPictureInPicture()
Parameter
Keine.
Rückgabewert
Ein Promise, das aufgelöst wird, sobald der user agent den Picture-in-Picture-Modus verlassen hat. Wenn beim Versuch, den Vollbildmodus zu verlassen, ein Fehler auftritt, wird der catch()-Handler für das Promise aufgerufen.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn
document.pictureInPictureElementnullist.
Beispiele
Dieses Beispiel sorgt dafür, dass das aktuelle Dokument den Picture-in-Picture-Modus verlässt, sobald die Maustaste innerhalb des Dokuments gedrückt wird.
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();
}
};
Beachten Sie, dass, wenn Sie verfolgen möchten, welches Video auf Ihrer Seite derzeit im Picture-in-Picture-Modus abgespielt wird, Sie auf die enterpictureinpicture- und leavepictureinpicture-Ereignisse auf dem/den betreffenden HTMLVideoElement hören sollten. Alternativ können Sie überprüfen, ob Document.pictureInPictureElement auf das aktuelle HTMLVideoElement verweist.
Spezifikationen
| Spezifikation |
|---|
| Picture-in-Picture # dom-document-exitpictureinpicture |