HTMLMediaElement : mthode seekToNextFrame()

Obsolte

vitez d'utiliser cette fonctionnalit dans de nouveaux projets. Cette fonctionnalit peut tre candidate la suppression des standards web ou des navigateurs.

En savoir plus
Voir la compatibilit complte

Non standard: Cette fonctionnalit n'est pas standardise. Nous dconseillons d'utiliser des fonctionnalits non standard en production, car leur prise en charge par les navigateurs est limite, et elles peuvent tre modifies ou supprimes. Toutefois, elles peuvent constituer une alternative approprie dans certains cas o aucune option standard n'existe.

La mthode seekToNextFrame() de l'interface HTMLMediaElement avance de manire asynchrone la position de lecture actuelle vers l'image suivante dans le mdia.

Attention : Cette mthode non standard fait partie d'un processus d'exprimentation autour du support de l'accs aux mdias en dehors du temps rel pour des tches telles que le filtrage, l'dition, etc. Vous ne devez pas utiliser cette mthode dans du code de production, car son implmentation peut changer ou tre supprime sans pravis. Vous tes cependant invit l'exprimenter.

Cette mthode permet d'accder aux images d'un mdia vido sans que le mdia ne soit lu en temps rel. Elle permet galement d'accder au mdia en utilisant les images comme unit de recherche plutt que les codes temporels (bien que seulement en recherchant une image la fois jusqu' atteindre l'image souhaite). Les utilisations possibles de cette mthode incluent le filtrage et l'dition de contenu vido.

Cette mthode retourne immdiatement une promesse (Promise), dont le gestionnaire de rsolution est appel lorsque l'opration de recherche est termine. De plus, un vnement seeked est envoy pour informer les parties intresses qu'une recherche a eu lieu. Si la recherche choue parce que le mdia est dj la dernire image, un vnement seeked se produit, suivi immdiatement d'un vnement ended.

Si aucun mdia vido n'est prsent sur l'lment mdia, ou si le mdia n'est pas consultable, rien ne se passe.