HTMLVideoElement : méthode cancelVideoFrameCallback()
Baseline
2024
Newly available
Depuis October 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
La méthode cancelVideoFrameCallback() de l'interface HTMLVideoElement annule une fonction de rappel de trame vidéo précédemment enregistrée.
Syntaxe
js
cancelVideoFrameCallback(id)
Paramètres
id-
Un nombre représentant l'identifiant de la fonction de rappel de trame vidéo à annuler. Il s'agit de la valeur retournée par l'appel correspondant à
HTMLVideoElement.requestVideoFrameCallback.
Valeur de retour
Aucune (undefined).
Exemples
Annuler une fonction de rappel de trame vidéo
Cet exemple montre comment utiliser cancelVideoFrameCallback() pour annuler une fonction de rappel de trame vidéo précédemment enregistrée.
js
let videoCallbackId = null;
function updateCanvas(now, metadata) {
// Traiter la trame
// …
// Réenregistrer la fonction de rappel pour la prochaine trame
// Il est important de mettre à jour videoCallbackId à chaque itération
// afin de pouvoir annuler la fonction de rappel correctement
videoCallbackId = video.requestVideoFrameCallback(updateCanvas);
}
// Enregistrement initial de la fonction de rappel pour la première trame
videoCallbackId = video.requestVideoFrameCallback(updateCanvas);
// …
// Annuler la fonction de rappel de trame vidéo en utilisant le dernier videoCallbackId
if (videoCallbackId !== null) {
video.cancelVideoFrameCallback(videoCallbackId);
}
Spécifications
| Specification |
|---|
| HTMLVideoElement.requestVideoFrameCallback() # dom-htmlvideoelement-cancelvideoframecallback |