HTMLVideoElement: cancelVideoFrameCallback() Methode
Baseline
2024
Neu verfügbar
Seit October 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die cancelVideoFrameCallback()-Methode des HTMLVideoElement Interfaces storniert einen zuvor registrierten Video Frame Callback.
Syntax
js
cancelVideoFrameCallback(id)
Parameter
id-
Eine Zahl, die die ID des Video Frame Callbacks darstellt, den Sie stornieren möchten. Dies wird der Wert sein, der von dem entsprechenden
HTMLVideoElement.requestVideoFrameCallbackAufruf zurückgegeben wird.
Rückgabewert
Keiner (undefined).
Beispiele
Einen Video Frame Callback stornieren
Dieses Beispiel zeigt, wie cancelVideoFrameCallback() verwendet wird, um einen zuvor registrierten Video Frame Callback zu stornieren.
js
let videoCallbackId = null;
function updateCanvas(now, metadata) {
// Do something with the frame
// …
// Re-register the callback to run on the next frame
// It's important to update the videoCallbackId on each iteration
// so you can cancel the callback successfully
videoCallbackId = video.requestVideoFrameCallback(updateCanvas);
}
// Initial registration of the callback to run on the first frame
videoCallbackId = video.requestVideoFrameCallback(updateCanvas);
// …
// Cancel video frame callback using the latest videoCallbackId
if (videoCallbackId !== null) {
video.cancelVideoFrameCallback(videoCallbackId);
}
Spezifikationen
| Spezifikation |
|---|
| HTMLVideoElement.requestVideoFrameCallback() # dom-htmlvideoelement-cancelvideoframecallback |
Browser-Kompatibilität
Siehe auch
- Das
<video>Element HTMLVideoElement.requestVideoFrameCallback()- Effiziente pro-Video-Frame-Operationen mit
requestVideoFrameCallback()durchführen auf developer.chrome.com (2023)