VideoPlayer  - AS3 Flash

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.

Eléments de l’API associés

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.

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.

Eléments de l’API associés

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.

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.

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.

Eléments de l’API associés

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.

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" en tant que chaîne.

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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

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

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.

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

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.

Eléments de l’API associés

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 cadence 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.

Eléments de l’API associés

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.

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 reflète la hauteur réelle du contenu vidéo.

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

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

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

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

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

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

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.

Eléments de l’API associés

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 :

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

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

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

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

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

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.

Eléments de l’API associés

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 :

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

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

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

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

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

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.

Eléments de l’API associés

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 :

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

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

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

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

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

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.

Eléments de l’API associés

Spécifie le redimensionnement de la vidéo après le chargement. Si défini sur VideoScaleMode.MAINTAIN_ASPECT_RATIO, conserve le format 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.

Eléments de l’API associés

Nombre indiquant l’échelle horizontale.

La valeur par défaut est 1.

Eléments de l’API associés

Nombre indiquant l’échelle verticale.

La valeur par défaut est 1.

Eléments de l’API associés

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 d’accesseur Get de la propriété pour récupérer les paramètres actuels.

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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

Eléments de l’API associés

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

Eléments de l’API associés

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.

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

La valeur par défaut est 1.

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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

Eléments de l’API associés

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.

Eléments de l’API associés

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

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

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

Eléments de l’API associés

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.

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 en 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

Eléments de l’API associés

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

Eléments de l’API associés

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

Eléments de l’API associés

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.

Eléments de l’API associés

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.

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

Eléments de l’API associés

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.

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

Eléments de l’API associés

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.

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

Eléments de l’API associés

Distribué lorsqu’un point de repère est atteint. L’objet d’é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.

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

Eléments de l’API associés

Evénement drmAuthenticate

Evénement drmError

Evénement drmError

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

• si le lecteur vidéo est disposé à l’aide de l’événement autoLayout ou en appelant les méthodes setScale() ou setSize(), ou en modifiant les propriétés width, height, scaleX et scaleY.
• s’il existe deux lecteurs vidéo de taille différente et si la propriété visibleVideoPlayerIndex passe de l’un à l’autre.

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

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

Eléments de l’API associés

Distribué la première fois que les métadonnées du fichier FLV sont atteintes. L’objet d’é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.

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

Eléments de l’API associés

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.

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

Eléments de l’API associés

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. Indique la progression, en nombre d’octets téléchargés. L’objet d’événement dispose de 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.

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

Eléments de l’API associés

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.

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

Eléments de l’API associés

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.

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

Eléments de l’API associés

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.

Eléments de l’API associés

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.

Eléments de l’API associés

Pour exécuter l’exemple, suivez ces étapes :

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);            
        }
    }
}