Nombre de secondes de données enregistrées dans la mémoire tampon. Vous pouvez utiliser cette propriété conjointement avec bufferTime pour estimer le niveau de remplissage du tampon ; par exemple, pour indiquer ce niveau à un utilisateur qui attend la fin du chargement des données dans le tampon.

Voir aussi

Spécifie la durée de la mise en mémoire tampon des messages avant que l’affichage du flux ne commence. Par exemple, pour vous assurer que la lecture du flux continu ne soit pas interrompue pendant les 15 premières secondes, définissez bufferTime sur 15. L'application ne commence la lecture du flux continu que 15 secondes après la mise en mémoire tampon des données.

La valeur par défaut est 0.1 (un dixième de seconde). Pour déterminer le nombre de secondes actuellement dans la mémoire tampon, utilisez la propriété bufferLength.

Remarque : pour éviter toute distorsion lors de la diffusion de contenu pré-enregistré (pas en direct), ne réglez pas la valeur de Netstream.bufferTime sur 0. Par défaut, l'application utilise un tampon d'entrée pour le contenu pré-enregistré qui met les données en file d'attente et lit le fichier correctement. Pour le contenu pré-enregistré, utilisez le paramétrage par défaut ou augmentez la durée du tampon.

Depuis Flash Player 9.0.115.0, le lecteur n'efface plus la mémoire tampon lors de l'appel de NetStream.pause(). Avant Flash Player 9.0.115.0, le lecteur attendait le remplissage du tampon avant de reprendre la lecture, ce qui entraînait souvent des retards.

En cas d'interruption unique, la propriété NetStream.bufferLength possède une limite de 60 secondes ou de deux fois la valeur de NetStream.bufferTime (la limite supérieure est prise en compte). Par exemple, si la propriété bufferTime est de 20 secondes, Flash Player effectue la mise en mémoire tampon jusqu'à ce que la propriété NetStream.bufferLength corresponde à la valeur la plus élevée de 20*2 (c'est-à-dire 40), ou à la valeur 60 ; dans ce cas, Flash Player effectue la mise en mémoire tampon jusqu'à ce que la valeur de bufferLength corresponde à 60. Si la propriété bufferTime est de 40 secondes, Flash Player effectue la mise en mémoire tampon jusqu'à ce que la propriété bufferLength corresponde à la valeur la plus élevée de 40*2 (c'est-à-dire 80), ou à la valeur 60 ; dans ce cas, Flash Player effectue la mise en mémoire tampon jusqu'à ce que la valeur de bufferLength corresponde à 80.

La propriété bufferLength possède en outre une limite absolue. Si un appel à pause() provoque l'augmentation de bufferLength de plus de 600 secondes, ou la valeur de plus élevée de bufferTime * 2, Flash Player efface le contenu de la mémoire tampon et remet à zéro bufferLength. Par exemple, si la propriété bufferTime est de 120 secondes, Flash Player efface le contenu de la mémoire tampon si la propriété bufferLength atteint 600 secondes ; si bufferTime est de 360 secondes, Flash Player efface le contenu de la mémoire tampon si bufferLength atteint 720 secondes.

Conseil : vous pouvez utiliser NetStream.pause() dans le code pour mettre les données en mémoire tampon pendant que les spectateurs regardent une annonce publicitaire, par exemple, puis annuler l'interruption lorsque la vidéo principale démarre.

Pour plus d'informations sur le nouveau comportement d'interruption, consultez la page http://www.adobe.com/go/learn_fms_smartpause_fr.

Flash Media Server. Le comportement du tampon varie en fonction de la définition de la durée du tampon : sur un flux de publication ou sur un flux d'abonnement. Dans le cas d'un flux de publication, bufferTime spécifie la durée pendant laquelle le tampon sortant peut croître avant que l'application ne commence à abandonner des images. Dans le cas d'une connexion haut débit, la durée du tampon n'est pas un problème : les données sont envoyées presque aussi rapidement que ce que l'application peut les mettre en mémoire tampon. Dans le cas d'une connexion bas débit, toutefois, il peut exister une différence considérable entre la vitesse à laquelle l'application place les données en mémoire tampon et celle à laquelle il peut les envoyer au client.

Dans le cas d'un flux d'abonnement, bufferTime spécifie le délai pendant lequel les données entrantes doivent être mises en mémoire tampon avant que l'affichage du flux ne commence. Par exemple, si vous voulez vous assurer que la lecture du flux soit ininterrompue au cours des 15 premières secondes, définissez bufferTime sur 15 ; Flash commencera la lecture du flux uniquement 15 secondes après la mise en mémoire tampon des données.

Lors de la lecture d'un flux enregistré, si bufferTime est défini sur zéro, Flash le définit sur une faible valeur (environ 10 millisecondes). Si des flux en direct sont ensuite lus (par exemple depuis une liste de lecture), cette durée de tampon persiste. Cela signifie que bufferTime demeure non nul pour le flux.

Voir aussi

Nombre d'octets de données ayant été chargés dans l'application. Vous pouvez utiliser cette propriété conjointement avec bytesTotal pour estimer le niveau de remplissage du tampon ; par exemple, pour indiquer ce niveau à un utilisateur qui attend la fin du chargement des données dans le tampon.

Voir aussi

Taille totale, en octets, du fichier chargé dans l'application.

Voir aussi

Spécifie si l'application doit tenter de télécharger un fichier de régulation interdomaines à partir du serveur du fichier vidéo chargé avant de commencer à charger ce dernier. Cette propriété est applicable lorsque vous utilisez un objet NetStream pour télécharger progressivement des données vidéo (fichiers autonomes) ou lorsque vous chargez des fichiers se trouvant en dehors du domaine du fichier appelant. Cette propriété n'est pas prise en compte lorsque vous utilisez un objet NetStream pour obtenir une ressource RTMP.

Définissez cette propriété sur true lorsque vous chargez un fichier vidéo qui se trouve hors du domaine du fichier SWF appelant et qu'il vous est nécessaire d'utiliser la méthode BitmapData.draw() pour accéder à la vidéo au niveau des pixels. Si vous appelez BitmapData.draw() sans définir la propriété checkPolicyFile sur true au chargement, vous risquez d'obtenir une exception SecurityError car le fichier de régulation requis n'a pas été téléchargé.

Si vous n'avez pas besoin d'accéder à la vidéo que vous chargez au niveau des pixels, il est préférable de ne pas définir checkPolicyFile sur true. La recherche d'un fichier de régulation consomme de la bande passante et risque de retarder le début du téléchargement.

Lorsque vous appelez la méthode NetStream.play() en définissant checkPolicyFile sur true, Flash Player ou le moteur d'exécution AIR doit télécharger un fichier de régulation interdomaines approprié ou déterminer qu’un tel fichier n’existe pas, avant de commencer à télécharger l’objet spécifié dans votre appel de NetStream.play(). Pour vérifier l’existence d’un fichier de régulation, Flash Player ou le moteur d'exécution AIR effectue les actions suivantes, dans l’ordre indiqué :

1. L'application examine les fichiers de régulation préalablement téléchargés.
2. L'application tente de télécharger tout fichier de régulation en attente spécifié dans les appels de la méthode Security.loadPolicyFile().
3. L'application tente de télécharger un fichier de régulation à partir de l’emplacement par défaut qui correspond à l’URL que vous avez transmise à NetStream.play(), à savoir /crossdomain.xml sur le même serveur que cette URL.

Dans tous les cas, Flash Player ou le moteur d'exécution AIR exige que le serveur du fichier vidéo héberge un fichier de régulation approprié, que ce dernier permette d’accéder à l’objet à l’adresse URL que vous avez transmise à play() sur la base de l’emplacement du fichier de régulation, et qu’il autorise le domaine du fichier de code appelant à accéder au fichier vidéo par le biais d’une ou plusieurs balises <allow-access-from>.

Si vous définissez checkPolicyFile sur true, l'application attend la vérification du fichier de régulation avant de télécharger la vidéo. Avant de manipuler les données vidéo au niveau des pixels, en appelant BitmapData.draw(), par exemple, attendez d'avoir reçu de votre objet NetStream des événements onMetaData ou NetStatus.

Si vous définissez checkPolicyFile sur true et qu’il n’existe aucun fichier de régulation approprié, vous ne recevez pas de message d’erreur tant que vous n’effectuez pas une opération nécessitant un tel fichier, auquel cas l'application renvoie une exception SecurityError.

Servez-vous de checkPolicyFile avec précaution si vous téléchargez un fichier vidéo à partir d'une URL qui utilise des redirections HTTP côté serveur. L'application tente d’extraire les fichiers de régulation correspondant à l’URL spécifiée à l’origine dans NetStream.play(). Si le fichier final provient d'une URL différente suite à des redirections HTTP, les fichiers de régulation initialement téléchargés peuvent ne pas être applicables à l'URL finale du fichier , autrement dit l'URL qui doit faire l'objet des mesures de sécurité.

Pour plus d'informations sur les fichiers de régulation, consultez le chapitre « Sécurité de Flash Player » du manuel Programmation avec ActionScript 3.0.

Voir aussi

Spécifie l'objet sur lequel les méthodes de rappel sont invoquées pour traiter la diffusion ou les données des fichiers FLV. L'objet par défaut correspond à this, l'objet NetStream en cours de création. Si vous réglez la propriété client sur un autre objet, les méthodes de rappel sont appelées sur celui-ci. L'objet NetStream.client peut appeler les fonctions suivantes et recevoir un objet de données associé : onCuePoint(), onImageData(), onMetaData(), onPlayStatus(), onTextData() et onXMPData().

Pour associer la propriété client à un gestionnaire d'événement :

1. Créez un objet et affectez-le à la propriété client de l'objet NetStream :

   var customClient:Object = new Object();
        my_netstream.client = customClient;

2. Affectez une fonction de gestionnaire pour l'événement de données désiré en tant que propriété de l'objet client :

   customClient.onImageData = onImageDataHandler;

3. Ecrivez la fonction de gestionnaire pour recevoir l'objet d'événement de données, tel que :

   public function onImageDataHandler(imageData:Object):void {
                 trace("imageData length: " + imageData.data.length);
         }

Lorsque les données sont transmises via le flux ou au cours de la lecture, l'objet événement de données (dans ce cas l'objet imageData) est renseigné avec les données. Reportez-vous à la description de onImageData, qui inclut un exemple complet d'objet affecté à la propriété client.

Pour associer la propriété client à une sous-classe :

1. Créez une sous-classe avec une fonction de gestionnaire pour recevoir l'objet événement de données :

   class CustomClient {
           public function onMetaData(info:Object):void {
               trace("metadata: duration=" + info.duration + " framerate=" + info.framerate);
        }

2. Affectez une occurrence de la sous-classe à la propriété client de l'objet NetStream :

   my_netstream.client = new CustomClient();

Lorsque les données sont transmises via le flux ou au cours de la lecture, l'objet événement de données (dans ce cas l'objet info) est renseigné avec les données. Reportez-vous à l'exemple de classe proposé à la fin de la classe NetStream, qui illustre l'affectation d'une occurrence de sous-classe à la propriété client.

Voir aussi

Nombre d'images affichées par seconde. Si vous exportez des fichiers vidéo pour les lire sur différents systèmes, vous pouvez vérifier cette valeur pendant le test afin de déterminer la compression à appliquer lors de l'exportation du fichier.

Identifiant de l'extrémité connectée à cette occurrence de NetStream. Cette propriété n'est définie que pour les connexions RTMFP.

Valeur choisie réellement par l'autre extrémité de ce flux, unique pour cette connexion. Cette valeur apparaît à l'autre extrémité du flux en tant que valeur nearNonce. Cette propriété n'est définie que pour les connexions RTMFP.

Renvoie un objet NetStreamInfo dont les propriétés contiennent des statistiques sur la qualité de service. L'objet est un instantané de l'état en cours.

Voir aussi

Nombre de secondes de données enregistrées dans le tampon du flux abonné en mode en direct (sans mise en mémoire tampon). Cette propriété spécifie l'actuel délai de transmission réseau (retard).

Cette propriété est surtout conçue pour une utilisation avec un serveur, tel que Flash Media Server. Pour en savoir plus, consultez la description de la classe.

Vous pouvez extraire la valeur de cette propriété pour évaluer approximativement la qualité de transmission du flux continu, et la communiquer à l’utilisateur.

Spécifie la durée de la mise en tampon des messages pendant le mode pause, en secondes. Cette propriété peut être utilisée pour limiter le volume de mise en mémoire tampon pendant le mode pause. Dès que la valeur NetStream.bufferLength atteint cette limite, la mise en mémoire tampon s'arrête. Si cette valeur n'est pas définie, la limite par défaut est de 60 secondes ou correspond à deux fois la valeur de NetStream.bufferTime sur chaque pause (la valeur la plus élevée est prise en compte).

Voir aussi

Valeur choisie réellement par cette extrémité du flux, unique pour cette connexion. Cette valeur apparaît à l'autre extrémité du flux en tant que valeur farNonce. Cette propriété n'est définie que pour les connexions RTMFP.

Encodage d'objet (version AMF) de cet objet NetStream. L'objet NetStream hérite de sa valeur objectEncoding de l'objet NetConnection associé. Il est important de comprendre cette propriété si votre fichier SWF ActionScript 3.0 doit communiquer avec des serveurs antérieurs à Flash Player 9. Pour plus d'informations, consultez la description de la propriété objectEncoding dans la classe NetConnection.

La valeur de cette propriété varie selon la nature du flux continu, local ou distant. Les flux locaux, dans lesquels null a été transmis à la méthode NetConnection.connect(), renvoient la valeur de NetConnection.defaultObjectEncoding. Les flux distants, pour lesquels vous êtes connecté(e) à un serveur, renvoient l'encodage d'objet de la connexion au serveur.

Si vous tentez de lire cette propriété sans être connecté ou si vous tentez de la modifier, l'application renvoie une exception.

Voir aussi

Objet qui détient toutes les occurrences NetStream d'abonnement qui écoutent cette occurrence de NetStream de publication.

Contrôle le son dans l'objet NetStream. Pour plus d'informations, consultez la description de la classe SoundTransform.

Voir aussi

Position de la tête de lecture, en secondes.

Flash Media Server Dans le cas d'un flux d'abonnement, nombre de secondes pendant lequel le flux a été lu. Dans le cas d'un flux de publication, nombre de secondes pendant lequel le flux a été publié. Ce nombre est précis au millième près ; multipliez-le par 1000 pour obtenir le nombre de millisecondes pendant lequel le flux a été lu.

Dans le cas d'un flux d'abonnement, si le serveur cesse d'envoyer des données et que le flux demeure ouvert, la valeur de la propriété time cesse d'avancer. Lorsque le serveur recommence à envoyer des données, la valeur continue d'avancer là où elle s'est arrêtée (c'est-à-dire lorsque le serveur a cessé l'envoi des données).

La valeur de la propriété time continue d'avancer lorsque le flux bascule d'un élément de la liste de lecture à un autre. Cette propriété est définie sur 0 lorsque NetStream.play() est appelé avec reset défini sur 1 ou sur true, ou lorsque NetStream.close() est appelé.

Voir aussi

Crée un flux de diffusion en continu qui permet de lire des fichiers vidéo à l'aide de l'objet NetConnection spécifié.

Pour plus d'informations sur les codecs et les formats de fichier pris en charge, consultez la page http://www.adobe.com/go/hardware_scaling_fr, ainsi que la documentation de Flash Media Server.

new NetStream(nc:NetConnection);

Voir aussi

var my_nc:NetConnection = new NetConnection();
            my_nc.connect(null);
            var my_ns:NetStream = new NetStream(my_nc);
            my_ns.play(videoURL);
            var my_video:Video = new Video();
            my_video.attachNetStream(my_ns);
            addChild(my_video);

var my_nc:NetConnection = new NetConnection();
            my_nc.connect("rtmp://www.yourfmsserver.com/someappname");
            var my_ns:NetStream = new NetStream(my_nc, NetStream.CONNECT_TO_FMS);
            my_ns.play(videoURL);
            var my_video:Video = new Video();
            my_video.attachNetStream(my_ns);
            addChild(my_video);

Spécifie un flux audio en continu envoyé via un objet NetStream, à partir d'un objet Microphone transmis en tant que source. Cette méthode n'est accessible qu'à l'éditeur du flux continu spécifié.

La méthode attachAudio est conçue pour une utilisation avec Flash Media Server. Cette méthode est souvent appelée par un utilisateur qui envoie des données audio en direct (ou des données vidéo en direct avec son) depuis un ordinateur client vers le serveur.

Vous pouvez appeler cette méthode avant ou après la méthode publish() et le démarrage réel de la transmission. Les abonnés qui souhaitent entendre le son doivent appeler la méthode NetStream.play(). Réglez la propriété rate du microphone afin qu'elle corresponde à celle du périphérique de capture audio, puis définissez le seuil de silence via la méthode setSilenceLevel(). Vous pouvez contrôler les propriétés audio (volume et balance) de ce flux audio audio via la propriété soundTransform de l'objet du microphone.

var conn:NetConnection = new NetConnection();
     conn.connect("rtmp://server.domain.com/path");
     var stream:NetStream = new NetStream(conn);
     var live_mic:Microphone = Microphone.get();
     live_mic.rate = 8;
     live_mic.setSilenceLevel(20,200);
     var soundTrans:SoundTransform = new SoundTransform();
     soundTrans.volume = 6;
     live_mic.soundTransform = soundTrans;
     stream.attachAudio(live_mic);
     stream.publish("mic_stream","live")

Paramètres

Voir aussi

Démarre la capture vidéo à partir de la caméra ou arrête la capture si theCamera est défini sur null. Cette méthode n'est accessible qu'à l'éditeur du flux continu spécifié.

Cette méthode est conçue pour une utilisation avec Flash Media Server. Pour en savoir plus, consultez la description de la classe.

Une fois la source vidéo associée, vous devez appeler NetStream.publish() pour commencer la transmission. Les abonnés qui souhaitent afficher la vidéo doivent appeler les méthodes NetStream.play() et Video.attachCamera() pour afficher la vidéo sur la scène.

Vous pouvez utiliser snapshotMilliseconds pour envoyer un instantané unique (avec valeur 0) ou une série d'instantanés, soit une séquence en accéléré (time lapse), en spécifiant un nombre positif qui ajoute à la source vidéo le nombre indiqué de millisecondes. Ce nombre étend la durée d'affichage du message vidéo. Si vous appelez attachCamera() à plusieurs reprises en définissant une valeur positive pour snapshotMilliseconds, la séquence d'instantanés et les millisecondes supplémentaires en alternance créent une séquence en accéléré. Vous pouvez, par exemple, capturer une image par jour et l'ajouter à la fin du fichier vidéo. Lorsqu'un abonné lit le fichier, chaque image s'affiche pendant le nombre spécifié de millisecondes, puis l'image suivante apparaît.

Le paramètre snapshotMilliseconds n'a pas le même objectif que le paramètre fps, que vous pouvez définir à l'aide de la méthode Camera.setMode(). Lorsque vous spécifiez snapshotMilliseconds, vous contrôlez le temps qui s'écoule entre les images enregistrées. Lorsque vous spécifiez fps à l'aide de Camera.setMode(), vous contrôlez le temps qui s'écoule à l'enregistrement et à la lecture.

Imaginons, par exemple, que vous voulez capturer 100 instantanés, à raison d'un instantané toutes les 5 minutes. Deux solutions s'offrent à vous :

• Vous pouvez émettre une commande NetStream.attachCamera(myCamera, 500) à 100 reprises, toutes les 5 minutes. L'enregistrement prend 500 minutes, mais le fichier résultant est lu en 50 secondes (100 images, 500 millisecondes entre elles).
• Vous pouvez émettre une commande Camera.setMode() en réglant fps sur 1/300 (une image toutes les 300 secondes, autrement dit, toutes les 5 minutes), puis une commande NetStream.attachCamera(source), en laissant la caméra capturer des images en continu pendant 500 minutes. Il faudra 500 minutes pour lire le fichier produit ; en d'autres termes autant que pour l'enregistrer, chaque image étant affichée pendant 5 minutes.

Ces deux techniques capturent les mêmes 500 images et les deux sont utiles. Votre choix doit être déterminé principalement par le type de lecture souhaité. Dans le second cas, par exemple, vous pourriez enregistrer du son en même temps. Par ailleurs, les deux fichiers feraient environ la même taille.

Paramètres

Arrête la lecture des données du flux, définit la propriété time sur 0 et met le flux à disposition. Cette méthode supprime également la copie locale d'un fichier vidéo téléchargé via HTTP. Même si l'application supprime la copie locale du fichier qu'il crée, une copie peut subsister dans le répertoire cache. Si vous devez empêcher toute mise en cache ou tout stockage local du fichier vidéo, utilisez Flash Media Server.

Avec Flash Media Server, cette méthode est invoquée implicitement lorsque vous appelez NetStream.play() depuis un flux de publication ou NetStream.publish() depuis un flux d'abonnement. Veuillez noter que :

• Si close() est appelée depuis un flux de publication, le flux arrête la publication et l'éditeur peut alors utiliser ce flux dans un autre but. Les abonnés ne reçoivent plus aucun élément publié sur ce flux, car ce dernier a arrêté la publication.
• Si close() est appelée depuis un flux d'abonnement, le flux arrête la lecture pour l'abonné et ce dernier peut utiliser ce flux dans un autre but. Les autres abonnés ne sont pas affectés.
• Vous pouvez arrêter la lecture d'un flux d'abonnement sans fermer le flux ou modifier le type de flux en utilisant flash.net.NetStream.play(false).

Voir aussi

Invoqué lorsqu'un flux d'homologue éditeur correspond à un flux d'homologue abonné. Avant que l'abonné ne soit connecté à l'éditeur, appelez cette méthode pour permettre au code ActionScript de contrôler l'accès en vue d'une publication homologue à homologue. Le code suivant montre un exemple de création d'une fonction de rappel pour cette méthode :

var c:Object = new Object;
  c.onPeerConnect = function(subscriber:NetStream):Boolean {
  if (accept)
   return true;
   else
       return false;
   };
   m_netStream.client = c;

Si l'éditeur homologue n'implémente pas cette méthode, tous les homologues sont autorisés à lire tout contenu publié.

Paramètres

Interrompt la lecture d'un flux vidéo. L'appel de cette méthode n'a aucune incidence si la vidéo est déjà en pause. Pour reprendre la lecture d'une vidéo après une pause, appelez resume(). Pour basculer entre la pause et la lecture (en commençant par mettre la vidéo en pause, puis en reprenant la lecture), appelez togglePause().

Depuis Flash Player 9.0.115.0, le lecteur n'efface plus la mémoire tampon lors de l'appel de NetStream.pause(). Avant Flash Player 9.0.115.0, le lecteur attendait le remplissage du tampon avant de reprendre la lecture, ce qui entraînait souvent des retards.

En cas d'interruption unique, la propriété NetStream.bufferLength possède une limite de 60 secondes ou de deux fois la valeur de NetStream.bufferTime (la limite supérieure est prise en compte). Par exemple, si la propriété bufferTime est de 20 secondes, Flash Player effectue la mise en mémoire tampon jusqu'à ce que la propriété NetStream.bufferLength corresponde à la valeur la plus élevée de 20*2 (c'est-à-dire 40), ou à la valeur 60 ; dans ce cas, Flash Player effectue la mise en mémoire tampon jusqu'à ce que la valeur de bufferLength corresponde à 60. Si la propriété bufferTime est de 40 secondes, Flash Player effectue la mise en mémoire tampon jusqu'à ce que la propriété bufferLength corresponde à la valeur la plus élevée de 40*2 (c'est-à-dire 80), ou à la valeur 60 ; dans ce cas, Flash Player effectue la mise en mémoire tampon jusqu'à ce que la valeur de bufferLength corresponde à 80.

La propriété bufferLength possède en outre une limite absolue. Si un appel à pause() provoque l'augmentation de bufferLength de plus de 600 secondes, ou la valeur de plus élevée de bufferTime * 2, Flash Player efface le contenu de la mémoire tampon et remet à zéro bufferLength. Par exemple, si la propriété bufferTime est de 120 secondes, Flash Player efface le contenu de la mémoire tampon si la propriété bufferLength atteint 600 secondes ; si bufferTime est de 360 secondes, Flash Player efface le contenu de la mémoire tampon si bufferLength atteint 720 secondes.

Conseil : vous pouvez utiliser NetStream.pause() dans le code pour mettre les données en mémoire tampon pendant que les spectateurs regardent une annonce publicitaire, par exemple, puis annuler l'interruption lorsque la vidéo principale démarre.

Voir aussi

Lit les fichiers multimédias.

Pour plus d'informations sur les codecs et les formats de fichier pris en charge, consultez la page http://www.adobe.com/go/hardware_scaling_fr, ainsi que la documentation de Flash Media Server.

Pour visualiser les données vidéo, créez un objet Video et appelez la méthode Video.attachNetStream(). Pour diffuser des données audio en continu à partir d'un microphone, utilisez la méthode NetStream.attachAudio(). Utilisez l'objet Microphone pour contrôler certains aspects du son.

Appelez la méthode DisplayObjectContainer.addChild() pour ajouter le son à un objet de la liste d'affichage. Vous pouvez ensuite créer un objet Sound pour contrôler certains aspects du son. Pour plus d'informations, consultez la méthode DisplayObjectContainer.addChild().

Si le fichier vidéo est introuvable, l'événement netStatus est distribué. Pour arrêter un flux continu en cours de lecture, utilisez la méthode close().

Lorsque vous utilisez cette méthode sans Flash Media Server, il existe certaines contraintes de sécurité. Un fichier , placé dans le sandbox local approuvé ou local avec accès au réseau, peut charger et lire un fichier vidéo à partir du sandbox distant. Cependant, il ne peut pas accéder aux données de ce fichier distant sans une autorisation explicite, accordée sous forme de fichier de régulation d'URL. Vous pouvez en outre empêcher un fichier SWF s'exécutant dans Flash Player d'utiliser cette méthode ; pour cela, vous devez définir le paramètre allowNetworking des balises object et embed dans la page HTML qui comporte le contenu SWF.

Vous ne pouvez pas vous connecter aux ports généralement réservés. Vous trouverez la liste complète des ports bloqués dans la section « Restriction des API de réseau » du chapitre sur la sécurité du manuel Programmation ActionScript 3.0.

Vous ne pouvez pas vous connecter aux ports généralement réservés. Vous trouverez la liste complète des ports bloqués dans la section « Restriction des API de réseau » du chapitre sur la sécurité du manuel Programmation ActionScript 3.0.

Pour plus d'informations sur la sécurité, consultez les références suivantes :

• Le chapitre relatif à la sécurité du manuel Programmation avec ActionScript 3.0 et les derniers commentaires disponibles dans LiveDocs
• La rubrique du Centre des développeurs de Flash Player : Sécurité
• Propriété Netstream.checkPolicyFile.

Paramètres

Voir aussi

ns.play("mp4:record1.f4v", 0, 100, true);

ns.play("stephen");

Commence la lecture des fichiers multimédia, avec plusieurs options de lecture.

Cette méthode est une version améliorée de NetStream.play(). Comme la méthode play(), la méthode play2() commence la lecture d'un fichier multimédia ou met des fichiers multimédia en file d'attente pour créer une liste de lecture. Lorsqu'elle est utilisée avec Flash Media Server, elle peut également demander au serveur de basculer vers un autre fichier multimédia. La transition est transparente dans l'application client.

Utilisez la méthode play2() pour basculer vers un flux de même contenu chiffré avec des débits différents ou pour changer de flux à partir d'une liste de lecture. Utilisez la classe NetStreamInfo pour gérer les conditions du réseau et changer de flux en fonction des données. Vous pouvez également changer de flux pour des clients ayant des capacités différentes. On appelle diffusion dynamique en continu l'utilisation d'ActionScript pour changer de flux. Pour plus d'informations, recherchez « diffusion dynamique en continu » dans le « Guide du développeur d'Adobe Flash Media Server » à l'adresse www.adobe.com/go/learn_fms_devguide_fr. Adobe a conçu une classe ActionScript personnalisée appelée DynamicStream qui étend la classe NetStream. Vous pouvez utiliser la classe DynamicStream pour implémenter la diffusion dynamique en continu dans une application au lieu d'écrire votre propre code afin de détecter les conditions du réseau. Même si vous choisissez d'écrire votre propre code de diffusion dynamique en continu, consultez la classe DynamicStream pour obtenir un exemple d'implémentation. Téléchargez la classe et la documentation correspondante à l'adresse suivante : www.adobe.com/go/fms_dynamicstreaming_fr.

Paramètres

Voir aussi

Extrait les métadonnées DRM d'un fichier multimédia enregistré localement.

Utilisez tout d'abord preloadEmbeddedMetaData() lors du téléchargement et de la mise en mémoire cache des vouchers DRM nécessaires à la lecture hors ligne. Lorsque des métadonnées DRM intégrées sont détectées dans un fichier multimédia, un objet DRMContentData est transmis à la fonction onDRMContentData du client NetStream. Cet objet DRMContentData contient les informations nécessaires à l'obtention du voucher requis pour lire le contenu. Transmettez DRMContentDataObject à la méthode DRMManager loadVoucher() pour télécharger le voucher.

Les étapes pour précharger un voucher DRM sont les suivantes :

• Créez un nouvel objet NetStream pour précharger les métadonnées.

• Affectez une fonction de rappel à la propriété onDRMContentData du client NetStream.
• Créez un nouvel objet NetStreamPlayOptions, puis définissez la propriété streamName sur la chaîne URL du fichier vidéo local.
• Appelez preloadEmbeddedMetadata(), tout en transmettant l'objet NetStreamPlayOptions.
• En réponse au rappel onDRMContentData, appelez la méthode loadVoucher() de DRMManager, tout en transmettant l'objet DRMContentData. Si la propriété authenticationMethod de l'objet DRMContentData est définie sur la valeur userNameAndPassWord, vous devez authentifier l'utilisateur sur le serveur de droits multimédias avant de charger le voucher.
• Fermez l'objet NetStream avant le préchargement.

Remarque : si vous utilisez le même objet NetStream pour précharger les métadonnées et lire le contenu, vous devez attendre l'appel de onPlayStatus généré par l'opération de préchargement avant de commencer la lecture.

Les vouchers téléchargés sont stockés dans une mémoire cache locale. La lecture de contenu en ligne permet également de télécharger et de mettre en cache les vouchers. Lors de la visualisation d'un fichier dont le contenu est protégé par DRM, un voucher mis en cache est automatiquement récupéré à partir du magasin local. Utilisez DRMManager pour gérer la mémoire cache du voucher.

Remarques : le préchargement des métadonnées DRM via une connexion HTTP, HTTPS ou RTMP n'est pas pris en charge. Vous ne pouvez précharger des métadonnées qu'à partir de fichiers enregistrés sur le systèmes de fichiers.

Paramètres

Voir aussi

Envoie des données audio, vidéo et des messages texte en diffusion continue d'un client au Flash Media Server, en enregistrant éventuellement le flux continu pendant la transmission. Cette méthode n'est accessible qu'à l'éditeur du flux continu spécifié.

Vous pouvez enregistrer des fichiers au format FLV ou MPEG-4. Si vous enregistrez un fichier au format MPEG-4, vous devez utiliser un outil d'aplatissement pour modifier ou lire le fichier dans une autre application. Pour télécharger cet outil, accédez au site suivant : www.adobe.com/go/learn_fms_flattener_fr.

N'utilisez pas cette méthode pour lire un flux continu ayant déjà été publié et enregistré. Pour lire un flux continu, appelez la méthode NetStream.play().

var subscribeNS:NetStream = new NetStream(myNetConnection);
  subscribeNS.play("streamToPlay");

Lorsque Flash Media Server enregistre un flux continu, il crée un fichier et l'enregistre dans un sous-répertoire du répertoire de l'application situé sur le serveur. Chaque flux est stocké dans un répertoire dont le nom correspond au nom de l'occurrence de l'application transmis à NetConnection.connect(). Le serveur crée ces répertoires automatiquement. Vous n’avez donc pas à en créer un pour chaque occurrence de l'application. Le code suivant, par exemple, vous indique comment vous connecter à une occurrence spécifique d’une application enregistrée dans le sous-répertoire lectureSeries du répertoire de votre application. Un fichier nommé lecture.flv est enregistré dans le sous-répertoire /votreDossierApps/lectureSeries/streams/Monday :

var myNC:NetConnection = new NetConnection();
  myNC.connect("rtmp://server.domain.com/lectureSeries/Monday");
  var myNS:NetStream = new NetStream(myNC);
  myNS.publish("lecture", "record");

L'exemple suivant vous indique comment vous connecter à une autre occurrence de la même application, mais en émettant une commande de publication identique. Un fichier nommé lecture.flv est stocké dans le sous-répertoire /votreDossierApps/lectureSeries/streams/Tuesday :

var myNC:NetConnection = new NetConnection();
  myNC.connect("rtmp://server.domain.com/lectureSeries/Tuesday");
  var myNS:NetStream = new NetStream(myNC);
  myNS.publish("lecture", "record");

Si vous ne transmettez pas, pour le nom de l'occurrence, une valeur correspondant à la valeur transmise à la propriété name, elle est enregistrée dans le sous-répertoire /votreDossierApp/nomApp/streams/_definst_. Pour plus d'informations sur l'utilisation des noms d'occurrence, consultez la méthode NetConnection.connect(). Pour plus d'informations sur la lecture des fichiers vidéo, consultez la méthode NetStream.play().

Lorsqu'un client d'une application Flash Media Server appelle publish(), l'application reçoit un événement onPublish. L'application doit gérer l'événement dans un script coté serveur. Pour arrêter la publication, appelez la méthode NetStream.close(). Lorsque le client arrête la publication, l'application reçoit un événement onUnpublish. Pour plus d'informations, consultez le Guide de référence ActionScript de Flash Media Server côté serveur .

Cette méthode peut distribuer un événement netStatus associé à différents objets d'informations. Si, par exemple, une personne publie déjà sur un flux continu en utilisant le nom spécifié, l'événement netStatus est distribué avec une propriété code correspondant à NetStream.Publish.BadName. Pour plus d'informations, consultez l'événement netStatus.

Paramètres

Voir aussi

Indique si les données audio entrantes sont lues dans le flux continu. Cette méthode n'est accessible qu'aux clients abonnés au flux continu spécifié, et non à l'éditeur de ce dernier.

Cette méthode est conçue à l'origine pour une utilisation avec Flash Media Server. Pour en savoir plus, consultez la description de la classe.

Vous pouvez appeler cette méthode avant ou après la méthode NetStream.play() et le démarrage réel de la transmission. Vous pouvez, par exemple, associer ces méthodes à un bouton sur lequel l'utilisateur clique pour désactiver et activer le son du flux continu audio entrant.

Si le flux continu spécifié contient uniquement des données audio, la transmission de la valeur false à cette méthode interdit toute incrémentation additionnelle de NetStream.time.

Paramètres

Indique si les données vidéo entrantes sont lues dans le flux continu. Cette méthode n'est accessible qu'aux clients abonnés au flux continu spécifié, et non à l'éditeur de ce dernier.

Cette méthode est conçue à l'origine pour une utilisation avec Flash Media Server. Pour en savoir plus, consultez la description de la classe.

Vous pouvez appeler cette méthode avant ou après la méthode NetStream.play() et le démarrage réel de la transmission. Vous pouvez, par exemple, associer ces méthodes à un bouton sur lequel l'utilisateur appuie pour afficher ou masquer le flux vidéo entrant.

Si le flux continu spécifié contient uniquement des données vidéo, la transmission de la valeur false à cette méthode interdit toute incrémentation additionnelle de NetStream.time.

Paramètres

Indique la cadence d'images des données vidéo entrantes. Cette méthode n'est accessible qu'aux clients abonnés au flux continu spécifié, et non à l'éditeur de ce dernier.

Cette méthode est conçue à l'origine pour une utilisation avec Flash Media Server. Pour en savoir plus, consultez la description de la classe.

Vous pouvez appeler cette méthode avant ou après la méthode NetStream.play() et le démarrage réel de la transmission. Par exemple, vous pouvez associer ces méthodes à un champ de texte afin que l'utilisateur puisse définir la cadence d'images des données vidéo entrantes.

Pour interrompre la réception des données vidéo, transmettez la valeur 0 au paramètre FPS. Pour déterminer la cadence d'images actuelle, utilisez NetStream.currentFPS.

Si vous transmettez une valeur au paramètre FPS en vue de limiter la cadence d'images de la vidéo, Flash Media Server tente de réduire la cadence tout en préservant l'intégrité de la vidéo. Le serveur envoie le nombre d'images minimum afin de satisfaire la cadence désirée entre deux images-clés. Notez toutefois que les images intermédiaires doivent être envoyées conjointement ; dans le cas contraire, la vidéo risque d'être corrompue. Par conséquent, le nombre d'images souhaité est envoyé immédiatement et conjointement après une image-clé. Etant donné que les images ne sont pas distribuées uniformément, le mouvement entre images uniques est homogène, mais des interruptions apparaissent entre les séquences d'images.

Paramètres

Supprime toutes les données du voucher de gestion de droits numériques (DRM) mises en cache localement.

L'application doit à nouveau télécharger les vouchers requis depuis le serveur de droits multimédias afin que l'utilisateur puisse accéder au contenu protégé. Appeler cette fonction équivaut à appeler la fonction resetDRMVouchers() de l'objet DRMManager.

Voir aussi

NetStream.resetDRMVouchers();

Reprend la lecture d'un flux vidéo en pause. Si la vidéo est en cours de lecture, l'appel de cette méthode n'a aucun effet.

Voir aussi

Recherche l'image-clé (également appelée Image-I dans l'industrie vidéo) la plus proche de l'emplacement spécifié. L'image-clé est placée à un décalage, en secondes, depuis le début du flux.

Les flux vidéo sont généralement encodés avec deux types d'image, les images-clés (ou images I) et les images P. Une image clé contient l'ensemble de l'image, alors qu'une image P est une image intérimaire qui fournit des informations vidéo supplémentaires entre les images-clé. Un flux vidéo présente généralement une image-clé toutes les 10 à 50 images.

Sur Flash Media Server, le comportement de seek() est contrôlé par la valeur de l'élément EnhancedSeek du fichier de configuration Application.xml.

Si la valeur de EnhancedSeek est false, le serveur utilise le mode de recherche normal. En mode de recherche normal, le serveur commence la diffusion en continu à partir de l'image-clé la plus proche. Par exemple, si une vidéo présente des images-clés à 0 et 10 secondes, une recherche de 4 secondes entraîne un démarrage de la lecture à 4 secondes via l'image clé placée à 0 secondes. La vidéo demeure figée jusqu'à ce qu'elle atteigne la prochaine image-clé placée à 10 secondes. Pour améliorer les recherches, vous devez réduire l'intervalle des images-clés. En mode de recherche normal, vous ne pouvez pas démarrer la vidéo à un point placé entre les images clés.

Si EnhancedSeek est true, valeur par défaut, le serveur génère une nouvelle image-clé au niveau du décalage en fonction de l'image-clé précédente et de toute image P intermédiaire. Cela crée toutefois une charge de traitement élevée sur le serveur et une distorsion peut survenir dans l'image-clé générée. Si le codec vidéo est On2, l'image-clé située avant le point de recherche et toute image P située entre l'image-clé et le point de recherche sont envoyées au client.

Paramètres

Voir aussi

Envoie un message sur le flux publié à tous les clients abonnés. Cette méthode n'est disponible que pour l'éditeur du flux spécifié et est conçue pour une utilisation avec Flash Media Server. Pour traiter et répondre à ce message, créer un gestionnaire sur l'objet NetStream, par exemple ns.HandlerName.

Flash Player ou AIR ne sérialise pas les méthodes ni leurs données, les variables de prototype d’objet ou les variables non énumérables. Pour les objets d’affichage, Flash Player AIR sérialise le chemin, mais pas les données.

Vous pouvez appeler la méthode send() pour ajouter des images-clés de données à un flux en direct envoyé à Flash Media Server. Une image-clé de données est un message ajouté à un flux en direct par un éditeur. Les images-clés de données sont généralement utilisées pour ajouter des métadonnées à un flux en direct avant la capture des données pour le flux à partir de la caméra et du microphone. Un éditeur peut à tout moment ajouter une image-clé de données pendant la publication du flux. L'image-clé de données est enregistrée dans la mémoire du serveur tant que l'éditeur y est connecté.

Les clients abonnés au flux en direct avant l'ajout d'une image-clé de données reçoivent cette image-clé dès son ajout. Les clients qui s'abonnent au flux en direct après l'ajout de l'image-clé reçoivent cette image clé lorsqu'ils s'abonnent.

Pour ajouter une image-clé de métadonnées dans un flux en direct envoyé à Flash Media Server, utilisez @setDataFrame comme nom de gestionnaire, suivi de deux arguments supplémentaires, tels que :

var ns:NetStream = new NetStream(nc);
  ns.send("@setDataFrame", "onMetaData", metaData);

L'argument @setDataFrame fait référence à un gestionnaire spécial intégré au Flash Media Server. L'argument onMetaData est le nom d'une fonction de rappel de votre application client qui écoute l'événement onMetaData et récupère les métadonnées. Le troisième élément, metaData, est une occurrence de Object ou Array dont les propriétés définissent les valeurs des métadonnées. Les éditeurs doivent définir des noms de propriété que les abonnés puissent comprendre facilement ; consultez la documentation de Flash Media Server pour obtenir une liste des noms de propriété suggérés.

Utilisez @clearDataFrame pour effacer une image-clé de métadonnées déjà définie dans le flux :

ns.send("@clearDataFrame", "onMetaData");

Paramètres

Voir aussi

package {
   import flash.display.Sprite;
   import flash.net.NetConnection;
   import flash.net.NetStream;
   import flash.events.NetStatusEvent;
   import flash.media.Video;
   import flash.utils.setTimeout;

 
   public class TestExample extends Sprite
   {
     var nc:NetConnection = new NetConnection();
     var ns1:NetStream;
     var ns2:NetStream;
     var vid:Video = new Video(300,300);
     var obj:Object = new Object();
 
     public function TestExample() {
        nc.objectEncoding = 0;
        nc.addEventListener("netStatus", onNCStatus);
        nc.connect("rtmp://localhost/FlashVideoApp");
        addChild(vid); 
     }
  
     function onNCStatus(event:NetStatusEvent):void {
       switch (event.info.code) {
           case "NetConnection.Connect.Success":
               trace("You've connected successfully");
               ns1 = new NetStream(nc);
               ns2 = new NetStream(nc);
               
               ns1.client = new CustomClient();
               ns1.publish("dummy", "live");
    
               ns2.play("dummy");
               ns2.client = new CustomClient();
               vid.attachNetStream(ns2);
               setTimeout(sendHello, 3000);
               break;
              
           case "NetStream.Publish.BadName":
               trace("Please check the name of the publishing stream" );
               break;
        }   
     }

     function sendHello():void {
         ns1.send("myFunction", "hello");
     }       
   }
 }
 
 class CustomClient {
    public function myFunction(event:String):void {
       trace(event);
    }
 }

private function netStatusHandler(event:NetStatusEvent):void {
     switch (event.info.code) {  
        case "NetStream.Publish.Start":
            var metaData:Object = new Object();
            metaData.title = "myStream";
            metaData.width = 400;
            metaData.height = 200;
            ns.send("@setDataFrame", "onMetaData", metaData);
            ns.attachCamera( Camera.getCamera() );
            ns.attachAudio( Microphone.getMicrophone() );        
    }
}

public function onMetaData(info:Object):void {
    trace("width: " + info.width);
    trace("height: " + info.height);
 }

// Create a NetStream for playing
 var my_ns:NetStream = new NetStream(my_nc);
 my_video.attachNetStream(my_ns);
 
 // Play the stream record1
 my_ns.play("record1", 0, -1, true);
 
 // Switch to the stream live1 and play for 5 seconds.  
 // Since reset is false, live1 will start to play after record1 is done.
 my_ns.play("live1", -1 , 5, false);

//To play at normal speed
 var my_ns:NetStream = new NetStream(my_nc);
 my_ns.play("log", 0, -1);
 
 //To get the data messages all at once
 my_ns.play("log", 0, -1, 3);

Définit les informations d'authentification de la gestion des droits numériques nécessaires à l'affichage du contenu chiffré sous-jacent.

La méthode setDRMAuthenticationCredentials() doit fournir des informations d'identification qui correspondent à celles reconnues et approuvées par le fournisseur de contenu ou le serveur proxy. Ces informations d'identification sont les mêmes que celles dont l'utilisateur a besoin pour obtenir l'autorisation d'afficher le contenu.

Paramètres

Voir aussi

Interrompt ou reprend la lecture d'un flux continu. Lorsque vous appelez cette méthode pour la première fois, la lecture est interrompue ; au prochain appel, la lecture reprend. Vous pouvez par exemple utiliser cette méthode pour permettre aux utilisateurs d'interrompre ou de reprendre la lecture par pression d'un seul bouton.

Voir aussi

Distribué lorsqu'une erreur est renvoyée de manière asynchrone ; autrement dit, lorsqu'elle provient du code asynchrone natif. Cet événement est distribué lorsqu'un serveur appelle une méthode non définie sur le client.

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

Voir aussi

Distribué lorsqu'un objet NetStream tente de lire un fichier chiffré à l'aide de la gestion des droits numériques (DRM) nécessitant l'obtention d'informations d'identification pour authentifier l'utilisateur avant la lecture.

Utilisez la méthode setDRMAuthenticationCredentials() de l'objet NetStream pour authentifier l'utilisateur. Si l'authentification de l'utilisateur échoue, l'application relance l'authentification et distribue un nouvel événement DRMAuthenticateEvent pour l'objet NetStream.

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

Voir aussi

Distribué lorsqu'un objet NetStream qui tente de lire un fichier chiffré à l'aide de la gestion des droits numériques (DRM) rencontre une erreur de type DRM. Par exemple, un objet DRMErrorEvent est distribué lorsque l'autorisation utilisateur échoue. Il est en effet possible que l'utilisateur n'ait pas acquis les droits nécessaires à l'affichage du contenu ou que le fournisseur de contenu ne prenne pas en charge l'application d'affichage.

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

Voir aussi

Distribué lorsque la lecture du contenu chiffré à l'aide de la gestion des droits numériques (DRM) commence, c'est-à-dire lorsque l'utilisateur est authentifié et autorisé à lire le contenu.

L'objet DRMStatusEvent contient des informations concernant le bon : possibilité d'accéder au contenu hors connexion, date d'expiration du bon ou fin d'affichage du contenu, entre autres.

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

Voir aussi

Distribué lorsqu'il se produit une erreur d'entrée ou de sortie entraînant l'échec d'une opération réseau.

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

Distribué lorsqu'un objet NetStream publie son état ou signale une erreur. L'événement netStatus renferme une propriété info composée d'un objet d'informations contenant des informations spécifiques sur l'événement, telles que la réussite ou l'échec d'une tentative de connexion.

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

Voir aussi

Etablit un écouteur pour qu'il réponde lorsqu'un point de repère intégré est atteint pendant la lecture d'un fichier vidéo. Vous pouvez utiliser l'écouteur pour déclencher des actions dans votre code lorsque le fichier vidéo atteint un point de repère spécifique. Ceci vous permet de synchroniser d'autres actions dans votre application avec les événements de lecture vidéo. Pour plus d'informations sur les formats des fichiers vidéo pris en charge par Flash Media Server, consultez la documentation Flash Media Server.

onCuePoint est en fait une propriété de l'objet NetStream.client. Ce n'est pas un événement, mais il est listé dans la section Events car il répond à un événement de données, soit lorsqu'il diffuse avec Flash Media Server, soit lors de la lecture d'un fichier FLV. Pour plus d'informations, consultez la description de la classe NetStream. Vous ne pouvez pas utiliser la méthode addEventListener(), ni toute autre méthode EventDispatcher pour écouter ou traiter onCuePoint comme un événement. Vous devez en revanche définir une fonction de rappel unique et l'associer directement à l'un des objets suivants :

• Objet auquel fait référence la propriété client d'une occurrence de NetStream.
• Occurrence d'une sous-classe de NetStream. NetStream est une classe scellée, ce qui signifie qu'il est impossible d'ajouter des propriétés ou des méthodes à un objet NetStream à l'exécution. Vous pouvez cependant créer une sous-classe de NetStream et définir votre gestionnaire d'événements dans la sous-classe ou faire de celle-ci une sous-classe dynamique et ajouter la fonction de gestionnaire d'événement à une de ses occurrences.

L'écouteur d'événement associé est déclenché après un appel de la méthode NetStream.play(), mais avant que la tête de lecture vidéo n'ait avancé.

Il est possible d'imbriquer les types de point de repère suivants dans un fichier vidéo :

• Un point de repère de navigation spécifie, au sein du fichier vidéo, une image-clé à laquelle correspond la propriété time du point de repère. Les points de repère de navigation sont souvent utilisés comme signets ou points d'entrée pour permettre aux utilisateurs de parcourir le fichier vidéo.
• Un point de repère d'événement est spécifié par un minutage, que celui-ci corresponde ou non à une image-clé spécifique. Un point de repère d'événement représente généralement dans le fichier vidéo un minutage auquel il se produit un événement qui pourrait être utilisé pour déclencher d'autres événements d'application.

L'objet événement onCuePoint possède les propriétés suivantes :

Vous pouvez définir des points de repère dans un fichier vidéo lorsque vous encodez initialement celui-ci ou lorsque vous importez un clip vidéo dans l'outil de programmation de Flash à l'aide de l'assistant d'importation vidéo.

L'événement onMetaData extrait également des informations sur les points de repère d'un fichier vidéo. Toutefois, l'événement onMetaData extrait des informations sur tous les points de repère avant le début de la lecture du fichier. L'événement onCuePoint extrait des informations sur un seul point de repère, au minutage spécifié pour ce point au cours de la lecture.

En règle générale, pour que votre code réagisse à un certain point de repère au moment où il se produit, utilisez l'événement onCuePoint pour déclencher une action dans votre code.

Vous pouvez utiliser la liste de points de repère fournie à l'événement onMetaData pour permettre à l'utilisateur de commencer à lire la vidéo à des points prédéfinis du flux vidéo. Transmettez la valeur de la propriété time du point de repère à la méthode NetStream.seek() pour lire la vidéo à partir de ce dernier.

Voir aussi

Etablit un écouteur pour répondre lorsque AIR extrait les métadonnées de contenu DRM intégrées dans un fichier multimédia.

Un objet DRMContentData contient les informations nécessaires à l'obtention du voucher requis pour lire un fichier multimédia protégé par DRM. Utilisez la classe DRMManager pour télécharger le voucher avec ces informations.

onDRMContentData est en fait une propriété de l'objet NetStream.client. Bien qu'elle ne soit pas un événement, elle est répertoriée dans la section Events, car elle correspond à un événement data lors du préchargement des données intégrées depuis un fichier multimédia local. Pour plus d'informations, consultez la description de la classe NetStream. Vous ne pouvez pas utiliser la méthode addEventListener(), ni toute autre méthode EventDispatcher pour écouter ou traiter onDRMContentData comme un événement. Vous devez en revanche définir une fonction de rappel unique et l'associer directement à l'un des objets suivants :

• Objet auquel fait référence la propriété client d'une occurrence de NetStream.
• Occurrence d'une sous-classe de NetStream. NetStream est une classe scellée, ce qui signifie qu'il est impossible d'ajouter des propriétés ou des méthodes à un objet NetStream à l'exécution. Vous pouvez cependant créer une sous-classe de NetStream et définir votre gestionnaire d'événements dans la sous-classe ou faire de celle-ci une sous-classe dynamique et ajouter la fonction de gestionnaire d'événement à une de ses occurrences.

Voir aussi

Etablit un écouteur pour qu'il réponde lorsque Flash Player reçoit des données d'images sous forme de tableau d'octets intégré dans un fichier multimédia en cours de lecture. Les données d'image peuvent produire du contenu JPEG, PNG ou GIF. Utilisez la méthode flash.display.Loader.loadBytes() pour charger le tableau d'octets dans un objet d'affichage.

onImageData est en fait une propriété de l'objet NetStream.client. Ce n'est pas un événement, mais il est listé dans la section Events car il répond à un événement de données, soit lorsqu'il diffuse avec Flash Media Server, soit lors de la lecture d'un fichier FLV. Pour plus d'informations, consultez la description de la classe NetStream. Vous ne pouvez pas utiliser la méthode addEventListener(), ni toute autre méthode EventDispatcher pour écouter ou traiter onImageData comme un événement. Vous devez en revanche définir une fonction de rappel unique et l'associer directement à l'un des objets suivants :

• Objet auquel fait référence la propriété client d'une occurrence de NetStream.
• Occurrence d'une sous-classe de NetStream. NetStream est une classe scellée, ce qui signifie qu'il est impossible d'ajouter des propriétés ou des méthodes à un objet NetStream à l'exécution. Vous pouvez cependant créer une sous-classe de NetStream et définir votre gestionnaire d'événements dans la sous-classe ou faire de celle-ci une sous-classe dynamique et ajouter la fonction de gestionnaire d'événement à une de ses occurrences.

L'écouteur d'événement associé est déclenché après un appel de la méthode NetStream.play(), mais avant que la tête de lecture vidéo n'ait avancé.

L'objet d'événement onImageData contient les données d'images sous la forme d'un tableau d'octets envoyé par l'intermédiaire d'un canal de données AMF0.

package {
    import flash.display.*;
    import flash.net.*;
    import flash.media.*;
    import flash.system.*;
    import flash.events.*;

        public class OnTextDataExample extends Sprite {
                                              
            public function OnTextDataExample():void {

                var customClient:Object = new Object();
                customClient.onImageData = onImageDataHandler;           
                customClient.onTextData = onTextDataHandler;               

                var my_nc:NetConnection = new NetConnection();
                my_nc.connect(null);
                var my_ns:NetStream = new NetStream(my_nc);
                my_ns.play("yourURL");
                my_ns.client = customClient;

                var my_video:Video = new Video();
                my_video.attachNetStream(my_ns);
                addChild(my_video);

            }

            public function onImageDataHandler(imageData:Object):void {

                trace("imageData length: " + imageData.data.length);
                var imageloader:Loader = new Loader();           
                imageloader.loadBytes(imageData.data); // imageData.data is a ByteArray object.
                addChild(imageloader);
            }

    
            public function onTextDataHandler(textData:Object):void {

                trace("--- textData properties ----");
                var key:String;

                for (key in textData) {
                    trace(key + ": " + textData[key]);
                }
            }

        }

}

Voir aussi

Etablit un écouteur pour qu'il réponde lorsque Flash Player reçoit une description intégrée à la vidéo en cours de lecture. Pour plus d'informations sur les formats des fichiers vidéo pris en charge par Flash Media Server, consultez la documentation Flash Media Server.

onMetaData est en fait une propriété de l'objet NetStream.client. Ce n'est pas un événement, mais il est listé dans la section Events car il répond à un événement de données, soit lorsqu'il diffuse avec Flash Media Server, soit lors de la lecture d'un fichier FLV. Pour plus d'informations, consultez la description de la classe NetStream et de la propriété NetStream.client. Vous ne pouvez pas utiliser la méthode addEventListener(), ni toute autre méthode EventDispatcher, pour écouter ou traiter onMetaData comme un événement. Vous devez en revanche définir une fonction de rappel unique et l'associer directement à l'un des objets suivants :

• Objet auquel fait référence la propriété client d'une occurrence de NetStream.
• Occurrence d'une sous-classe de NetStream. NetStream est une classe scellée, ce qui signifie qu'il est impossible d'ajouter des propriétés ou des méthodes à un objet NetStream à l'exécution. Vous pouvez cependant créer une sous-classe de NetStream et définir votre gestionnaire d'événements dans la sous-classe ou faire de celle-ci une sous-classe dynamique et ajouter la fonction de gestionnaire d'événement à une de ses occurrences.

L'utilitaire Flash Video Exporter (version 1.1 ou supérieure) intègre la durée de la vidéo, sa date de création, les débits et d'autres informations dans le fichier vidéo. Différents encodeurs vidéo intègrent différents jeux de métadonnées.

L'écouteur d'événement associé est déclenché après un appel de la méthode NetStream.play(), mais avant que la tête de lecture vidéo n'ait avancé.

Dans la plupart des cas, la valeur de durée intégrée dans les métadonnées du flux se rapproche de la durée réelle, mais n'est pas exacte. En d'autres termes, elle ne correspond pas toujours à la valeur de la propriété NetStream.time lorsque la tête de lecture est à la fin du flux vidéo.

L'objet événement transmis au gestionnaire d'événement onMetaData contient une propriété pour chaque élément de données.

Voir aussi

Etablit un écouteur pour qu'il réponde lorsque un objet NetStream a terminé la lecture d'un flux. L'objet événement associé fournit des informations autres que ce renvoie l'événement netStatus. Vous pouvez utiliser cette propriété pour déclencher des actions dans votre code lorsqu'un objet NetStream est passé d'un flux continu à un autre dans une liste de lecture (ce qu'indique l'objet d'informations NetStream.Play.Switch) ou lorsque l'objet NetStream a terminé la lecture du flux continu (ce qu'indique l'objet d'informations NetStream.Play.Complete ).

onPlayStaus est en fait une propriété de l'objet NetStream.client. Ce n'est pas un événement, mais il est listé dans la section Events car il répond à un événement de données, soit lorsqu'il diffuse avec Flash Media Server, soit lors de la lecture d'un fichier FLV. Pour plus d'informations, consultez la description de la classe NetStream. Vous ne pouvez pas utiliser la méthode addEventListener(), ni toute autre méthode EventDispatcher pour écouter ou traiter onPlayStatus comme un événement. Vous devez en revanche définir une fonction de rappel unique et l'associer directement à l'un des objets suivants :

• Objet auquel fait référence la propriété client d'une occurrence de NetStream.
• Occurrence d'une sous-classe de NetStream. NetStream est une classe scellée, ce qui signifie qu'il est impossible d'ajouter des propriétés ou des méthodes à un objet NetStream à l'exécution. Vous pouvez cependant créer une sous-classe de NetStream et définir votre gestionnaire d'événements dans la sous-classe ou faire de celle-ci une sous-classe dynamique et ajouter la fonction de gestionnaire d'événement à une de ses occurrences.

Cet événement peut renvoyer un objet d'informations doté des propriétés suivantes :

Voir aussi

Etablit un écouteur pour qu'il réponde lorsque Flash Player reçoit des données texte intégrées dans un fichier multimédia en cours de lecture. Les données texte sont au format UTF-8 et peuvent contenir des informations sur la mise en forme basées sur la spécification Timed Text 3GP.

onTextData est en fait une propriété de l'objet NetStream.client. Ce n'est pas un événement, mais il est listé dans la section Events car il répond à un événement de données, soit lorsqu'il diffuse avec Flash Media Server, soit lors de la lecture d'un fichier FLV. Pour plus d'informations, consultez la description de la classe NetStream. Vous ne pouvez pas utiliser la méthode addEventListener(), ni toute autre méthode EventDispatcher pour écouter ou traiter onTextData comme un événement. Vous devez en revanche définir une fonction de rappel unique et l'associer directement à l'un des objets suivants :

• Objet auquel fait référence la propriété client d'une occurrence de NetStream.
• Occurrence d'une sous-classe de NetStream. NetStream est une classe scellée, ce qui signifie qu'il est impossible d'ajouter des propriétés ou des méthodes à un objet NetStream à l'exécution. Vous pouvez cependant créer une sous-classe de NetStream et définir votre gestionnaire d'événements dans la sous-classe ou faire de celle-ci une sous-classe dynamique et ajouter la fonction de gestionnaire d'événement à une de ses occurrences.

L'écouteur d'événement associé est déclenché après un appel de la méthode NetStream.play(), mais avant que la tête de lecture vidéo n'ait avancé.

L'objet d'événement onTextData contient une propriété pour chaque partie de données texte.

package {
    import flash.display.*;
    import flash.net.*;
    import flash.media.*;
    import flash.system.*;
    import flash.events.*;

        public class OnTextDataExample extends Sprite {
                                              
            public function OnTextDataExample():void {

                var customClient:Object = new Object();
                customClient.onImageData = onImageDataHandler;           
                customClient.onTextData = onTextDataHandler;               

                var my_nc:NetConnection = new NetConnection();
                my_nc.connect(null);
                var my_ns:NetStream = new NetStream(my_nc);
                my_ns.play("yourURL");
                my_ns.client = customClient;

                var my_video:Video = new Video();
                my_video.attachNetStream(my_ns);
                addChild(my_video);

            }

            public function onImageDataHandler(imageData:Object):void {

                trace("imageData length: " + imageData.data.length);
                var imageloader:Loader = new Loader();           
                imageloader.loadBytes(imageData.data); // imageData.data is a ByteArray object.
                addChild(imageloader);
            }

    
            public function onTextDataHandler(textData:Object):void {

                trace("--- textData properties ----");
                var key:String;

                for (key in textData) {
                    trace(key + ": " + textData[key]);
                }
            }

        }

}

Voir aussi

Définit un écouteur pour qu'il réponde lorsque Flash Player reçoit des informations spécifiques à XMP (Extensible Metadata Platform) d'Adobe, intégrées à la vidéo lue. Pour plus d'informations sur les formats des fichiers vidéo pris en charge par Flash Media Server, consultez la documentation Flash Media Server.

onXMPData est en réalité une propriété de l'objet NetStream.client. Ce n'est pas un événement, mais il est listé dans la section Events car il répond à un événement de données, soit lorsqu'il diffuse avec Flash Media Server, soit lors de la lecture d'un fichier FLV. Pour plus d'informations, consultez la description de la classe NetStream et de la propriété NetStream.client. Vous ne pouvez pas utiliser la méthode addEventListener(), ni toute autre méthode EventDispatcher, pour écouter ou traiter onMetaData comme un événement. Vous devez en revanche définir une fonction de rappel unique et l'associer directement à l'un des objets suivants :

• Objet auquel fait référence la propriété client d'une occurrence de NetStream.
• Occurrence d'une sous-classe de NetStream. NetStream est une classe scellée, ce qui signifie qu'il est impossible d'ajouter des propriétés ou des méthodes à un objet NetStream à l'exécution. Vous pouvez cependant créer une sous-classe de NetStream et définir votre gestionnaire d'événements dans la sous-classe ou faire de celle-ci une sous-classe dynamique et ajouter la fonction de gestionnaire d'événement à une de ses occurrences.

L'écouteur d'événement associé est déclenché après un appel de la méthode NetStream.play(), mais avant que la tête de lecture vidéo n'ait avancé.

L'objet transmis à la fonction de gestion d'événement onXMPData() a une propriété data, qui correspond à une chaîne. La chaîne est générée à partir d'un champ UUID de premier niveau. (L'UUID 128 bits du champ de premier niveau est BE7ACFCB-97A9-42E8-9C71-999491E3AFAC.) Ce champ UUID de premier niveau contient un document XML représenté sous forme de chaîne UTF-8 terminée par un octet nul.

Voir aussi

Distribué lorsque l'application tente de lire un fichier chiffré à l'aide de la gestion des droits numériques (DRM) en appelant la méthode NetStream.play(). La valeur de la propriété du code d'état est la suivante : « DRM.encryptedFLV ».

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

Voir aussi

Objet statique utilisé comme paramètre pour le constructeur d'une occurrence de NetStream. Il s'agit de la valeur par défaut du second paramètre du constructeur NetStream ; il n'est pas utilisé par l'application pour la lecture progressive. Lorsqu'il est utilisé, ce paramètre oblige le constructeur à se connecter à une occurrence de Flash Media Server.

Crée une connexion d'éditeur homologue à homologue. Transmet cette chaîne pour le deuxième paramètre (facultatif) au constructeur d'une occurrence de NetStream. Avec cette chaîne, une application peut créer une connexion NetStream dans le but de publier du contenu audio et vidéo vers des clients.

Dans cet exemple, le code qui crée les objets Video et NetStream et appelle les méthodes Video.attachNetStream() et NetStream.play() est placé dans une fonction de gestionnaire. Le gestionnaire n'est appelé que si la tentative de connexion à l'objet NetConnection a réussi ; c'est-à-dire lorsque l'événement netStatus renvoie un objet info avec une propriété code qui indique la réussite de l'opération. Il est recommandé d'attendre l'établissement d'une connexion avant d'appeler la méthode NetStream.play().

package {
    import flash.display.Sprite;
    import flash.events.NetStatusEvent;
    import flash.events.SecurityErrorEvent;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.events.Event;

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

        public function NetConnectionExample() {
            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("Stream not found: " + videoURL);
                    break;
            }
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

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

class CustomClient {
    public function onMetaData(info:Object):void {
        trace("metadata: duration=" + info.duration + " width=" + info.width + " height=" + info.height + " framerate=" + info.framerate);
    }
    public function onCuePoint(info:Object):void {
        trace("cuepoint: time=" + info.time + " name=" + info.name + " type=" + info.type);
    }
}