HTMLMediaElement : méthode seekToNextFrame()
Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
La méthode seekToNextFrame() de l'interface HTMLMediaElement avance de manière asynchrone la position de lecture actuelle vers l'image suivante dans le média.
Attention : Cette méthode non standard fait partie d'un processus d'expérimentation autour du support de l'accès aux médias en dehors du temps réel pour des tâches telles que le filtrage, l'édition, etc. Vous ne devez pas utiliser cette méthode dans du code de production, car son implémentation peut changer ou être supprimée sans préavis. Vous êtes cependant invité à l'expérimenter.
Cette méthode permet d'accéder aux images d'un média vidéo sans que le média ne soit lu en temps réel. Elle permet également d'accéder au média en utilisant les images comme unité de recherche plutôt que les codes temporels (bien que seulement en recherchant une image à la fois jusqu'à atteindre l'image souhaitée). Les utilisations possibles de cette méthode incluent le filtrage et l'édition de contenu vidéo.
Cette méthode retourne immédiatement une promesse (Promise), dont le gestionnaire de résolution est appelé lorsque l'opération de recherche est terminée. De plus, un évènement seeked est envoyé pour informer les parties intéressées qu'une recherche a eu lieu. Si la recherche échoue parce que le média est déjà à la dernière image, un évènement seeked se produit, suivi immédiatement d'un évènement ended.
Si aucun média vidéo n'est présent sur l'élément média, ou si le média n'est pas consultable, rien ne se passe.
Syntaxe
seekToNextFrame()
Paramètres
Aucun.
Valeur de retour
Une promesse (Promise) qui est remplie une fois que l'opération de recherche est terminée.
Spécifications
Ne fait partie d'aucune spécification.