Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

HTMLVideoElement: cancelVideoFrameCallback() Methode

Baseline 2024
Newly available

Since ⁨October 2024⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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.requestVideoFrameCallback Aufruf 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

Specification
HTMLVideoElement.requestVideoFrameCallback()
# dom-htmlvideoelement-cancelvideoframecallback

Browser-Kompatibilität

Siehe auch