Limited availability
Die HTMLVideoElement
-Methode requestPictureInPicture()
stellt eine asynchrone Anfrage, um das Video im Bild-in-Bild-Modus anzuzeigen.
Es ist nicht garantiert, dass das Video in den Bild-in-Bild-Modus gesetzt wird. Wenn die Berechtigung für diesen Modus erteilt wird, wird das zurückgegebene Promise
aufgelöst und das Video erhält ein enterpictureinpicture
-Ereignis, um anzuzeigen, dass es sich jetzt im Bild-in-Bild-Modus befindet.
requestPictureInPicture()
Parameter
Keine.
RückgabewertEin Promise
, das auf ein PictureInPictureWindow
-Objekt aufgelöst wird, das verwendet werden kann, um zu hören, wann ein Benutzer dieses schwebende Fenster vergröÃert oder verkleinert.
NotSupportedError
DOMException
Ausgelöst, wenn die Funktion nicht unterstützt wird (zum Beispiel, wenn sie durch eine Benutzereinstellung oder durch eine Plattformbeschränkung deaktiviert ist).
SecurityError
DOMException
Ausgelöst, wenn die Funktion durch eine Permissions Policy blockiert wird.
InvalidStateError
DOMException
Ausgelöst, wenn der readState
des Videoelements HAVE_NOTHING
ist, oder wenn das Videoelement keine Videospur hat, oder wenn das disablePictureInPicture
-Attribut des Videoelements true
ist.
NotAllowedError
DOMException
Ausgelöst, wenn document.pictureInPictureElement
null
ist und das Dokument keine transiente Aktivierung hat.
Transiente Benutzeraktivierung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion funktioniert.
BeispieleDieses Beispiel fordert an, dass das Video in den Bild-in-Bild-Modus wechselt, und setzt einen Ereignislistener, um die GröÃenänderung des schwebenden Fensters zu handhaben.
function enterPictureInPicture() {
videoElement.requestPictureInPicture().then((pictureInPictureWindow) => {
pictureInPictureWindow.addEventListener(
"resize",
() => onPipWindowResize(),
false,
);
});
}
Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4