| Package | flash.media |
| Classe | public class Video |
| Héritage | Video DisplayObject EventDispatcher Object |
| Sous-classes | VideoPlayer |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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. Reportez-vous à la classe flash.net.NetStream pour de plus amples informations sur la lecture vidéo.
Flash Player 9.0.115.0 et les versions ultérieures prennent en charge le mip-mapping pour optimiser les performances et la qualité du rendu au moment de l'exécution. 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 :
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.
Voir aussi
| Propriété | Défini par | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties Options d'accessibilité actuelles de l'objet d'affichage. | DisplayObject | |
![]() | alpha : Number Indique la valeur de transparence alpha de l'objet spécifié. | DisplayObject | |
![]() | blendMode : String Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser. | DisplayObject | |
![]() | blendShader : Shader [lecture seule] Définit un shader utilisé pour le fondu de l'arrière-plan et du premier plan. | DisplayObject | |
![]() | cacheAsBitmap : Boolean Si true est défini, Flash Player ou Adobe AIR place en mémoire cache une version bitmap interne de l’objet d'affichage. | DisplayObject | |
![]() | constructor : 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 | ||
![]() | filters : Array Tableau indexé contenant tous les objets filtre actuellement associés à l'objet d'affichage. | DisplayObject | |
![]() | height : Number Indique la hauteur de l'objet d'affichage, en pixels. | DisplayObject | |
![]() | loaderInfo : LoaderInfo [lecture seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d'affichage. | DisplayObject | |
![]() | mask : DisplayObject L'objet d'affichage appelant est masqué par l'objet mask spécifié. | DisplayObject | |
![]() | mouseX : Number [lecture seule] Indique la coordonnée x de la position de la souris, en pixels. | DisplayObject | |
![]() | mouseY : Number [lecture seule] Indique la coordonnée y de la position de la souris, en pixels. | DisplayObject | |
![]() | name : String Indique le nom d'occurrence de DisplayObject. | DisplayObject | |
![]() | opaqueBackground : Object Indique si l'objet d'affichage est opaque avec une couleur d'arrière-plan spécifique. | DisplayObject | |
![]() | parent : DisplayObjectContainer [lecture seule] Indique l'objet DisplayObjectContainer qui contient l'objet d'affichage. | DisplayObject | |
![]() | prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction. | Object | |
![]() | root : 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 | |
![]() | rotation : Number Indique la rotation de l'occurrence de DisplayObject, en degrés, à partir de son orientation d'origine. | DisplayObject | |
![]() | rotationX : Number Indique la rotation de l'axe des x de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent. | DisplayObject | |
![]() | rotationY : Number Indique la rotation de l'axe des y de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent. | DisplayObject | |
![]() | rotationZ : Number Indique la rotation de l'axe des z de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent. | DisplayObject | |
![]() | scale9Grid : Rectangle Grille de mise à l'échelle en vigueur. | DisplayObject | |
![]() | scaleX : Number Indique l'échelle horizontale (pourcentage) de l'objet telle qu'elle est appliquée à partir du point d'alignement. | DisplayObject | |
![]() | scaleY : Number Indique le redimensionnement vertical (pourcentage) de l'objet tel qu'il est appliqué à partir du point d'alignement. | DisplayObject | |
![]() | scaleZ : Number Indique l'échelle de profondeur (pourcentage) de l'objet tel qu'elle est appliquée à partir du point d'alignement. | DisplayObject | |
![]() | scrollRect : 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 | ||
![]() | stage : Stage [lecture seule] Scène de l'objet d'affichage. | DisplayObject | |
![]() | transform : 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 | ||
![]() | visible : Boolean Indique si l'objet d'affichage est visible ou non. | DisplayObject | |
![]() | width : Number Indique la largeur de l'objet d'affichage, en pixels. | DisplayObject | |
![]() | x : Number Indique la coordonnée x de l'occurrence de DisplayObject par rapport aux coordonnées locales de l'objet DisplayObjectContainer parent. | DisplayObject | |
![]() | y : Number Indique la coordonnée y de l'occurrence de DisplayObject par rapport aux coordonnées locales de l'objet DisplayObjectContainer parent. | DisplayObject | |
![]() | z : Number Indique la position de coordonnée z le long de l'axe des z de l'occurrence DisplayObject par rapport au conteneur 3D parent. | DisplayObject | |
| Méthode | Défini par | ||
|---|---|---|---|
Crée une occurrence de Video. | Video | ||
![]() | 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 (pas le flux vidéo). | Video | ||
![]() | Distribue un événement dans le flux d'événements. | EventDispatcher | |
![]() | 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 | |
![]() | 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 | |
![]() | Convertit l'objet point des coordonnées de scène (globales) vers les coordonnées de l'objet d'affichage (locales). | DisplayObject | |
![]() | Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d'un objet d'affichage tridimensionnel (locales). | DisplayObject | |
![]() | Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d'événement. | EventDispatcher | |
![]() | Indique si la propriété spécifiée d'un objet est définie. | Object | |
![]() | Evalue le cadre de délimitation de l'objet d'affichage pour savoir s'il recouvre ou recoupe le cadre de délimitation de l'objet d'affichage obj. | DisplayObject | |
![]() | Evalue l'objet d'affichage pour savoir s'il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | |
![]() | 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 | |
![]() | Convertit un point tridimensionnel des coordonnées de l'objet d'affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | |
![]() | Convertit l'objet point des coordonnées de l'objet d'affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | |
![]() | Indique si la propriété spécifiée existe et est énumérable. | Object | |
![]() | Supprime un écouteur de l'objet EventDispatcher. | EventDispatcher | |
![]() | Définit la disponibilité d'une propriété dynamique pour les opérations en boucle. | Object | |
![]() | Renvoie la représentation sous forme de chaîne de l'objet spécifié. | Object | |
![]() | Renvoie la valeur primitive de l'objet spécifié. | Object | |
![]() | 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 | |
| deblocking | propriété |
deblocking:int [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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é.
public function get deblocking():int public function set deblocking(value:int):void| smoothing | propriété |
smoothing:Boolean [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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 9.0.115.0 et versions ultérieures, définissez cette propriété sur true pour tirer parti de l'optimisation d'image mip-mapping.
public function get smoothing():Boolean public function set smoothing(value:Boolean):voidVoir aussi
| videoHeight | propriété |
videoHeight:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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.
public function get videoHeight():intVoir aussi
| videoWidth | propriété |
videoWidth:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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.
public function get videoWidth():intVoir aussi
| Video | () | Constructeur |
public function Video(width:int = 320, height:int = 240)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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.
width:int (default = 320) — Largeur de la vidéo, en pixels. | |
height:int (default = 240) — Hauteur de la vidéo, en pixels. |
| attachCamera | () | méthode |
public function attachCamera(camera:Camera):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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
| attachNetStream | () | méthode |
public function attachNetStream(netStream:NetStream):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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
| clear | () | méthode |
public function clear():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Efface l'image actuellement affichée dans l'objet Video (pas le flux vidéo). Cette méthode est très utile pour gérer l'image en cours. Par exemple, vous pouvez effacer la dernière image ou afficher des informations en attente sans masquer l'objet Video.
Voir aussi
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 {
stream = 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.
}
}
}