Packagefl.video
Classepublic class VideoPlayer
HéritageVideoPlayer Inheritance Video Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

La classe VideoPlayer permet de créer un lecteur vidéo avec un fichier SWF légèrement plus petit que si vous utilisiez le composant FLVPlayback. Contrairement au composant FLVPlayback, la classe VideoPlayer ne permet pas d'inclure une enveloppe ou des contrôles de lecture et, bien que vous ne puissiez pas rechercher ou accéder à des points de repère, les événements cuePoint se produisent. La classe FLVPlayback englobe la classe VideoPlayer.

La classe FLVPlayback s'applique dans la quasi totalité des cas dans la mesure où aucune des fonctionnalités de la classe VideoPlayer ne sont accessibles à l'aide de la classe FLVPlayback.

Par ailleurs, la classe FLVPlayback crée automatiquement une interface avec la classe NCManager pour accéder aux fichiers FLV à diffusion en flux continu (streaming) sur un serveur vidéo, par exemple Flash Media Server. 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 :

var _forceNCManager:fl.video.NCManager;

La classe NCManager implémente une interface, INCManager, et peut être remplacée par une classe personnalisée pour gérer les communications réseau qui mettent cette interface en œuvre. Le cas échéant, vous devez inclure l'instruction suivante, en remplaçant NCManager par le nom de la classe que vous avez indiqué :

fl.video.VideoPlayer.iNCManagerClass = fl.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 iNCManagerClass pour remplacer la valeur par défaut, fl.video.NCManager, lors de l'utilisation du composant FLVPlayback.

NCManager prend en charge un sous-ensemble de SMIL afin de gérer plusieurs flux continus pour plusieurs bandes passantes.

Consulter les exemples

Voir aussi

NCManager
FLVPlayback


Propriétés publiques
 PropriétéDéfini par
 InheritedaccessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage.
DisplayObject
  align : String
Indique comment la vidéo est affichée par rapport aux propriétés registrationX, registrationY, registrationWidth et registrationHeight.
VideoPlayer
 Inheritedalpha : Number
Indique la valeur de transparence alpha de l'objet spécifié.
DisplayObject
  autoRewind : Boolean
Valeur booléenne qui, si elle est définie sur true, provoque le rembobinage du fichier FLV jusqu'à l'image 1 lorsque la lecture s'arrête, soit parce que le lecteur a atteint la fin du flux, soit parce que la méthode stop() a été appelée.
VideoPlayer
 InheritedblendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser.
DisplayObject
  bufferTime : Number
Nombre de secondes à mettre en mémoire tampon avant de commencer la lecture d'un flux vidéo.
VideoPlayer
  bytesLoaded : uint
[lecture-seule] Nombre indiquant le degré de téléchargement en nombre d'octets pour un téléchargement HTTP.
VideoPlayer
  bytesTotal : uint
[lecture-seule] Nombre total d'octets téléchargés pour un téléchargement HTTP.
VideoPlayer
 InheritedcacheAsBitmap : Boolean
Si true est défini, Flash Player place en mémoire cache une version bitmap interne de l’objet d'affichage.
DisplayObject
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 Inheriteddeblocking : int
Indique le type de filtre appliqué aux vidéos décodées dans le cadre du post-traitement.
Video
 Inheritedfilters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage.
DisplayObject
  height : Number
[write-only] Nombre indiquant la hauteur de l'occurrence de VideoPlayer, en pixels.
VideoPlayer
  idleTimeout : Number
Temps écoulé (en millisecondes) avant que Flash mette fin à une connexion inactive à un serveur vidéo (tel que Flash Media Server) en raison de l'interruption ou de l'arrêt de la lecture.
VideoPlayer
  iNCManagerClass : Object = fl.video.NCManager
[static] Pour que tous les objets VideoPlayer exploitent votre classe personnalisée en tant que mise en œuvre d'INCManager par défaut, définissez la propriété iNCManagerClass sur l'objet classe ou le nom de chaîne de votre classe personnalisée.
VideoPlayer
  isLive : Boolean
[lecture-seule] Valeur booléenne définie sur true si le flux vidéo est en direct.
VideoPlayer
  isRTMP : Boolean
[lecture-seule] Valeur booléenne définie sur true si le fichier FLV est en diffusion en flux continu (streaming) à partir d'un serveur FMS via RTMP.
VideoPlayer
 InheritedloaderInfo : LoaderInfo
[lecture-seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage.
DisplayObject
 Inheritedmask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié.
DisplayObject
  metadata : Object
[lecture-seule] Objet représentant un paquet de métadonnées reçu par un appel à la méthode de rappel NetSteam.onMetaData(), le cas échéant.
VideoPlayer
 InheritedmouseX : Number
[lecture-seule] Indique la coordonnée x de la position de la souris, en pixels.
DisplayObject
 InheritedmouseY : Number
[lecture-seule] Indique la coordonnée y de la position de la souris, en pixels.
DisplayObject
 Inheritedname : String
Indique le nom d’occurrence de DisplayObject.
DisplayObject
  ncMgr : INCManager
[lecture-seule] Objet INCManager qui permet d'accéder à une occurrence de la classe implémentant INCManager, interface de la classe NCManager.
VideoPlayer
  netConnection : NetConnection
[lecture-seule] Permet d'accéder directement à l'instance de NetConnection créée par le lecteur vidéo.
VideoPlayer
  netStream : NetStream
[lecture-seule] Permet d'accéder directement à l'instance de NetStream créée par le lecteur vidéo.
VideoPlayer
  netStreamClientClass : Object
[static] Enregistre une classe personnalisée pour la propriété client de NetStream.
VideoPlayer
 InheritedopaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d'arrière-plan spécifique.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[lecture-seule] Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage.
DisplayObject
  playheadTime : Number
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 : Number
Nombre représentant l'intervalle (en millisecondes) entre chaque événement playheadUpdate.
VideoPlayer
  progressInterval : Number
Nombre représentant l'intervalle (en millisecondes) entre chaque événement progress.
VideoPlayer
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  registrationHeight : Number
Hauteur utilisée pour aligner le contenu vidéo lors d'un redimensionnement automatique.
VideoPlayer
  registrationWidth : Number
Largeur utilisée pour aligner le contenu vidéo lors d'un redimensionnement automatique.
VideoPlayer
  registrationX : Number
Coordonnée x utilisée pour aligner le contenu vidéo lors d'un redimensionnement automatique.
VideoPlayer
  registrationY : Number
Coordonnée y utilisée pour aligner le contenu vidéo lors d'un redimensionnement automatique.
VideoPlayer
 Inheritedroot : DisplayObject
[lecture-seule] Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier.
DisplayObject
 Inheritedrotation : Number
Indique la rotation de l'occurrence de DisplayObject, en degrés, à partir de son orientation d'origine.
DisplayObject
 Inheritedscale9Grid : Rectangle
Grille de mise à l’échelle en vigueur.
DisplayObject
  scaleMode : String
Spécifie le redimensionnement de la vidéo après le chargement.
VideoPlayer
  scaleX : Number
[write-only] Nombre indiquant l'échelle horizontale.
VideoPlayer
  scaleY : Number
[write-only] Nombre indiquant l'échelle verticale.
VideoPlayer
 InheritedscrollRect : Rectangle
Cadre de délimitation du défilement de l’objet d’affichage.
DisplayObject
 Inheritedsmoothing : Boolean
Indique si la vidéo doit être lissée (interpolée) lors de son redimensionnement.
Video
  soundTransform : SoundTransform
Ménage un accès direct à la propriété NetStream.soundTransform pour exposer davantage de contrôles audio.
VideoPlayer
  source : String
[lecture-seule] Chaîne indiquant l'URL du fichier FLV à diffuser en continu et de quelle façon.
VideoPlayer
 Inheritedstage : Stage
[lecture-seule] Scène de l’objet d’affichage.
DisplayObject
  state : String
[lecture-seule] Chaîne indiquant l'état du composant.
VideoPlayer
  stateResponsive : Boolean
[lecture-seule] Valeur booléenne définie sur true si l'état est réactif.
VideoPlayer
  totalTime : Number
[lecture-seule] Nombre représentant la durée de lecture totale de la vidéo en secondes.
VideoPlayer
 Inheritedtransform : Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage.
DisplayObject
  videoHeight : int
[lecture-seule] Largeur source du fichier FLV chargé.
VideoPlayer
  videoWidth : int
[lecture-seule] Largeur source du fichier FLV chargé.
VideoPlayer
  visible : Boolean
Valeur booléenne qui, si elle est définie sur true, rend l'occurrence de VideoPlayer visible.
VideoPlayer
  volume : Number
Nombre compris entre 0 et 1 indiquant le réglage de contrôle du volume.
VideoPlayer
  width : Number
[write-only] Nombre indiquant la largeur de l'occurrence de VideoPlayer sur la scène.
VideoPlayer
  x : Number
[write-only] Nombre indiquant la position horizontale du lecteur vidéo, en pixels.
VideoPlayer
  y : Number
[write-only] Nombre indiquant la position verticale du lecteur vidéo, en pixels.
VideoPlayer
Méthodes publiques
 MéthodeDéfini par
  
VideoPlayer(width:int = 320, height:int = 240)
Crée un objet VideoPlayer avec une largeur et une hauteur spécifiées.
VideoPlayer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
 Inherited
Spécifie un flux vidéo provenant d’une caméra à afficher dans le cadre de l'objet Video de l’application.
Video
 Inherited
Spécifie un flux vidéo à afficher dans le cadre de l'objet Video dans l’application.
Video
 Inherited
Efface l'image actuellement affichée dans l'objet Video.
Video
  
Impose la fermeture du flux vidéo et de la connexion à Flash Media Server.
VideoPlayer
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace.
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes.
DisplayObject
 Inherited
Convertit l'objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).
DisplayObject
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Evalue l’objet d’affichage pour savoir s'il recouvre ou recoupe l’objet d'affichage obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalue l’objet d’affichage pour savoir s'il recouvre ou recoupe le point spécifié par les paramètres x et y.
DisplayObject
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
  
load(url:String, totalTime:Number, isLive:Boolean = false):void
Similaire à la méthode play(), mais provoque le chargement du fichier FLV sans lecture.
VideoPlayer
 Inherited
Convertit l'objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).
DisplayObject
  
Appelé par INCManager lorsque la connexion est terminée ou a échoué après un appel à la méthode INCManager.connectToURL().
VideoPlayer
  
Appelé par INCManager lorsque la reconnexion est terminée ou a échoué après un appel à la méthode INCManager.reconnect().
VideoPlayer
  
Interrompt la lecture de la vidéo.
VideoPlayer
  
play(url:String = null, totalTime:Number, isLive:Boolean = false):void
Entraîne la lecture de la vidéo.
VideoPlayer
  
Lit le fichier FLV lorsqu'une quantité suffisante de ce dernier est téléchargée.
VideoPlayer
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
  
seek(time:Number):void
Recherche une heure donnée (en secondes) dans le fichier, avec une précision décimale allant jusqu'aux millisecondes.
VideoPlayer
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
  
setScale(scaleX:Number, scaleY:Number):void
Définit simultanément les propriétés scaleX et scaleY.
VideoPlayer
  
setSize(width:Number, height:Number):void
Définit simultanément les propriétés width et height.
VideoPlayer
  
Arrête la lecture de la vidéo.
VideoPlayer
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
Evénements
 Evénement Synthèse Défini par
 Inherited Distribué lorsque Flash Player a le focus du système d’exploitation et devient actif.EventDispatcher
 Inherited Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.DisplayObject
 Inherited Envoyé lorsqu'un objet d'affichage est ajouté dans la liste d'affichage de la scène, directement ou par l'intermédiaire d'une arborescence secondaire qui contient l'objet d'affichage.DisplayObject
   Distribué lorsque la tête de lecture est ramenée au début de la piste car la propriété autoRewind est définie sur True.VideoPlayer
   Distribué par l'occurrence de VideoPlayer à la fermeture de NetConnection, en faisant expirer le délai ou par un appel de la méthode close(), ou lorsque vous appelez les méthodes load() ou play() ou définissez la propriété source et provoquez la fermeture de la connexion RTMP.VideoPlayer
   Distribué à la fin de la lecture car le lecteur a atteint la fin du fichier FLV.VideoPlayer
   Distribué lorsqu'un point de repère est atteint.VideoPlayer
 Inherited Distribué lorsque Flash Player perd le focus du système d’exploitation et devient inactif.EventDispatcher
 Inherited Distribué lorsque la tête de lecture est placée sur une nouvelle image.DisplayObject
   Distribué lorsque le lecteur vidéo est redimensionné ou redisposé.VideoPlayer
   Distribué la première fois que les métadonnées du fichier FLV sont atteintes.VideoPlayer
   Distribué pendant la lecture du fichier FLV à la fréquence spécifiée par la propriété playheadUpdateInterval ou lorsque la procédure de retour en début de fichier commence.VideoPlayer
   Il indique la progression en nombre d'octets téléchargés.VideoPlayer
   Evénement distribué lorsque le fichier FLV est chargé et prêt à s'afficher.VideoPlayer
 Inherited Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage.DisplayObject
 Inherited Envoyé lorsqu'un objet d'affichage est sur le point d'être supprimé de la liste d'affichage de la scène, directement ou par l'intermédiaire de la suppression d'une arborescence secondaire qui contient l'objet d'affichage.DisplayObject
 Inherited Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et rendue.DisplayObject
   Distribué lorsque l'état de lecture est modifié.VideoPlayer
Constantes publiques
 ConstanteDéfini par
  SHORT_VERSION : String = "2.1"
[static] Déclare une variable indiquant le numéro de version court du composant.
VideoPlayer
  VERSION : String = "2.1.0.12"
[static] Déclare une variable indiquant le numéro de version long du composant.
VideoPlayer
Détails des propriétés
alignpropriété
align:String  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Indique comment la vidéo s'affiche par rapport aux propriétés registrationX, registrationY, registrationWidth et registrationHeight. La propriété align procède à cette mise en forme automatique lorsque la propriété scaleMode est définie sur VideoScaleMode.MAINTAIN_ASPECT_RATIO ou VideoScaleMode.NO_SCALE. La modification de cette propriété après le chargement d'un fichier FLV active immédiatement la mise en forme automatique. Les valeurs proviennent de la classe VideoAlign.

La valeur par défaut est VideoAlign.CENTER.


Implémentation
    public function get align():String
    public function set align(value:String):void

Voir aussi

autoRewindpropriété 
autoRewind:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Valeur booléenne qui, si elle est définie sur true, provoque le rembobinage du fichier FLV jusqu'à l'image 1 lorsque la lecture s'arrête, soit parce que le lecteur a atteint la fin du flux, soit parce que la méthode stop() a été appelée. Cette propriété n'a aucune signification pour les flux en direct.

La valeur par défaut est false.


Implémentation
    public function get autoRewind():Boolean
    public function set autoRewind(value:Boolean):void
bufferTimepropriété 
bufferTime:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre de secondes à mettre en mémoire tampon avant de commencer la lecture d'un flux vidéo. Pour la diffusion en continu des fichiers FLV sur RTMP, qui ne sont pas téléchargés et sont placés simplement en mémoire tampon, il peut être important d'augmenter la valeur par défaut qui est de 0,1. Pour les fichiers FLV téléchargés de façon progressive avec le protocole HTTP, l'augmentation de cette valeur aura peu d'effets, bien qu'elle puisse améliorer l'affichage d'une vidéo haute qualité sur un ordinateur plus ancien et plus lent.

Pour les vidéos préenregistrées (sans diffusion en direct), ne définissez pas la propriété bufferTime sur 0, appliquez la valeur par défaut de cette propriété ou augmentez-la.

Cette propriété n'indique pas la proportion du fichier FLV à télécharger avant de démarrer sa lecture.


Implémentation
    public function get bufferTime():Number
    public function set bufferTime(value:Number):void

Voir aussi

bytesLoadedpropriété 
bytesLoaded:uint  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre indiquant le degré de téléchargement en nombre d'octets pour un téléchargement HTTP. Renvoie la valeur 0 en cas d'absence de flux, lorsque le flux est de type FMS (Flash Media Server) ou si les informations ne sont pas encore disponibles. La valeur renvoyée est utile uniquement pour un téléchargement HTTP.


Implémentation
    public function get bytesLoaded():uint
bytesTotalpropriété 
bytesTotal:uint  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre total d'octets téléchargés pour un téléchargement HTTP. Renvoie la valeur -1 en cas d'absence de flux, lorsque le flux est de type FMS (Flash Media Server) ou si les informations ne sont pas encore disponibles. La valeur renvoyée est utile uniquement pour un téléchargement HTTP.


Implémentation
    public function get bytesTotal():uint
heightpropriété 
height:Number  [write-only]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre indiquant la hauteur de l'occurrence de VideoPlayer, en pixels.

Remarque : ne confondez pas cette propriété avec la propriété flash.media.Video.height qui est semblable à la propriété fl.video.VideoPlayer.videoHeight.


Implémentation
    public function set height(value:Number):void

Voir aussi

idleTimeoutpropriété 
idleTimeout:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Temps écoulé (en millisecondes) avant que Flash mette fin à une connexion inactive à un serveur vidéo (tel que Flash Media Server) en raison de l'interruption ou de l'arrêt de la lecture. Cette propriété n'a aucune incidence sur le téléchargement HTTP d'un fichier FLV.

Si cette propriété est définie lorsqu'un flux vidéo est déjà inactif, elle redémarre la période de délai d'attente avec la nouvelle valeur.


Implémentation
    public function get idleTimeout():Number
    public function set idleTimeout(value:Number):void
iNCManagerClasspropriété 
public static var iNCManagerClass:Object = fl.video.NCManager

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Pour que tous les objets VideoPlayer exploitent votre classe personnalisée en tant que mise en œuvre d'INCManager par défaut, définissez la propriété iNCManagerClass sur l'objet classe ou le nom de chaîne de votre classe personnalisée. La classe FLVPlayback inclut la définition de la classe personnalisée, contrairement au lecteur vidéo.

La valeur par défaut est "fl.video.NCManager" as a string.

isLivepropriété 
isLive:Boolean  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Valeur booléenne définie sur true si le flux vidéo est en direct. Cette propriété n'est efficace que si le flux provient d'un serveur vidéo, tel que Flash Media Server ou un autre service FVSS (Flash Video Streaming Service). La valeur de cette propriété est ignorée s'il s'agit d'un téléchargement HTTP.

Définit la propriété isLive sur false lors de l'envoi d'un flux vidéo pré-enregistré vers le lecteur vidéo et sur true lors de l'envoi de données en temps réel, telles qu'une diffusion en direct. Pour de meilleures performances, lorsque vous définissez la propriété isLive sur false, ne définissez pas la propriété bufferTime sur 0.


Implémentation
    public function get isLive():Boolean

Voir aussi

isRTMPpropriété 
isRTMP:Boolean  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Valeur booléenne définie sur true si le fichier FLV est en diffusion en flux continu à partir d'un serveur FMS via RTMP. Sa valeur est définie sur false pour toute autre source de fichier FLV.


Implémentation
    public function get isRTMP():Boolean

Voir aussi

metadatapropriété 
metadata:Object  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Objet représentant un paquet de métadonnées reçu par un appel à la méthode de rappel NetSteam.onMetaData(), le cas échéant. Prêt lorsque l'événement metadataReceived est distribué.

Si le fichier FLV est codé à l'aide de l'encodeur de Flash 8, la propriété metadata contient les informations présentées ci-dessous. Les fichiers FLV plus anciens contiennent uniquement les valeurs height, width et duration.

ParamètreDescription
canSeekToEndValeur booléenne qui est définie sur true si le fichier FLV est codé avec une image-clé sur la dernière image qui permet de rechercher jusqu'à la fin d'un clip téléchargé progressivement. Elle est définie sur false si le fichier FLV n'est pas codé avec une image-clé sur la dernière image.
cuePointsTableau d'objets (un par point de repère intégré dans le fichier FLV). Cette valeur n'est pas définie si le fichier FLV ne contient pas de points de repère. Chaque objet possède les propriétés ci-dessous.
  • type—Chaîne qui spécifie le type de point de repère : "navigation" ou "event".
  • name—Chaîne représentant le nom du point de repère.
  • time—Nombre correspondant à l'heure du point de repère (en secondes) avec une précision de trois décimales (millisecondes).
  • parameters—Objet facultatif possédant des paires nom/valeur désignées par l'utilisateur au moment de la création des points de repère.
audiocodecidNombre qui indique le codec audio (technique de codage/décodage) utilisé.
audiodelay Nombre représentant le temps 0 dans le fichier source à partir duquel le fichier FLV a été encodé.

Le contenu vidéo est légèrement retardé pour que l'audio puisse être synchronisé. Par exemple, si la valeur audiodelay est .038, la vidéo qui commençait à 0 dans le fichier source commence à .038 dans le fichier FLV.

Notez que les classes FLVPlayback et VideoPlayer corrigent ce décalage dans leurs paramètres de temps. Vous pouvez donc conserver les paramètres que vous utilisiez dans le fichier source.

audiodatarateNombre indiquant les kilo-octets par seconde de l'audio.
videocodecidNombre indiquant la version codec utilisée pour coder la vidéo.
framerateNombre indiquant la fréquence d'images du fichier FLV.
videodatarateNombre indiquant la vitesse de transmission vidéo du fichier FLV.
heightNombre indiquant la hauteur du fichier FLV.
widthNombre indiquant la largeur du fichier FLV.
durationNombre indiquant la durée du fichier FLV en secondes.


Implémentation
    public function get metadata():Object

Voir aussi

ncMgrpropriété 
ncMgr:INCManager  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Objet INCManager qui permet d'accéder à une occurrence de la classe implémentant INCManager, interface de la classe INCManager.

Vous pouvez utiliser cette propriété pour mettre en œuvre un objet INCManager personnalisé qui requiert une initialisation personnalisée.


Implémentation
    public function get ncMgr():INCManager

Voir aussi

netConnectionpropriété 
netConnection:NetConnection  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Permet d'accéder directement à l'instance de NetConnection créée par le lecteur vidéo.


Implémentation
    public function get netConnection():NetConnection
netStreampropriété 
netStream:NetStream  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Permet d'accéder directement à l'instance de NetStream créée par le lecteur vidéo.


Implémentation
    public function get netStream():NetStream
netStreamClientClasspropriété 
public static var netStreamClientClass:Object

Version du langage : ActionScript 3.0

Enregistre une classe personnalisée pour la propriété client de NetStream. Par défaut, fl.video.VideoPlayerClient est utilisée ; cette·classe gère les messages onMetaData() et onCuePoint(). Pour ajouter la gestion personnalisée des autres messages, tels que onImageData() et·onTextData(), vous pouvez créer votre propre classe et définir cette propriété sur cette·classe.

Le·constructeur de la classe doit accepter une occurrence de VideoPlayer comme seul paramètre et avoir une propriété ready booléenne. La valeur de cette propriété doit être false tant que le Client attend les messages de données qui doivent se trouver au début du fichier. Si le lecteur VideoPlayer effectue son rembobinage avant la réception de ces messages, ils risquent de n'être jamais reçus. Par défaut, fl.video.VideoPlayerClient renvoie true pour la propriété ready dès l'appel de onMetaData().

Vous pouvez définir la propriété sur l'objet de classe lui-même (comme dans l'exemple suivant) ou sur le nom de chaîne de la classe :

        import fl.video.
        VideoPlayer.netStreamClientClass = MyCustomClient;
        

La définition sur le nom de chaîne de la classe ne suffit pas pour imposer la compilation de la classe dans le fichier SWF. La valeur par défaut est l'objet de classe fl.video.VideoPlayerClient, pas le nom de chaîne.

Il est fortement conseillé que toute implémentation personnalisée soit une sous-classe de fl.video.VideoPlayer. Toute autre pratique risque de corrompre les métadonnées et la gestion des points de répère construite dans le lecteur VideoPlayer et le composant FLVPlayback.

Player Version : Flash Player 9 Mise à jour 3.

La valeur par défaut est fl.video.VideoPlayerClient.


Lance
VideoError — Si cette propriété est définie sur une valeur non valide, l'erreur VideoError.NETSTREAM_CLIENT_CLASS_UNSET sera émise.
playheadTimepropriété 
playheadTime:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

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. Lorsque vous définissez cette propriété, vous déclenchez une recherche et vous avez toutes les restrictions d'une recherche.

Lorsque la position de la tête de lecture change (une fois toutes les 0,25 secondes lors de la lecture du fichier FLV), le composant distribue l'événement playheadUpdate.

La propriété playheadTime peut ne pas avoir la valeur attendue immédiatement après l'appel aux méthodes de recherche ou la définition de la propriété playheadTime pour provoquer une recherche. Tout d'abord, s'il s'agit d'un téléchargement progressif, vous pouvez rechercher uniquement une image-clé. Ainsi une recherche vous amène à l'heure de la première image-clé après l'heure spécifiée. (En cas de diffusion à flux continu, une recherche vous conduit toujours à l'heure exacte spécifiée même si le fichier FLV source n'y possède pas d'image-clé.) En second lieu, une recherche est asynchrone. Ainsi si vous appelez une méthode de recherche ou définissez la propriété playheadTime, celle-ci n'est pas immédiatement mise à jour. Pour déterminer le temps écoulé à la fin de la recherche, écoutez l'événement seek, qui ne se déclenche pas tant que la propriété playheadTime n'a pas été mise à jour.


Implémentation
    public function get playheadTime():Number
    public function set playheadTime(value:Number):void

Voir aussi

playheadUpdateIntervalpropriété 
playheadUpdateInterval:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre représentant l'intervalle (en millisecondes) entre chaque événement playheadUpdate. Lorsque vous définissez cette propriété pendant la lecture du fichier FLV, l'horloge redémarre.

Etant donné que les points de repère ActionScript démarrent aux mises à jour de la tête de lecture, diminuer la valeur de la propriété playheadUpdateInterval peut améliorer la précision des points de repère ActionScript.

Comme l'intervalle des mises à jour de la tête de lecture est défini par un appel à la méthode globale setInterval(), la mise à jour ne peut pas être déclenchée plus fréquemment que la fréquence d'images du fichier FLV, comme pour tout intervalle défini de cette façon. Par exemple, pour la fréquence par défaut de 12 images par seconde, l'intervalle efficace le plus petit que vous pouvez créer est approximativement de 83 millisecondes ou d'une seconde (1 000 millisecondes) divisée par 12.

La valeur par défaut est 250.


Implémentation
    public function get playheadUpdateInterval():Number
    public function set playheadUpdateInterval(value:Number):void

Voir aussi

progressIntervalpropriété 
progressInterval:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre représentant l'intervalle (en millisecondes) entre chaque événement progress. Si vous définissez cette propriété pendant la lecture du flux vidéo, l'horloge redémarre.


Implémentation
    public function get progressInterval():Number
    public function set progressInterval(value:Number):void
registrationHeightpropriété 
registrationHeight:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Hauteur utilisée pour aligner le contenu vidéo lors d'un redimensionnement automatique. La propriété registrationHeight ne doit pas être confondue avec la propriété height. La propriété height reprend la largeur réelle du contenu vidéo.

Exemple 1, chargement d'un fichier FLV de 80x80 avec les paramètres suivants :

Ensuite, après le redimensionnement automatique, vous obtenez le résultat suivant :

Exemple 2, charge le même scénario que l'exemple 1, à l'exception des paramètres suivants :

Vous obtenez alors le résultat suivant :

Exemple 3, charge le même scénario que l'exemple 2, à l'exception des paramètres suivants :

Vous obtenez exactement les mêmes valeurs que les valeurs d'alignement :

La définition de la propriété registrationHeight est équivalente à la définition de la propriété height et inversement. La définition de toute autre propriété ou l'appel de toute méthode de modification de la hauteur, telle que scaleX, setSize et setScale. Assurez-vous également que height et registrationHeight restent synchronisés.


Implémentation
    public function get registrationHeight():Number
    public function set registrationHeight(value:Number):void

Voir aussi

registrationWidthpropriété 
registrationWidth:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Largeur utilisée pour aligner le contenu vidéo lors d'un redimensionnement automatique. La propriété registrationWidth ne doit pas être confondue avec la propriété width. La propriété width reprend la largeur réelle du contenu vidéo.

Exemple 1, chargement d'un fichier FLV de 80x80 avec les paramètres suivants :

Ensuite, après le redimensionnement automatique, vous obtenez le résultat suivant :

Exemple 2, charge le même scénario que l'exemple 1, à l'exception des paramètres suivants :

Vous obtenez alors le résultat suivant :

Exemple 3, charge le même scénario que l'exemple 2, à l'exception des paramètres suivants :

Vous obtenez exactement les mêmes valeurs que les valeurs d'alignement :

La définition de la propriété registrationWidth est équivalente à la définition de la propriété width et inversement. La définition de toute autre propriété ou l'appel de toute méthode de modification de la largeur, telle que scaleX, setSize et setScale. Assurez-vous également que width et registrationWidth restent synchronisés.


Implémentation
    public function get registrationWidth():Number
    public function set registrationWidth(value:Number):void

Voir aussi

registrationXpropriété 
registrationX:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Coordonnée x utilisée pour aligner le contenu vidéo lors d'un redimensionnement automatique. A ne pas confondre avec la propriété x, qui dépend de l'emplacement réel du contenu vidéo.

Exemple 1, chargement d'un fichier FLV de 80x80 avec les paramètres suivants :

Ensuite, après le redimensionnement automatique, vous obtenez le résultat suivant :

Exemple 2, charge le même scénario que l'exemple 1, à l'exception des paramètres suivants :

Vous obtenez alors le résultat suivant :

Exemple 3, charge le même scénario que l'exemple 2, à l'exception des paramètres suivants :

Vous obtenez exactement les mêmes valeurs que les valeurs d'alignement :

Lorsque la propriété x ou registrationX est définie, la deuxième propriété est modifiée pour préserver son décalage par rapport à la première. Par exemple, si x = 10 et registrationX = 20, la sélection de x = 110 définit également registrationX = 120.


Implémentation
    public function get registrationX():Number
    public function set registrationX(value:Number):void

Voir aussi

registrationYpropriété 
registrationY:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Coordonnée y utilisée pour aligner le contenu vidéo lors d'un redimensionnement automatique. A ne pas confondre avec la propriété y, qui dépend de l'emplacement réel du contenu vidéo.

Exemple 1, chargement d'un fichier FLV de 80x80 avec les paramètres suivants :

Ensuite, après le redimensionnement automatique, vous obtenez le résultat suivant :

Exemple 2, charge le même scénario que l'exemple 1, à l'exception des paramètres suivants :

Vous obtenez alors le résultat suivant :

Exemple 3, charge le même scénario que l'exemple 2, à l'exception des paramètres suivants :

Vous obtenez exactement les mêmes valeurs que les valeurs d'alignement :

Lorsque la propriété y ou registrationY est définie, la deuxième propriété est modifiée pour préserver son décalage par rapport à la première. Par exemple, si y = 10 et registrationy = 20, la sélection de y = 110 définit également registrationy = 120.


Implémentation
    public function get registrationY():Number
    public function set registrationY(value:Number):void

Voir aussi

scaleModepropriété 
scaleMode:String  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Spécifie le redimensionnement de la vidéo après le chargement. Si défini sur VideoScaleMode.MAINTAIN_ASPECT_RATIO, conserve les proportions de la vidéo dans le rectangle défini par registrationX, registrationY, registrationWidth et registrationHeight. Si défini sur VideoScaleMode.NO_SCALE, adapte automatiquement la taille de la vidéo au fichier FLV. Si défini sur VideoScaleMode.EXACT_FIT, ignore les dimensions du fichier FLV source et la vidéo est étirée pour s'adapter au rectangle défini par registrationX, registrationY, registrationWidth et registrationHeight. S défini après le chargement du fichier FLV, la mise en forme automatique commence immédiatement. Les valeurs proviennent de VideoScaleMode.

La valeur par défaut est VideoScaleMode.MAINTAIN_ASPECT_RATIO.


Implémentation
    public function get scaleMode():String
    public function set scaleMode(value:String):void

Voir aussi

scaleXpropriété 
scaleX:Number  [write-only]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre indiquant l'échelle horizontale.

La valeur par défaut est 1.


Implémentation
    public function set scaleX(value:Number):void

Voir aussi

scaleYpropriété 
scaleY:Number  [write-only]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre indiquant l'échelle verticale.

La valeur par défaut est 1.


Implémentation
    public function set scaleY(value:Number):void

Voir aussi

soundTransformpropriété 
soundTransform:SoundTransform  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Ménage un accès direct à la propriété NetStream.soundTransform pour exposer davantage de contrôles audio. Définissez la propriété pour modifier les paramètres ; utilisez la méthode de l'accesseur getter de la propriété pour récupérer les paramètres actuels.


Implémentation
    public function get soundTransform():SoundTransform
    public function set soundTransform(value:SoundTransform):void

Voir aussi

sourcepropriété 
source:String  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Chaîne indiquant l'URL du fichier FLV à diffuser en continu et de quelle façon. L'URL peut être l'URL HTTP d'un fichier FLV, l'URL RTMP d'un flux ou l'URL HTTP d'un fichier XML.

Si vous définissez cette propriété dans l'inspecteur de composants ou l'inspecteur des propriétés, le chargement et la lecture du fichier FLV débutent au prochain événement « enterFrame ». Ce délai donne du temps pour définir les propriétés isLive, autoPlay et cuePoints, entre autres, qui affectent le chargement. Il permet également à ActionScript placé sur la première image d'avoir une incidence sur le composant FLVPlayback avant le début de la lecture.

Si vous définissez cette propriété avec ActionScript, elle appelle immédiatement la méthode VideoPlayer.load() lorsque la propriété autoPlay est définie sur false. Ou, elle appelle la méthode VideoPlayer.play() lorsque la propriété autoPlay est définie sur true. Les propriétés autoPlay, totalTime et isLive affectent le mode de chargement du nouveau fichier FLV. Ainsi, si vous les définissez, vous devez le faire avant la propriété source.

Définissez la propriété autoPlay sur false pour empêcher la lecture automatique du nouveau fichier FLV.


Implémentation
    public function get source():String

Voir aussi

statepropriété 
state:String  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Chaîne indiquant l'état du composant. Cette propriété est définie par les méthodes load(), play(), stop(), pause() et seek().

Les valeurs possibles pour la propriété state sont : buffering, connectionError, disconnected, loading, paused, playing, rewinding, seeking et stopped. Vous pouvez utiliser les propriétés de la classe FLVPlayback pour tester ces états.


Implémentation
    public function get state():String

Voir aussi

stateResponsivepropriété 
stateResponsive:Boolean  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Valeur booléenne définie sur true si l'état est réactif. Si l'état n'est pas réactif, les appels aux méthodes play(), load(), stop(), pause() et seek() sont placés en file d'attente et exécutés ultérieurement, lorsque l'état change et devient réactif. Etant donné que ces appels sont mis en file d'attente pour être exécutés plus tard, il n'est habituellement pas nécessaire de suivre la valeur de la propriété stateResponsive. Les états réactifs sont : stopped, playing, paused et buffering.


Implémentation
    public function get stateResponsive():Boolean

Voir aussi

totalTimepropriété 
totalTime:Number  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre représentant la durée de lecture totale de la vidéo en secondes.

Lors de la diffusion en continu à partir d'un serveur FMS (Flash Media Server) et de l'utilisation de NCManager par défaut, cette valeur est déterminée automatiquement par des API côté serveur, et elle écrase celle définie au moyen de cette propriété ou obtenue à partir de métadonnées. La propriété est prête pour la lecture lorsque l'état stopped ou playing est atteint après la définition de la propriété source. Cette propriété n'a aucune signification pour les flux en direct à partir d'un serveur FMS.

Lors d'un téléchargement HTTP, cette valeur est déterminée de façon automatique si le fichier FLV comporte des métadonnées intégrées. Dans tous les autres cas, définissez-la de façon explicite, faute de quoi elle aura la valeur NaN. Lorsque vous la définissez de façon explicite, la valeur des métadonnées du flux sont ignorées.

Lorsque vous définissez cette propriété, la valeur est effective pour le prochain fichier FLV chargé en définissant source. Elle n'a aucun effet sur un fichier FLV déjà chargé. En outre, cette propriété ne renvoie pas la nouvelle valeur transmise tant qu'un fichier FLV n'a pas été chargé.

La lecture continue si cette propriété n'est jamais définie (de façon explicite ou automatique), mais elle risque de poser des problèmes avec les commandes de recherche.

Si cette valeur n'est pas définie de façon explicite, elle reste NaN jusqu'à ce que les métadonnées permettent de lui accorder une valeur valide.


Implémentation
    public function get totalTime():Number

Voir aussi

videoHeightpropriété 
videoHeight:int  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Largeur source du fichier FLV chargé. Cette propriété renvoie -1 si aucune information n'est disponible.


Implémentation
    public function get videoHeight():int

Voir aussi

videoWidthpropriété 
videoWidth:int  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Largeur source du fichier FLV chargé. Cette propriété renvoie -1 si aucune information n'est disponible.


Implémentation
    public function get videoWidth():int

Voir aussi

visiblepropriété 
visible:Boolean  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Valeur booléenne qui, si elle est définie sur true, rend l'occurrence de VideoPlayer visible. Si elle a la valeur false, l'occurrence est masquée.

La valeur par défaut est true.


Implémentation
    public function get visible():Boolean
    public function set visible(value:Boolean):void
volumepropriété 
volume:Number  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre compris entre 0 et 1 indiquant le réglage de contrôle du volume.

La valeur par défaut est 1.


Implémentation
    public function get volume():Number
    public function set volume(value:Number):void

Voir aussi

widthpropriété 
width:Number  [write-only]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre indiquant la largeur de l'occurrence de VideoPlayer sur la scène.

Remarque : la propriété flash.media.Video.width est similaire à la propriété fl.video.VideoPlayer.videoWidth.


Implémentation
    public function set width(value:Number):void

Voir aussi

xpropriété 
x:Number  [write-only]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre indiquant la position horizontale du lecteur vidéo, en pixels.

La définition de cette propriété x affecte également la propriété registrationX. Lorsque la propriété x ou registrationX est définie, la deuxième propriété est modifiée pour préserver son décalage par rapport à la première. Par exemple, si x = 10 et registrationX = 20, la sélection de x = 110 définit également registrationX = 120.


Implémentation
    public function set x(value:Number):void

Voir aussi

ypropriété 
y:Number  [write-only]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre indiquant la position verticale du lecteur vidéo, en pixels.

La définition de cette propriété y affecte également la propriété registrationY. Lorsque la propriété y ou registrationY est définie, la deuxième propriété est modifiée pour préserver son décalage par rapport à la première. Par exemple, si y = 10 et registrationy = 20, la sélection de y = 110 définit également registrationy = 120.


Implémentation
    public function set y(value:Number):void

Voir aussi

Détails du constructeur
VideoPlayer()Constructeur
public function VideoPlayer(width:int = 320, height:int = 240)

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Crée un objet VideoPlayer avec une largeur et une hauteur spécifiées.

Paramètres
width:int (default = 320) — Largeur du lecteur vidéo, en pixels.
 
height:int (default = 240) — Hauteur du lecteur vidéo, en pixels.

Voir aussi

Détails des méthodes
close()méthode
public function close():void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Impose la fermeture du flux vidéo et de la connexion à Flash Media Server. Cette méthode déclenche l'événement close. Il est généralement inutile d'appeler cette méthode de façon directe, car le flux est arrêté par la fonctionnalité de délai de temporisation.

Voir aussi

load()méthode 
public function load(url:String, totalTime:Number, isLive:Boolean = false):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Similaire à la méthode play(), mais provoque le chargement du fichier FLV sans lecture. Autoresizing se produit si nécessaire et si la première image du fichier FLV s'affiche. Une fois le chargement initial et la mise en forme automatique terminés, l'état devient VideoState.PAUSED.

Cette méthode accepte les mêmes paramètres que la méthode play(), mais vous ne pouvez pas appeler la méthode load() sans URL. Sinon, une erreur sera renvoyée. Si le lecteur vidéo est dans un état non réactif, la méthode load() place la requête dans une file d'attente.

Paramètres

url:String — Une chaîne d'URL pour le fichier FLV que vous devez charger. Si aucune valeur n'est transmise pour l'URL, une erreur est renvoyée avec le message null URL sent to VideoPlayer.load.
 
totalTime:Number — Longueur du fichier FLV. Transmet 0, null ou undefined pour détecter automatiquement la longueur à partir des métadonnées, du serveur ou du code XML.
 
isLive:Boolean (default = false) — Cette valeur est true si vous procédez à une diffusion en continu à partir d'un serveur FMS.

Voir aussi

ncConnected()méthode 
public function ncConnected():void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Appelé par INCManager lorsque la connexion est terminée ou a échoué après un appel à la méthode INCManager.connectToURL(). Si la connexion a échoué, définissez la propriété INCManager.netConnection sur null ou undefined avant de procéder à l'appel.

Voir aussi

ncReconnected()méthode 
public function ncReconnected():void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Appelé par INCManager lorsque la reconnexion est terminée ou a échoué après un appel à la méthode INCManager.reconnect(). Si la connexion échoue, définissez la propriété INCManager.netconnection sur null avant de l'appeler.

Voir aussi

pause()méthode 
public function pause():void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Interrompt la lecture de la vidéo. Si la vidéo est interrompue ou arrêtée, n'a aucun effet. Pour relancer la lecture, appelez play(). Ne prend aucun paramètre.

Lorsque l'état du lecteur n'est pas réactif, la méthode pause() place la requête en file d'attente.

Renvoie une exception si appelée alors qu'aucun flux n'est connecté. Utilisez l'événement stateChange et la propriété connected pour déterminer dans quelles situations l'appel de cette méthode est sûr.

Si le lecteur vidéo est en état arrêté, l'appel à la méthode pause() n'a aucun effet et le lecteur demeure dans cet état.

Voir aussi

play()méthode 
public function play(url:String = null, totalTime:Number, isLive:Boolean = false):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Entraîne la lecture de la vidéo. Peut être appelé lorsque la vidéo est interrompue ou arrêtée ou lorsque la vidéo est déjà en cours de lecture. Appelle cette méthode sans argument pour lire une vidéo déjà chargée ou transmet une URL pour charger un nouveau flux.

Lorsque l'état du lecteur n'est pas réactif, la requête est placée en file d'attente.

Renvoie une exception lorsque l'appel se fait sans argument lorsque aucun flux n'est connecté. Utilisez l'événement stateChange et la propriété connected pour déterminer dans quelles situations l'appel de cette méthode est sûr.

Paramètres

url:String (default = null) — Transmettez une chaîne d'URL si vous devez charger et lire un nouveau fichier FLV. Si vous avez déjà chargé un fichier FLV et souhaitez poursuivre sa lecture, transmettez null.
 
totalTime:Number — Transmet la longueur du fichier FLV. Transmet 0 ou NaN pour détecter automatiquement la longueur à partir des métadonnées, du serveur ou du code XML. Si la propriété INCManager.streamLength n'a pas la valeur 0 ou null ou undefined lorsque la propriété ncConnected est appelée, cette valeur s'impose dans tous les cas.
 
isLive:Boolean (default = false) — Transmet true en cas de diffusion d'une source vidéo en direct de FCS.

Voir aussi

playWhenEnoughDownloaded()méthode 
public function playWhenEnoughDownloaded():void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Lit le fichier FLV lorsqu'une quantité suffisante de ce dernier est téléchargée. Lorsque le fichier FLV est téléchargé ou si vous diffusez en continu à partir d'un serveur FMS, l'appel de la méthode playWhenEnoughDownloaded() est identique à celle de play(), sans paramètre. L'appel de cette méthode ne suspend pas la lecture. Par conséquent, il est recommandé d'appeler la méthode pause() au préalable.

seek()méthode 
public function seek(time:Number):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Recherche une heure donnée (en secondes) dans le fichier, avec une précision décimale allant jusqu'aux millisecondes. Lorsque la vidéo est en cours de lecture, la vidéo poursuit sa lecture à partir de ce point. Si la vidéo est interrompue, elle recherche ce point et reste interrompue. Si la vidéo est arrêtée, elle recherche ce point et active l'état paused. Sans effet sur les flux vidéo en direct.

La propriété playheadTime peut ne pas avoir la valeur attendue immédiatement après l'appel aux méthodes de recherche ou la définition de la propriété playheadTime pour provoquer une recherche. S'il s'agit d'un téléchargement progressif, vous pouvez rechercher uniquement une image-clé. Ainsi une recherche vous amène à l'heure de la première image-clé après l'heure spécifiée.

Remarque : en cas de diffusion à flux continu, une recherche vous conduit toujours à l'heure exacte spécifiée même si le fichier FLV source n'y possède pas d'image-clé.

La recherche est asynchrone. Ainsi si vous appelez une méthode de recherche ou définissez la propriété playheadTime, celle-ci n'est pas immédiatement mise à jour. Pour obtenir l'heure à la fin de la recherche, écoutez l'événement seek, qui ne se déclenche pas tant que la propriété playheadTime n'a pas été mise à jour.

Renvoie une exception si appelée alors qu'aucun flux n'est connecté. Utilisez l'événement stateChange et la propriété connected pour déterminer dans quelles situations l'appel de cette méthode est sûr.

Paramètres

time:Number — Nombre qui indique l'heure, en secondes, à laquelle positionner la tête de lecture.


Lance
VideoError — Si temps est < 0 ou NaN.

Voir aussi

setScale()méthode 
public function setScale(scaleX:Number, scaleY:Number):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Définit simultanément les propriétés scaleX et scaleY. La définition de scaleX ou scaleY déclenche de façon distincte deux événements autolayout, tandis que l'appel de la méthode setScale() déclenche uniquement l'événement autolayout.

Lorsque la propriété scaleMode est définie sur VideoScaleMode.MAINTAIN_ASPECT_RATIO ou VideoScaleMode.NO_SCALE, l'appel de cette méthode déclenche immédiatement un événement autolayout.

Paramètres

scaleX:Number — Nombre représentant le redimensionnement horizontal.
 
scaleY:Number — Nombre représentant le redimensionnement vertical.

Voir aussi

setSize()méthode 
public function setSize(width:Number, height:Number):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Définit simultanément les propriétés width et height. La définition de width ou height déclenche de façon distincte deux événements autolayout, tandis que l'appel de la méthode setSize() déclenche uniquement l'événement autolayout.

Lorsque la propriété scaleMode est définie sur VideoScaleMode.MAINTAIN_ASPECT_RATIO ou VideoScaleMode.NO_SCALE, l'appel de cette méthode déclenche immédiatement un événement autolayout.

Paramètres

width:Number — La largeur du lecteur vidéo.
 
height:Number — La hauteur du lecteur vidéo.

Voir aussi

stop()méthode 
public function stop():void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Arrête la lecture de la vidéo. Si autoRewind est défini sur true, revient à la première image. Si la vidéo est déjà arrêtée, n'a aucun effet. Pour relancer la lecture, appelez play(). Ne prend aucun paramètre.

Lorsque l'état du lecteur n'est pas réactif, la requête est placée en file d'attente.

Renvoie une exception si appelée alors qu'aucun flux n'est connecté. Utilisez l'événement stateChange et la propriété connected pour déterminer dans quelles situations l'appel de cette méthode est sûr.

Voir aussi

Détails des événements
autoRewound Evénement
Type d'objet événement: fl.video.VideoEvent
VideoEvent.type property = fl.video.VideoEvent.AUTO_REWOUND

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué lorsque la tête de lecture est placée au début de la piste car la propriété autoRewind est définie sur true.

L'événement autoRewound est de type VideoEvent et dispose de la constante VideoEvent.AUTO_REWOUND.

Définit la valeur de la propriété type d'un objet événement autoRewound.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
stateChaîne identifiant la constante provenant de la classe VideoState et qui décrit l'état de lecture du composant.
playheadTimeNombre correspondant au temps de lecture ou à la position actuels de la tête de lecture.
vpIndex de l'objet VideoPlayer.

Voir aussi

close Evénement  
Type d'objet événement: fl.video.VideoEvent
VideoEvent.type property = fl.video.VideoEvent.CLOSE

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué par l'occurrence VideoPlayer à la fermeture de NetConnection, en faisant expirer le délai ou via un appel à la méthode closeVideoPlayer(), ou lorsque vous appelez les méthodes load() ou play() ou définissez la propriété source, ce qui entraîne la fermeture de la connexion RTMP. L'occurrence de FLVPlayback ne distribue cet événement que lorsque le flux provient de Flash Media Server (FMS) ou d'un autre service FVSS (Flash Video Streaming Service).

L'événement close est de type VideoEvent et dispose de la constante VideoEvent.CLOSE.

Définit la valeur de la propriété type d'un objet événement close.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
stateChaîne identifiant la constante provenant de la classe VideoState et qui décrit l'état de lecture du composant.
playheadTimeNombre correspondant au temps de lecture ou à la position actuels de la tête de lecture.
vpIndex de l'objet VideoPlayer.

Voir aussi

complete Evénement  
Type d'objet événement: fl.video.VideoEvent
VideoEvent.type property = fl.video.VideoEvent.COMPLETE

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué à la fin de la lecture car le lecteur a atteint la fin du fichier FLV. Le composant ne distribue pas l'événement si vous appelez les méthodes stop() ou pause(), ou si vous cliquez sur les commandes correspondantes.

Lorsque l'application a recours au téléchargement progressif, elle ne définit pas la propriété totalTime de façon explicite, et elle télécharge un fichier FLV qui ne spécifie pas la durée dans les métadonnées. Le lecteur vidéo définit la propriété totalTime sur une valeur totale approximative avant de diffuser cet événement.

Le lecteur vidéo distribue également les événements stateChange et stopped.

L'événement complete est de type VideoEvent et dispose de la constante VideoEvent.COMPLETE.

Définit la valeur de la propriété type d'un objet événement complete.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
stateChaîne identifiant la constante provenant de la classe VideoState et qui décrit l'état de lecture du composant.
playheadTimeNombre correspondant au temps de lecture ou à la position actuels de la tête de lecture.
vpIndex de l'objet VideoPlayer.

Voir aussi

cuePoint Evénement  
Type d'objet événement: fl.video.MetadataEvent
MetadataEvent.type property = fl.video.MetadataEvent.CUE_POINT

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué lorsqu'un point de repère est atteint. L'objet événement possède une propriété info qui contient l'objet info reçu par le rappel de l'événement NetStream.onCuePoint pour les points de repère du fichier FLV. S'il s'agit de points de repère ActionScript, il contient l'objet transmis aux méthodes ou aux propriétés de points de repère ActionScript.

L'événement cuePoint est de type MetadataEvent et comporte la constante MetadataEvent.CUE_POINT.

Définit la valeur de la propriété type d'un objet de l'événement cuePoint.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
infoObjet disposant de propriétés qui décrivent le point de repère.
vpIndex de l'objet VideoPlayer.

Voir aussi

layout Evénement  
Type d'objet événement: fl.video.LayoutEvent
LayoutEvent.type property = fl.video.LayoutEvent.LAYOUT

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué lorsque le lecteur vidéo est redimensionné ou redisposé. Vous trouverez ci-dessous deux scénarios de disposition du lecteur :

L'événement layout est de type LayoutEvent et dispose de la constante LayoutEvent.LAYOUT.

Définit la valeur de la propriété type d'un objet de l'événement layout.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
oldBoundsLes valeurs des propriétés x, y, width et height de la cible avant que l'événement layout ne se produise.
oldRegistrationBoundsLes valeurs des propriétés registrationX, registrationY, registrationWidth et registrationHeight de la cible avant que l'événement layout ne se produise.

Voir aussi

metadataReceived Evénement  
Type d'objet événement: fl.video.MetadataEvent
MetadataEvent.type property = fl.video.MetadataEvent.METADATA_RECEIVED

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué la première fois que les métadonnées du fichier FLV sont atteintes. L'objet événement possède une propriété info qui contient l'objet info reçu par le rappel de l'événement NetStream.onMetaData.

L'événement metadataReceived est de type MetadataEvent et comporte la constante MetadataEvent.METADATA_RECEIVED.

Définit la valeur de la propriété type d'un objet de l'événement metadataReceived.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
infoObjet disposant de propriétés qui décrivent le fichier FLV.
vpIndex de l'objet VideoPlayer.

Voir aussi

playheadUpdate Evénement  
Type d'objet événement: fl.video.VideoEvent
VideoEvent.type property = fl.video.VideoEvent.PLAYHEAD_UPDATE

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué pendant la lecture du fichier FLV à la fréquence spécifiée par la propriété playheadUpdateInterval ou lorsque la procédure de retour en début de fichier commence. Le composant ne distribue pas cet événement lorsque le lecteur vidéo est en pause ou arrêté, à moins qu'une recherche n'ait lieu.

L'événement playheadUpdate est de type VideoEvent et dispose de la constante VideoEvent.PLAYHEAD_UPDATE.

Définit la valeur de la propriété type d'un objet événement playheadUpdate.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
stateChaîne identifiant la constante provenant de la classe VideoState et qui décrit l'état de lecture du composant.
playheadTimeNombre correspondant au temps de lecture ou à la position actuels de la tête de lecture.
vpIndex de l'objet VideoPlayer.

Voir aussi

progress Evénement  
Type d'objet événement: fl.video.VideoProgressEvent
VideoProgressEvent.type property = fl.video.VideoProgressEvent.PROGRESS

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Il indique la progression en nombre d'octets téléchargés. Evénement distribué à la fréquence spécifiée par la propriété progressInterval, il se déclenche au début du chargement et se termine lorsque tous les octets sont chargés ou en cas d'erreur réseau. La valeur par défaut est une exécution 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. Utilisez cet événement pour vérifier les octets chargés ou le nombre d'octets du tampon.

Il est distribué uniquement s'il s'agit d'un téléchargement HTTP progressif. Il indique la progression en nombre d'octets téléchargés. L'objet événement possède les propriétés bytesLoaded et bytesTotal, qui sont identiques aux propriétés FLVPlayback du même nom.

L'événement progress est de type VideoProgressEvent et dispose de la constante VideoProgressEvent.PROGRESS.

Définit la valeur de la propriété type d'un objet événement progress.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
bytesLoadedNombre d’éléments ou d’octets chargés lors du traitement de l’événement par l'écouteur.
bytesTotalNombre total d'éléments ou d'octets qui seront chargés si le processus de chargement aboutit.
vpIndex de l'objet VideoPlayer.

Voir aussi

ready Evénement  
Type d'objet événement: fl.video.VideoEvent
VideoEvent.type property = fl.video.VideoEvent.READY

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Evénement distribué lorsque le fichier FLV est chargé et prêt à s'afficher. Il est déclenché la première fois que vous entrez un état réactif après avoir chargé un nouveau fichier FLV avec la méthode play() ou load(). Il est déclenché une seule fois par fichier FLV chargé.

L'événement ready est de type VideoEvent et dispose de la constante VideoEvent.READY.

Définit la valeur de la propriété type d'un objet événement ready.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
stateChaîne identifiant la constante provenant de la classe VideoState et qui décrit l'état de lecture du composant.
playheadTimeNombre correspondant au temps de lecture ou à la position actuels de la tête de lecture.
vpIndex de l'objet VideoPlayer.

Voir aussi

stateChange Evénement  
Type d'objet événement: fl.video.VideoEvent
VideoEvent.type property = fl.video.VideoEvent.STATE_CHANGE

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué lorsque l'état de lecture est modifié. Lorsque l'appel autoRewind est terminé, l'événement stateChange est distribué avec l'état rewinding. L'événement stateChange ne se produit pas avant la fin du rembobinage.

Il permet de procéder au suivi lorsque la lecture passe à un état réactif ou non réactif, comme par exemple au cours d'une connexion, d'un redimensionnement ou d'un rembobinage. Les méthodes play(), pause(), stop() et seek() placent les requêtes à exécuter en file d'attente lorsque le lecteur active un état non réactif.

L'événement stateChange est de type VideoEvent et dispose de la constante VideoEvent.STATE_CHANGE.

Définit la valeur de la propriété type d'un objet événement stateChange.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
stateChaîne identifiant la constante provenant de la classe VideoState et qui décrit l'état de lecture du composant.
playheadTimeNombre correspondant au temps de lecture ou à la position actuels de la tête de lecture.
vpIndex de l'objet VideoPlayer.

Voir aussi

Détails de la constante
SHORT_VERSIONConstante
public static const SHORT_VERSION:String = "2.1"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Déclare une variable indiquant le numéro de version court du composant. Le numéro de version est utile lorsque vous disposez d'un fichier FLA et devez connaître la version du composant. Pour déterminer la version du composant, tapez le code de suivi ci-dessous dans le fichier FLA :

FLVPlayback.SHORT_VERSION

La variable SHORT_VERSION inclut uniquement la version majeure et secondaire, par exemple, 2.0. La variable VERSION inclut les numéros de version majeure et secondaire, ainsi que la révision et les numéros, par exemple, 2.0.0.11.

Voir aussi

VERSIONConstante 
public static const VERSION:String = "2.1.0.12"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Déclare une variable indiquant le numéro de version long du composant. Le numéro de version est utile lorsque vous disposez d'un fichier FLA et devez connaître la version du composant. Pour déterminer la version du composant, tapez le code de suivi ci-dessous dans le fichier FLA :

FLVPlayback.VERSION

La variable VERSION inclut les numéros de version majeure et secondaire, ainsi que la révision et les numéros, par exemple, 2.0.0.11. La variable SHORT_VERSION inclut uniquement la version majeure et secondaire, par exemple, 2.0.

Voir aussi

Exemples Utilisation des exemples
VideoPlayerExample.as

Cet exemple crée de façon dynamique deux occurrences de VideoPlayer et définit un filtre de flou pour l'une d'entre elles.

Pour exécuter l'exemple, procédez comme suit :

  1. Ajoutez le composant FLVPlayback dans votre bibliothèque.
  2. Remplacez testVideoPath par un chemin absolu ou relatif vers un fichier FLV.
  3. Enregistrez ce code sous le nom VideoPlayerExample.as, dans le même répertoire que votre fichier FLA.
  4. Définissez la classe Document dans le fichier FLA sur VideoPlayerExample.
package
{
    import fl.video.VideoPlayer;
    import flash.display.Sprite;
    import flash.filters.BlurFilter;

    public class VideoPlayerExample extends Sprite 
    {
        private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv"
        private var player:VideoPlayer;
        private var blurryPlayer:VideoPlayer;
        
        public function VideoPlayerExample() {
            player = new VideoPlayer();
            player.play(videoPath);
            player.setScale(0.75, 0.75);
            addChild(player);
            
            blurryPlayer = new VideoPlayer();
            blurryPlayer.play(videoPath);
            blurryPlayer.setScale(0.75,0.75);
            blurryPlayer.filters = [ new BlurFilter(8, 8, 1) ];
            blurryPlayer.x = 250;
            addChild(blurryPlayer);            
        }
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/fl/video/VideoPlayer.html