Classe VideoPlayer
Héritage MovieClip > Classe VideoPlayer
Nom de classe ActionScript mx.video.VideoPlayer
VideoPlayer étend la classe MovieClip et englobe un objet Video.
|
REMARQUE |
|
La classe VideoPlayer est prise en charge uniquement si vous travaillez dans un document spécifiant ActionScript 2.0 dans ses paramètres de publication. |
La classe FLVPlayback englobe la classe VideoPlayer, à ce sujet Adobe vous conseille vivement d'utiliser la classe FLVPlayback dans la plupart des cas. Aucune fonctionnalité de la classe VideoPlayer n'est accessible via la classe FLVPlayback.
La classe VideoPlayer est incluse ici, car elle vous permet de créer un lecteur vidéo avec un fichier SWF plus petit. Elle ne vous permet pas d'inclure des commandes d'enveloppe ou de lecture, et possède une API plus petite. Par exemple, vous ne pouvez pas rechercher de points de repère, même si des événements cuePoint se produisent.
Par ailleurs, la classe FLVPlayback crée automatiquement une interface avec la classe NCManager pour accéder aux fichiers FLV à diffusion en flux continu sur un serveur FMS, par exemple. Vous interagissez avec la classe NCManager lorsque vous définissez la propriété contentPath et lorsque vous transmettez une URL aux méthodes play() et load(). Cependant, si vous utilisez la classe VideoPlayer proprement dite, vous devez inclure l'instruction suivante dans votre code ActionScript afin de garantir l'inclusion de la classe NCManager :
_forceNCManager:mx.video.NCManager;
La classe NCManager possède également une classe d'interface, INCManager, qui vous permet de remplacer la classe NCManager par une classe personnalisée permettant de gérer les communications réseau. Le cas échéant, vous devez inclure l'instruction suivante, en remplaçant NCManager par le nom de la classe que vous avez indiqué :
mx.video.VideoPlayer.DEFAULT_INCMANAGER = "mx.video.NCManager";
Vous n'êtes pas tenu d'ajouter cette instruction si vous utilisez la classe NCManager par défaut.
|
REMARQUE |
|
Vous pouvez également définir DEFAULT_INCMANAGER pour remplacer mx.video.NCManager par défaut par le composant FLVPlayback. |
NCManager prend en charge un sous-ensemble de SMIL afin de gérer plusieurs flux continus pour plusieurs bandes passantes. Pour plus d'informations, voir Utilisation d'un fichier SMIL.
Cette section récapitule la classe VideoPlayer. Vous pouvez trouver une documentation détaillée sur les méthodes, les propriétés et les événements de la classe VideoPlayer à l'adresse suivante www.adobe.com/go/videoplayer_fr.
Récapitulatif des méthodes de la classe VideoPlayer
Le tableau suivant répertorie les méthodes de la classe VideoPlayer.
|
Méthode |
Description |
|---|---|
| VideoPlayer.addEventListener() |
Crée un écouteur pour un événement spécifié. |
| VideoPlayer.close() |
Ferme le flux vidéo et la connexion FMS. |
| VideoPlayer.load() |
Charge le fichier FLV sans commencer la lecture. Le fichier FLV est mis en pause après le redimensionnement (si besoin). |
| VideoPlayer.pause() |
Interrompt la lecture du flux vidéo en continu. |
| VideoPlayer.play() |
Commence la lecture du flux vidéo en continu. |
| VideoPlayer.removeEventListener() |
Supprime un écouteur d'événement. |
| VideoPlayer.seek() |
Recherche une heure donnée (en secondes) dans le fichier, avec une précision décimale allant jusqu'aux millisecondes. |
| VideoPlayer.setScale() |
Définit simultanément scaleX et scaleY. |
| VideoPlayer.setSize() |
Définit simultanément les propriétés width et height. |
| VideoPlayer.stop() |
Arrête la lecture du flux vidéo en continu. |
Récapitulatif des propriétés de la classe VideoPlayer
La classe VideoPlayer possède des propriétés de classe et d'occurrence.
Les propriétés indiquées ci-dessous ne concernent que la classe VideoPlayer. Il s'agit de constantes en lecture seule qui s'appliquent à toutes les occurrences de la classe VideoPlayer.
|
Propriété |
Valeur |
Description |
|---|---|---|
| VideoPlayer.BUFFERING |
"buffering" |
Valeur possible de la propriété state. Indique l'état dans lequel le composant entre immédiatement après l'appel aux méthodes play() ou load(). |
| VideoPlayer.CONNECTION_ERROR |
"connectionError" |
Valeur possible de la propriété state. Indique une erreur de connexion. |
| VideoPlayer.DEFAULT_INCMANAGER |
"mx.video.NCManager" |
Nom de l'interface INCManager par défaut (mx.video.NCManager) ou implémentation personnalisée de cette interface. |
| VideoPlayer.DISCONNECTED |
"disconnected" |
Valeur possible de la propriété state. Indique la déconnexion du flux continu du fichier FLV. |
| VideoPlayer.LOADING |
"loading" |
Valeur possible de la propriété state. Indique le chargement du fichier FLV. |
| VideoPlayer.PAUSED |
"paused" |
Valeur possible de la propriété state. Indique que le fichier FLV est en pause. |
| VideoPlayer.PLAYING |
"playing" |
Valeur possible de la propriété state. Indique que le fichier FLV est en cours de lecture. |
| VideoPlayer.RESIZING |
"resizing" |
Valeur possible de la propriété state. Indique que le fichier FLV est en cours de redimensionnement. |
| VideoPlayer.REWINDING |
"rewinding" |
Valeur possible de la propriété state. Indique que le fichier FLV est en cours de rembobinage. |
| VideoPlayer.SEEKING |
"seeking" |
Valeur possible de la propriété state. Indique que le fichier FLV est en cours de recherche. |
| VideoPlayer.STOPPED |
"stopped" |
Valeur possible de la propriété state. Indique que le fichier FLV est arrêté. |
| VideoPlayer.version |
x.x.x.xx |
Nombre correspondant au numéro de version du composant. |
Le tableau suivant répertorie les propriétés des occurrences de la classe VideoPlayer.
Cet ensemble de propriétés s'applique à chaque occurrence d'une classe VideoPlayer.
|
Propriété |
Description |
|---|---|
| VideoPlayer.autoRewind |
Valeur booléenne qui, si elle est définie sur true, provoque le rembobinage du fichier FLV jusqu'à la première image lorsque la lecture s'arrête. |
| VideoPlayer.autoSize |
Valeur booléenne qui, si elle est définie sur true, redimensionne automatiquement la vidéo aux dimensions sources. |
| VideoPlayer.bufferTime |
Nombre de secondes à mettre en mémoire tampon avant de commencer la lecture d'un flux vidéo. |
| VideoPlayer.bytesLoaded |
Nombre indiquant le degré de téléchargement en nombre d'octets pour un téléchargement HTTP. Lecture seule. |
| VideoPlayer.bytesTotal |
Nombre total d'octets téléchargés pour un téléchargement HTTP. Lecture seule. |
| VideoPlayer.connected |
Valeur booléenne indiquant si le flux du fichier FLV est connecté. Lecture seule. |
| VideoPlayer.height |
Nombre indiquant la hauteur de la vidéo en pixels. |
| VideoPlayer.idleTimeout |
urée (en millisecondes) avant qu'une connexion inactive au serveur FMS (en raison de l'interruption ou de l'arrêt de la lecture) soit arrêtée. |
| VideoPlayer.isLive |
Valeur booléenne définie sur true si le flux vidéo est en direct. Ne s'applique pas à un téléchargement HTTP. |
| VideoPlayer.isRTMP |
Valeur booléenne définie sur true si le fichier FLV est en cours de diffusion en flux continu à partir de FMS. Lecture seule. |
| VideoPlayer.maintainAspectRatio |
Valeur booléenne qui, si elle est définie sur true, conserve les proportions de la vidéo. |
| VideoPlayer.metadata |
Objet représentant un paquet d'informations de métadonnées reçu à partir d'un appel à la fonction de rappel onMetaData(), le cas échéant. Lecture seule. |
| VideoPlayer.ncMgr |
Objet INCManager fournissant l'accès à une occurrence de la classe implémentant INCManager |
| VideoPlayer.playheadTime |
Nombre représentant la durée de lecture (ou position de la tête de lecture) actuelle, mesurée en secondes, qui peut être une valeur décimale. |
| VideoPlayer.playheadUpdateInterval |
Nombre représentant l'intervalle (en millisecondes) entre chaque événement playheadUpdate. |
| VideoPlayer.progressInterval |
Nombre représentant l'intervalle (en millisecondes) entre chaque événement progress. |
| VideoPlayer.scaleX |
Nombre indiquant le redimensionnement horizontal. |
| VideoPlayer.scaleY |
Nombre indiquant le redimensionnement vertical. |
| VideoPlayer.state |
Chaîne indiquant l'état du composant. Définie avec les méthodes load(), play(), stop(), pause() et seek(). Lecture seule. |
| VideoPlayer.stateResponsive |
Valeur booléenne définie sur true si l'état est réactif, c'est-à-dire si les commandes peuvent être activées dans l'état actuel. Lecture seule. |
| VideoPlayer.totalTime |
Chiffre représentant la durée de lecture totale pour |
| VideoPlayer.transform |
Objet permettant d'accéder directement aux méthodes Sound.setTransform() et Sound.getTransform() afin de fournir un meilleur son. |
| VideoPlayer.url |
Chaîne indiquant l'URL du flux continu chargé (ou en cours de chargement). |
| VideoPlayer.videoHeight |
Nombre indiquant la hauteur du fichier FLV. |
| VideoPlayer.videoWidth |
Nombre indiquant la largeur du fichier FLV. |
| VideoPlayer.visible |
Valeur booléenne qui, si elle est définie sur true, rend le fichier FLV visible. |
| VideoPlayer.volume |
Nombre compris entre 0 et 100 indiquant le réglage de contrôle du volume. |
| VideoPlayer.width |
Nombre indiquant (en pourcentage) jusqu'où l'utilisateur peut déplacer la poignée de la barre de volume avant qu'une mise à jour se produise. |
| VideoPlayer.x |
Chiffre indiquant la dimension horizontale du lecteur vidéo en pixels. |
| VideoPlayer.y |
Chiffre indiquant la dimension verticale du lecteur vidéo en pixels. |
Récapitulatif des événements de la classe VideoPlayer
Le tableau suivant répertorie les événements de la classe VideoPlayer.
|
Evénement |
Description |
|---|---|
| VideoPlayer.close |
Distribué lorsque le flux vidéo est fermé, via un timeout ou un appel à la méthode close(). |
| VideoPlayer.complete |
Distribué lorsque la lecture se termine en atteignant la fin du fichier FLV. |
| VideoPlayer.cuePoint |
Distribué lorsqu'un point de repère est atteint. |
| VideoPlayer.metadataReceived |
Distribué la première fois que les métadonnées du fichier FLV sont atteintes. |
| VideoPlayer.playheadUpdate |
Distribué toutes les 0,25 secondes lors de la lecture du fichier FLV. |
| VideoPlayer.progress |
Distribué toutes les 0,25 secondes, en commençant lorsque la méthode load() est appelée et en se terminant lorsque tous les octets sont chargés ou en cas d'erreur réseau. |
| VideoPlayer.ready |
Distribué lorsque le fichier FLV est chargé et prêt à être affiché. |
| VideoPlayer.resize |
Distribué lors du redimensionnement de la vidéo. |
| VideoPlayer.rewind |
Distribué lorsque l'emplacement de la tête de lecture recule suite à un appel à la méthode seek() ou à la fin du rembobinage automatique. |
| VideoPlayer.stateChange |
Distribué lorsque l'état de lecture est modifié. |