VideoDisplay  - AS3 Flex

Indique si le contrôle VideoDisplay doit utiliser la fonctionnalité de détection de bande passante automatique intégrée. Lorsque la valeur est false, vous n’avez pas besoin d’un fichier main.asc sur Flash Media Server (FMS) 2 pour vous connecter à FMS. Si la valeur est true, vous devez implémenter un fichier main.asc et le stocker dans une structure de répertoires de FMS. Le fichier main.asc doit définir les fonctions suivantes :

•       application.onConnect = function(p_client, p_autoSenseBW)
        {
          //Add security code here.     
          this.acceptConnection(p_client);      
          if (p_autoSenseBW)
            this.calculateClientBw(p_client);
          else
            p_client.call("onBWDone");
        }

•       application.calculateClientBw = function(p_client)
        {
          // Add code to set the clients BandWidth.
          // Use p_client.getStats() which returns bytes_in 
          // and bytes_Out and check your bandWidth using 
          // p_client.call("onBWCheck", result, p_client.payload).
          p_client.call("onBWDone");
        }
        

•       Client.prototype.getStreamLength = function(p_streamName)
        {
          return Stream.length(p_streamName);
        }

La valeur par défaut est false.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement autoBandWidthDetection .

Indique si la vidéo doit se mettre en lecture immédiatement après la définition de la propriété source. Si la valeur est true, le fichier vidéo est immédiatement placé en mémoire tampon et est lu.

Même si la propriété autoPlay est définie sur false, Flex commence à charger la vidéo après l’appel de la méthode initialize(). Pour Flash Media Server, cela signifie la création du flux et le chargement de la première image à afficher (et en charge plus si la propriété autoSize ou aspectRatio est définie sur true). Dans le cas d’un téléchargement avec le protocole HTTP, Flex commence à télécharger le flux et affiche la première image.

La valeur par défaut est true.

Indique si le fichier FLV doit être rembobiné jusqu’à la première image lorsque la lecture s’arrête, soit en appelant la méthode stop(), soit en atteignant la fin du flux. Cette propriété n’a aucun effet pour la diffusion en continu live des vidéos.

La valeur par défaut est true.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement autoRewindChanged .

L’objet de bordure du contrôle.

Renvoie un objet EdgeMetrics qui comporte quatre propriétés : left, top, right et bottom. La valeur de chaque propriété est égale à l’épaisseur du côté de la bordure qui entoure le contrôle, en pixels.

Nombre de secondes de la vidéo à placer en mémoire tampon avant de commencer la lecture du fichier vidéo. Pour les connexions lentes dont la diffusion en continu passe par RTMP, il est important d’augmenter cette propriété par rapport à la valeur par défaut.

La valeur par défaut est 0.1.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement bufferTimeChanged .

Nombre d’octets déjà chargés qui sont disponibles pour la lecture. La valeur est utile uniquement pour les fichiers multimédias chargés avec le protocole HTTP.

Contient la valeur -1 s’il n’existe aucun flux d’entrée, lorsque le flux provient de Flash Media Server ou si l’information n’est pas encore disponible.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement progress .

Nombre total d’octets à charger. La valeur est utile uniquement pour les fichiers multimédias chargés avec le protocole HTTP.

Contient la valeur -1 s’il n’existe aucun flux d’entrée, lorsque le flux provient de Flash Media Server ou si l’information n’est pas encore disponible.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement progress .

Instance de la classe CuePointManager associée au contrôle VideoPlayer. Vous pouvez utiliser cet objet pour contrôler les points de repère ou utiliser la propriété cuePoints.

Vous pouvez utiliser les points de repère pour déclencher les événements cuePoint lorsque la lecture de votre vidéo atteint un emplacement donné. Pour définir des points de repère, utilisez les méthodes de la classe CuePointManager.

Les points de repère imbriqués dans le fichier FLV ne sont pas disponibles via cuePoints ou cuePointManager. Pour les récupérer, vous pouvez accéder à la propriété metadata ou à l’événement metadataReceived.

Eléments de l’API associés

Gestionnaire des points de repère à utiliser. Définissez-le sur mx.controls.videoClasses.CuePointManager pour activer la gestion des points de repère.

Eléments de l’API associés

Tableau de points de repère associés au contrôle. Vous pouvez utiliser cette propriété pour contrôler les points de repère ou utiliser la propriété cuePointManager.

Vous pouvez utiliser les points de repère pour déclencher les événements cuePoint lorsque la lecture de votre vidéo atteint un emplacement donné. Pour définir les points de repère, vous transmettez un tableau à la propriété cuePoints.

Les points de repère imbriqués dans le fichier FLV ne sont pas disponibles via cuePoints ou cuePointManager. Pour les récupérer, vous pouvez accéder à la propriété metadata ou à l’événement metadataReceived.

Chaque élément du tableau contient deux champs :

• Le champ name contient un nom arbitraire du point de repère.
• Le champ time contient l’emplacement de la tête de lecture, en secondes, du contrôle VideoDisplay avec lequel le point de repère est associé.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement cuePointsChanged .

Indique la durée, en millisecondes, pendant laquelle la connexion est inactive (la lecture est interrompue ou arrêtée) avant que la connexion à Flash Media Server ne soit arrêtée. Cette propriété n’a aucun effet sur le téléchargement avec le protocole HTTP des fichiers FLV. Si cette propriété est définie lorsque le flux est déjà inactif, elle redémarre le délai d’expiration de l’inactivité avec une nouvelle valeur.

La valeur par défaut est 300000 (five minutes).

Indique si le contrôle effectue une diffusion en continu live. Définissez cette propriété sur true lors de la diffusion en continu live depuis Flash Media Server.

La valeur par défaut est false.

Indique si le contrôle doit conserver la proportion d’origine lors du redimensionnement de la vidéo.

La valeur par défaut est true.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement maintainAspectRatioChanged .

Objet contenant un paquet d’informations sur les métadonnées qui est reçu d’un appel de la méthode de rappel NetStream.onMetaData(), si elle est disponible. 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.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement metadataReceived .

Position de la tête de lecture, mesurée en secondes, depuis le début de la lecture de la vidéo. L’objet d’événement pour de nombreux événements VideoPlay inclut l’emplacement de la tête de lecture, de sorte que vous pouvez déterminer l’endroit dans le fichier vidéo où l’événement s’est produit.

Définir cette propriété sur une valeur en secondes lance une opération de recherche. Si la vidéo est en cours de lecture, elle continue à être lue à partir du nouvel emplacement de la tête de lecture. Si la vidéo est interrompue, elle recherche le nouvel emplacement de la tête de lecture et reste interrompue. Si la vidéo est arrêtée, elle recherche le nouvel emplacement de la tête de lecture et passe en état d’interruption. Définir cette propriété n’a aucun effet avec les diffusions en continu live.

Si le nouvel emplacement de la tête de lecture est inférieur à 0 ou NaN, le contrôle génère une exception. Si le nouvel emplacement de la tête de lecture est au-delà de la fin de la vidéo ou a dépasse la quantité du fichier vidéo téléchargée jusque là, le contrôle tente tout de même la recherche.

Pour un fichier FLV, définir la propriété playheadTime permet de rechercher l’image-clé la plus proche de la position spécifiée. Les images-clés sont spécifiées dans le fichier FLV au moment de l’encodage. Par conséquent, il est possible que vous ne recherchiez pas le moment correct si aucune image-clé n’est spécifié à cette position.

Si le lecteur est dans un état non réactif, il met la demande en file d’attente.

Cette propriété génère une exception si elle est définie lorsque aucun flux n’est connecté. Utilisez l’événement stateChange et la propriété connected pour savoir quand définir cette propriété en toute sécurité.

La valeur par défaut est NaN.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement playheadUpdate .

Indique la durée, en millisecondes, qui sépare chaque événement playheadUpdate.

Si vous définissez cette propriété alors que la vidéo est en cours de lecture, l’horloge redémarre à 0 et l’événement playheadUpdate suivant a lieu après le nouvel intervalle.

La valeur par défaut est 250.

Si la valeur est true, le fichier multimédia est en cours de lecture.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement stateChange .

Indique la durée, en millisecondes, qui sépare chaque événement progress L’événement progress a lieu continuellement jusqu’à ce que la vidéo soit entièrement téléchargée.

Si vous définissez cette propriété alors que la vidéo est en cours de téléchargement, l’horloge redémarre à 0 et l’événement progress suivant a lieu après le nouvel intervalle.

La valeur par défaut est 250.

Chemin relatif et nom de fichier du fichier FLV à diffuser en continu.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement sourceChanged .

Etat actuel du contrôle VideoDisplay. Vous définissez cette propriété en appelant les méthodes load(), play(), stop() et pause() et en définissant la propriété playHeadTime.

Cette propriété peut comporter les valeurs suivantes, définies dans la classe VideoEvent : VideoEvent.BUFFERING, VideoEvent.CONNECTION_ERROR, VideoEvent.DISCONNECTED, VideoEvent.EXEC_QUEUED_CMD, VideoEvent.LOADING, VideoEvent.PAUSED, VideoEvent.PLAYING, VideoEvent.RESIZING, VideoEvent.REWINDING, VideoEvent.SEEKING et VideoEvent.STOPPED.

La valeur par défaut est VideoEvent.DISCONNECTED.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement stateChange .

Eléments de l’API associés

Indique si le contrôle VideoDisplay est dans un état réactif (true) ou non réactif (false). Le contrôle entre dans un état réactif lorsque la vidéo est chargée ou rembobinée.

Le contrôle est également dans un état réactif lorsque la propriété state est : VideoEvent.CONNECTION_ERROR, VideoEvent.EXEC_QUEUED_CMD ou VideoEvent.RESIZING.

Si le contrôle est non réactif, les appels des méthodes play(), load(), stop() et pause() sont mis en file d’attente, puis exécutés lorsque le contrôle passe à l’état réactif.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement stateChange .

Longueur totale du fichier multimédia, en secondes. Pour les fichiers vidéo FLV 1.0, définissez cette propriété manuellement. Pour FLV 1.1 et version ultérieure, le contrôle calcule cette valeur automatiquement.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement metadataReceived .

Hauteur du fichier FLV chargé. -1 si aucun fichier FLV n’est encore chargé.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement resize .

Largeur du fichier FLV chargé. -1 si aucun fichier FLV n’est encore chargé.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement resize .

Niveau du volume, indiqué comme valeur comprise entre 0 et 1.

La valeur par défaut est 0.75.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement volumeChanged .

Constructeur.

Indique de lire un flux vidéo depuis une caméra. La vidéo s’affiche dans les limites du contrôle dans la fenêtre d’application. N’appelez pas la méthode play() lorsque vous affichez un flux depuis une caméra.

Paramètres

Force la fermeture d’un flux d’entrée et d’une connexion à Flash Media Server. L’appel de cette méthode distribue l’événement close. En général, l’appel direct de cette méthode n’est pas nécessaire, car la connexion est automatiquement fermée à la fin de la période d’inactivité, telle que définie par la propriété idleTimeout.

Crée la bordure de ce composant. Normalement, la bordure est déterminée par les styles borderStyle et borderSkin. La propriété de la bordure doit être définie sur l’instance de la bordure.

Répond aux changements de taille en définissant les positions et les tailles des bordures.

La méthode VideoDisplay.layoutChrome() définit la position et la taille de la bordure du contrôle VideoDisplay. Dans chaque sous-classe du contrôle VideoDisplay, la méthode layoutChrome() de la sous-classe doit appeler la méthode super.layoutChrome(), afin de positionner correctement la bordure.

Paramètres

Charge le fichier multimédia sans le lire.

Cette méthode est similaire à la méthode play(), mais elle provoque le chargement du fichier sans sa lecture. Un redimensionnement sera effectué si besoin est. Après le chargement et le redimensionnement automatique, l’état du contrôle est défini sur VideoEvent.PAUSED.