Packageflash.media
Classepublic class Video
HéritageVideo Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Sous-classes VideoPlayer

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

La classe Video affiche une vidéo en direct ou enregistrée dans une application sans l'intégrer dans votre fichier SWF. Cette classe crée un objet Video dans une interface Adobe Flash ou Adobe Flex qui diffuse l'un des types de vidéo suivants : fichiers Flash Video (FLV) enregistrés sur un serveur ou localement ou vidéo en direct capturée sur l'ordinateur de l'utilisateur. Un objet Video est un objet d'affichage de la liste d'affichage de l'application et représente l'espace visuel au sein duquel la vidéo s'exécute dans une interface utilisateur.

Utilisé avec Flash Media Server, l'objet Video vous permet d'envoyer une vidéo en direct depuis l'ordinateur de l'utilisateur vers le serveur, puis de la diffuser du serveur vers d'autres utilisateurs. Grâce à ses fonctionnalités, vous pouvez développer des applications multimédia telles qu'un simple lecteur vidéo, un lecteur vidéo avec publication multipoint d'un serveur à un autre ou une application de partage vidéo pour une communauté d'utilisateurs.

Flash Player 9 gère la publication et la lecture des fichiers FLV codés avec le codec Sorenson ou On2 VP6, et prend également en charge un canal alpha. Le codec vidéo On2 VP6 utilise moins de largeur de bande que les technologies plus anciennes et offre des filtres supplémentaires de dégroupage et de deringing.

Flash Player Mise à jour 3 et versions ultérieures supportent le mip-mapping pour optimiser la qualité du rendu à l'exécution et les performances. Pour la lecture vidéo, Flash Player utilise l'optimisation mip-mapping si vous définissez la propriété smoothing de l'objet Video sur true.

Comme pour les autres objets d’affichage de la liste d’affichage, vous pouvez contrôler différentes propriétés des objets Video. Par exemple, vous pouvez déplacer l'objet Video sur la scène à l'aide de ses propriétés x et y, modifier sa taille à l'aide de ses propriétés height et width, etc.

Pour lire un flux vidéo, utilisez attachCamera() ou attachNetStream() pour associer la vidéo à l'objet Video. Ajoutez ensuite l'objet Video à la liste d'affichage à l'aide de addChild().

Si vous utilisez l'outil de programmation de Flash, vous pouvez également placer l'objet Video sur la scène au lieu de l'ajouter avec addChild(), comme suit :

  1. Si le panneau Bibliothèque n'est pas visible, sélectionnez Fenêtre > Bibliothèque pour l'afficher.
  2. Ajoutez un objet Video imbriqué à la bibliothèque en cliquant sur le menu Options à droite de la barre de titre du panneau bibliothèque et en sélectionnant Nouvelle Vidéo.
  3. Dans la boîte de dialogue des propriétés de la vidéo, nommez l'objet Video intégré à utiliser dans la bibliothèque et cliquez sur OK.
  4. Faites glisser l'objet Video sur la scène et utilisez l'inspecteur des propriétés pour lui donner un nom d'occurrence unique, par ex. ma_video. (Ne l'appelez pas Video.)

Remarque : la classe Video n’étant pas une sous-classe de la classe InteractiveObject, elle ne peut pas distribuer d’événements de souris. Vous pouvez cependant appeler la méthode addEventListener() sur le conteneur d’objet d'affichage qui contient l’objet Video.

Consulter les exemples

Voir aussi

attachCamera()
attachNetStream()
flash.media.Camera.getCamera()
flash.net.NetConnection
flash.net.NetStream
flash.display.DisplayObjectContainer.addChild()
flash.display.Stage.addChild()
Classes d'affichage de base
Principes de base de la vidéo


Propriétés publiques
 PropriétéDéfini par
 InheritedaccessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage.
DisplayObject
 Inheritedalpha : Number
Indique la valeur de transparence alpha de l'objet spécifié.
DisplayObject
 InheritedblendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser.
DisplayObject
 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
  deblocking : 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
 Inheritedheight : Number
Indique la hauteur de l'objet d’affichage, en pixels.
DisplayObject
 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
 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
 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
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
 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
 InheritedscaleX : Number
Indique le redimensionnement horizontal (percentage) de l'objet tel qu'il est appliqué à partir du point d'alignement.
DisplayObject
 InheritedscaleY : Number
Indique le redimensionnement vertical (pourcentage) de l’objet tel qu’il est appliqué à partir du point d’alignement.
DisplayObject
 InheritedscrollRect : Rectangle
Cadre de délimitation du défilement de l’objet d’affichage.
DisplayObject
  smoothing : Boolean
Indique si la vidéo doit être lissée (interpolée) lors de son redimensionnement.
Video
 Inheritedstage : Stage
[lecture-seule] Scène de l’objet d’affichage.
DisplayObject
 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] Nombre entier spécifiant la hauteur en pixels du flux vidéo.
Video
  videoWidth : int
[lecture-seule] Nombre entier spécifiant la largeur en pixels du flux vidéo.
Video
 Inheritedvisible : Boolean
Indique si l’objet d’affichage est visible ou non.
DisplayObject
 Inheritedwidth : Number
Indique la largeur de l'objet d’affichage, en pixels.
DisplayObject
 Inheritedx : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.
DisplayObject
 Inheritedy : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.
DisplayObject
Méthodes publiques
 MéthodeDéfini par
  
Video(width:int = 320, height:int = 240)
Crée une occurrence de Video.
Video
 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
  
Spécifie un flux vidéo provenant d’une caméra à afficher dans le cadre de l'objet Video de l’application.
Video
  
Spécifie un flux vidéo à afficher dans le cadre de l'objet Video dans l’application.
Video
  
Efface l'image actuellement affichée dans l'objet Video.
Video
 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
 Inherited
Convertit l'objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).
DisplayObject
 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
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 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
 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
 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
Détails des propriétés
deblockingpropriété
deblocking:int  [lecture-écriture]

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

Indique le type de filtre appliqué aux vidéos décodées dans le cadre du post-traitement. La valeur par défaut, 0, autorise le compresseur vidéo à appliquer le filtre de dégroupage si nécessaire.

La compression de la vidéo peut engendrer des artefacts indésirables. Vous pouvez utiliser la propriété deblocking pour définir des filtres de dégroupage et, pour la vidéo compressée utilisant le codex On2, ringing.

Le groupage désigne les défauts visibles entre les limites des blocs qui composent chaque image vidéo. Le ringing fait référence aux déformations observées au niveau des bords des éléments dans une image vidéo.

Deux filtres de dégroupage sont disponibles : l'un dans le codec Sorenson, l'autre dans le codec On2 VP6. Un filtre de deringing est également disponible lorsque vous utilisez le codec On2 VP6. Pour définir un filtre, utilisez une des valeurs suivantes :

Si une valeur supérieure à 2 est sélectionnée pour la vidéo alors que vous utilisez le codec Sorenson, le décodeur Sorenson applique par défaut la valeur 2.

Le filtre de dégroupage a un effet sur les performances globales de lecture et il n'est généralement pas nécessaire pour la vidéo à large bande passante. Si le système d’un utilisateur n'est pas assez puissant, il lui sera peut-être difficile de lire la vidéo avec un tel filtre activé.


Implémentation
    public function get deblocking():int
    public function set deblocking(value:int):void
smoothingpropriété 
smoothing:Boolean  [lecture-écriture]

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

Indique si la vidéo doit être lissée (interpolée) lors de son redimensionnement. Pour faciliter le lissage, le lecteur doit être en mode haute qualité. La valeur par défaut est false (pas de lissage).

Pour une lecture vidéo avec Flash Player Mise à jour 3 et les versions ultérieures, définissez cette propriété sur true pour exploiter les avantages de l'optimisation d'image mip-mapping.


Implémentation
    public function get smoothing():Boolean
    public function set smoothing(value:Boolean):void
videoHeightpropriété 
videoHeight:int  [lecture-seule]

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

Nombre entier spécifiant la hauteur en pixels du flux vidéo. Pour les flux vidéo en direct, cette valeur est identique à la propriété Camera.height de l'objet Camera qui capture le flux vidéo. Pour les fichiers FLV, elle correspond à la hauteur du fichier exporté au format FLV.

Vous pouvez utiliser cette propriété, par exemple, pour garantir que l'utilisateur regarde la vidéo au même format que celui auquel elle a été capturée, quel que soit le format réel de l'objet Video sur la scène.


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

Nombre entier spécifiant la largeur en pixels du flux vidéo. Pour les flux vidéo en direct, cette valeur est identique à la propriété Camera.width de l'objet Camera qui capture le flux vidéo. Pour les fichiers FLV, elle correspond à la largeur du fichier exporté au format FLV.

Vous pouvez utiliser cette propriété, par exemple, pour garantir que l'utilisateur regarde la vidéo au même format que celui auquel elle a été capturée, quel que soit le format réel de l'objet Video sur la scène.


Implémentation
    public function get videoWidth():int

Voir aussi

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

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

Crée une occurrence de Video. Si la valeur des paramètres width et height n’est pas définie, les valeurs par défaut sont utilisées. Vous pouvez aussi définir les propriétés de largeur et de hauteur de l’objet Video après sa construction initiale à l’aide des propriétés Video.width et Video.height. Lors de la création d'un objet Video, il est interdit de définir une largeur et une hauteur nulles. Si vous transmettez la valeur zéro, les valeurs par défaut sont appliquées.

Une fois l’objet Video créé, appelez la méthode DisplayObjectContainer.addChild() ou DisplayObjectContainer.addChildAt() pour l’ajouter à un objet DisplayObjectContainer parent.

Paramètres
width:int (default = 320) — Largeur de la vidéo, en pixels.
 
height:int (default = 240) — Hauteur de la vidéo, en pixels.
Détails des méthodes
attachCamera()méthode
public function attachCamera(camera:Camera):void

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

Spécifie un flux vidéo provenant d’une caméra à afficher dans le cadre de l'objet Video de l’application.

Utilisez cette méthode pour associer à l'objet Video une vidéo en direct provenant de l'ordinateur d'un utilisateur. Vous pouvez diffuser la vidéo en direct localement sur l'ordinateur sur lequel elle a été capturée ou l'envoyer au Flash Media Server et utiliser le serveur pour envoyer le flux aux autres utilisateurs.

Paramètres

camera:Camera — Objet Camera qui capture des données vidéo. Pour annuler la connexion à l'objet Video, transmettez null.

Voir aussi


Exemple
Utilisation des exemples
Pour une illustration de l'utilisation de cette méthode, consultez l'exemple de la méthode Camera.getCamera().
attachNetStream()méthode 
public function attachNetStream(netStream:NetStream):void

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

Spécifie un flux vidéo à afficher dans le cadre de l'objet Video dans l’application. Le flux vidéo est soit un fichier FLV lu avec NetStream.play(), soit un objet Camera, soit null. Si vous utilisez un fichier FLV, il peut être stocké dans le système de fichiers local ou sur le serveur Flash Media Server. Si la valeur de l'argument netStream correspond à null, la vidéo n'est plus lue dans l'objet Video.

Vous n'êtes pas obligé(e) d'utiliser cette méthode si le fichier FLV contient uniquement des données audio ; la partie audio des fichiers FLV est automatiquement lue lors de l’appel de la méthode NetStream.play(). Pour contrôler les données audio associées à un fichier FLV, utilisez la propriété soundTransform de l’objet NetStream qui lit le fichier FLV.

Paramètres

netStream:NetStream — Objet NetStream. Pour annuler la connexion à l'objet Video, transmettez null.

Voir aussi


Exemple
Utilisation des exemples
Pour une illustration de l'utilisation de cette méthode, consultez l'exemple présenté à la fin de ce cours.
clear()méthode 
public function clear():void

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

Efface l'image actuellement affichée dans l'objet Video. Cette fonction est utile lorsque vous souhaitez afficher des informations en attente sans devoir masquer l'objet Video.

Voir aussi

Exemples Utilisation des exemples
VideoExample.as

L'exemple suivant utilise un objet Video avec les classes NetConnection et NetStream pour charger et lire un fichier FLV. Pour exécuter cet exemple, vous avez besoin d'un fichier FLV dont le nom et l'emplacement correspondent à la variable transmise à videoURL, en l'occurrence un fichier FLV appelé Video.flv qui se trouve dans le même répertoire que le fichier SWF.

Dans cet exemple, le code qui crée les objets Video et NetStream, et appelle Video.attachNetStream() et NetStream.play(), est placé dans une fonction de gestionnaire. Le gestionnaire est appelé uniquement si la tentative de connexion à l'objet NetConnection a réussi, ce qui est le cas lorsque l'événement netStatus renvoie un objet info doté d'une propriété code signalant la réussite de l'opération. Il est recommandé d’attendre l’établissement d’une connexion avant d'appeler NetStream.play().


 package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;

    public class VideoExample extends Sprite {
        private var videoURL:String = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        public function VideoExample() {
            connection = new NetConnection();
            connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Unable to locate video: " + videoURL);
                    break;
            }
        }

        private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
        
        private function asyncErrorHandler(event:AsyncErrorEvent):void {
            // ignore AsyncErrorEvent events.
        }
    }
 }




 

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/flash/media/Video.html