NetConnection  - AS3

Indique l’objet sur lequel des méthodes de rappel sont appelées. La valeur par défaut correspond à cette occurrence de NetConnection. Si vous réglez la propriété client sur un autre objet, les méthodes de rappels seront appelées sur celui-ci.

Indique si l’application est connectée (true) ou non (false) à un serveur par le biais d’une connexion RTMP continue. Lorsqu’il est connecté via HTTP, cette propriété est false, sauf dans le cas d’une connexion aux services Flash Remoting sur un serveur d’application, auquel cas la propriété est true.

Type proxy utilisé pour établir une connexion à Flash Media Server. Les valeurs possibles sont les suivantes : "none", "HTTP", "HTTPS" et "CONNECT".

La valeur est "none" si la connexion n’est pas établie par tunnel ou s’il s’agit d’une connexion SSL native.

La valeur est "HTTP" si la connexion est établie par tunnel via HTTP.

La valeur est "HTTPS" si la connexion est établie par tunnel via HTTPS.

La valeur est "CONNECT" si la connexion est établie par tunnel à l’aide de la méthode CONNECT via un serveur proxy.

L’encodage d’objet par défaut des objets NetConnection. Lorsqu’un objet est écrit ou lu à partir de données binaires, la propriété objectEncoding indique la version AMF (Action Message Format) utilisée pour sérialiser les données : le format ActionScript 3.0 ( ObjectEncoding.AMF3 ) ou le format ActionScript 1.0 et ActionScript 2.0 ( ObjectEncoding.AMF0).

La valeur par défaut est ObjectEncoding.AMF3. La modification de NetConnection.defaultObjectEncoding n’a aucune incidence sur les occurrences existantes de NetConnection. Elle affecte uniquement les occurrences créées ultérieurement.

Pour définir l’encodage d’un objet séparément (plutôt que de définir l’encodage de tous les objets de l’application), réglez la propriété objectEncoding de l’objet NetConnection.

Pour plus d’informations, voir la description de la propriété objectEncoding.

Eléments de l’API associés

Identifiant de l’occurrence de Flash Media Server à laquelle cette occurrence de Flash Player ou Adobe AIR est connectée. Cette propriété est significative uniquement pour les connexions RTMFP. La valeur de cette propriété est disponible uniquement après l’établissement d’une connexion RTMFP.

Eléments de l’API associés

Valeur choisie par Flash Media Server, unique pour cette connexion. Cette valeur apparaît pour le serveur comme sa valeur client.nearNonce. Cette valeur est définie uniquement pour les connexions RTMFP, RTMPE et RTMPTE.

Délai d’attente, en millisecondes, d’une réponse HTTP. La valeur par défaut est zéro.

• La valeur httpIdleTimeout est Number.
• Lorsque vous utilisez une connexion HTTP, une valeur positive indique le nombre de millisecondes pendant lequel une connexion inactive doit rester ouverte.
• Une valeur de zéro indique qu’il est nécessaire d’utiliser la valeur d’inactivité de mise en réseau par défaut correspondant à la plate-forme.
• Une valeur négative déclenche une erreur RangeError.
• Si la valeur httpIdleTimeout est dépassée, un événement netStatus est distribué.
• Cette propriété affecte uniquement les objets NetConnection créés avec des connexions HTTP. Les objets NetConnection créés avec RTMP, RTMFP ou d’autres canaux HTTP ne sont pas affectés par cette propriété.

    //Set the timeout to 5 seconds
    connection = new NetConnection();
    connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
    connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
    connection.httpIdleTimeout = 5000;
    

Nombre total de connexions d’homologue entrantes et sortantes que cette occurrence de Flash Player ou Adobe AIR autorise. La valeur par défaut est 8.

Cette valeur ne fait pas la distinction entre les connexions d’éditeurs et d’abonnés. Si cette valeur est réduite alors que des connexions d’homologue sont en cours, la nouvelle valeur n’affecte que les nouvelles connexions entrantes. Les connexions existantes ne sont pas abandonnées.

Identifiant de cette occurrence de Flash Player ou Adobe AIR pour cette occurrence de NetConnection. Cette propriété est significative uniquement pour les connexions RTMFP.

Chaque occurrence de NetConnection possède une propriété nearID unique. Aucune occurrence de Flash Player, Adobe AIR ou NetConnection n’a le même identifiant.

Les autres occurrences Flash Player ou Adobe AIR utilisent cet identifiant comme peerID pour les nouvelles connexions NetStream à ce client. Par la suite, cet identifiant est le farID dans toutes les occurrences NetStream d’homologue qui se connectent à cette occurrence.

Eléments de l’API associés

Valeur choisie par cette occurrence de Flash Player ou Adobe AIR, unique pour cette connexion. Cette valeur apparaît pour le serveur comme sa valeur client.farNonce. Cette valeur est définie uniquement pour les connexions RTMFP, RTMPE et RTMPTE.

Encodage de l’objet de cette occurrence de NetConnection.

Lors de l’écriture ou de la lecture d’un objet à partir de données binaires, la propriété objectEncoding indique la version AMF (Action Message Format) utilisée pour sérialiser les données : le format ActionScript 3.0 (ObjectEncoding.AMF3) ou le format ActionScript 1.0 et ActionScript 2.0 (ObjectEncoding.AMF0). Définissez la propriété objectEncoding pour choisir une version AMF pour une occurrence de NetConnection.

Il est important de comprendre cette propriété si votre application doit communiquer avec des serveurs antérieurs à Flash Player 9. Les trois scénarios suivants sont possibles :

• Connexion à un serveur prenant en charge AMF3 (par exemple, Flex Data Services 2 ou Flash Media Server 3). La valeur par défaut de defaultObjectEncoding est ObjectEncoding.AMF3. Toutes les occurrences NetConnection créées dans ce fichier utilisent la sérialisation AMF3, afin que vous n’ayez pas à définir la propriété objectEncoding.
• Connexion à un serveur ne prenant pas en charge AMF3 (par exemple, Flash Media Server 2). Dans ce cas, réglez la propriété statique NetConnection.defaultObjectEncoding sur ObjectEncoding.AMF0. Toutes les occurrences de NetConnection créées dans ce fichier SWF utilisent la sérialisation AMF0. Il est inutile de définir la propriété objectEncoding.
• Vous vous connectez à plusieurs serveurs utilisant des versions d’encodage différentes. Au lieu d’utiliser defaultObjectEncoding, réglez l’encodage d’objet connexion par connexion en utilisant pour chacune d’elles la propriété objectEncoding. Réglez la propriété sur ObjectEncoding.AMF0 pour vous connecter aux serveurs qui utilisent l’encodage AMF0, tels que et Flash Media Server 2, et sur ObjectEncoding.AMF3 pour vous connecter aux serveurs qui utilisent l’encodage AMF3, tels que Flex Data Services 2.

Une fois l’occurrence de NetConnection connectée, sa propriété objectEncoding est en lecture seule.

Si vous ne spécifiez pas l’encodage approprié pour vous connecter à un serveur, l’objet NetConnection distribue l’événement netStatus. La propriété NetStatusEvent.info contient un objet d’informations dont la propriété code est réglée sur NetConnection.Connect.Failed, ainsi qu’une description expliquant que le codage d’objet est incorrect.

Eléments de l’API associés

Protocole utilisé pour établir la connexion Cette propriété est pertinente lorsque Flash Media Server est utilisé. Les valeurs possibles sont les suivantes :

• "rtmp" : RTMP (Real-Time Messaging Protocol)
• "rtmpe" : RTMP chiffré
• "rtmpt" : RTMP par tunnelage HTTP
• "rtmpte" : RTMP chiffré par tunnelage HTTP
• "rtmps" : RTMP de type HTTPS
• "rtmfp" : RTMFP (Real-Time Media Flow Protocol)

Détermine les méthodes de secours à utiliser lorsque la connexion initiale à Flash Media Server échoue. Définissez la propriété proxyType avant d’appeler la méthode NetConnection.connect().

Les valeurs acceptables sont "none", "HTTP", "CONNECTOnly", "CONNECT" et "best". La valeur par défaut est "none".

Pour utiliser une connexion SSL native, définissez cette propriété sur "best". Si le lecteur ne parvient pas à établir une connexion directe au serveur (via le port par défaut 443 ou un autre port que vous spécifiez) et si un serveur proxy est en place, le lecteur tente d’utiliser la méthode CONNECT. Si cette tentative échoue, le lecteur établit un tunnel via HTTPS.

Si la propriété est définie sur "CONNECTOnly", le lecteur essaye d’abord d’utiliser la méthode CONNECT. En cas d’échec, il n’y a pas d’alternative.

Si la propriété est définie sur "HTTP" et qu’une connexion directe échoue, le tunnelage HTTP est utilisé. Si la propriété est définie sur "CONNECT" et qu’une connexion directe échoue, la méthode de tunnelage CONNECT est utilisée. En cas d’échec, la connexion n’utilise pas le tunnelage HTTP.

Cette propriété est applicable uniquement lors de l’utilisation de RTMP, RTMPS ou RTMPT. Les méthodes CONNECT et CONNECTOnly ne sont applicables qu’aux utilisateurs connectés au réseau par l’intermédiaire d’un serveur proxy.

Objet qui contient tous les objets NetStream d’homologues abonnés non associés aux objets NetStream de publication. Les objets NetStream abonnés associés à des objets NetStream de publication se trouvent dans le tableau NetStream.peerStreams.

Eléments de l’API associés

URI transmise à la méthode NetConnection.connect(). Si NetConnection.connect() n’a pas été appelée ou si aucune URI n’a été transmise, cette propriété est undefined.

Indique si une connexion sécurisée a été établie via le protocole TLS (Transport Layer Security) natif plutôt que HTTPS. Cette propriété n’est valide que si un objet NetConnection est connecté.

Crée un objet NetConnection. Appelez la méthode connect() pour établir une connexion.

Si une application doit communiquer avec des serveurs antérieurs à Flash Player 9, définissez la propriété objectEncoding de l’objet NetConnection.

Le code suivant crée un objet NetConnection.

     var nc:NetConnection = new NetConnection();
     

Eléments de l’API associés

Ajoute un en-tête de contexte à la structure du paquet AMF (Action Message Format). Par la suite, cet en-tête est envoyé avec chaque paquet AMF. Si vous appelez NetConnection.addHeader() en utilisant le même nom, le nouvel en-tête remplace l’en-tête existant et subsiste pendant toute la durée de l’objet NetConnection. Vous pouvez supprimer un en-tête en appelant NetConnection.addHeader() avec le nom de l’en-tête pour supprimer un objet non défini.

Paramètres

Appelle une commande ou une méthode sur Flash Media Server ou sur un serveur d’application exécutant Flash Remoting. Avant d’appeler NetConnection.call(), vous devez appeler NetConnection.connect() pour vous connecter au serveur. Vous devez créer une fonction côté serveur à transmettre à cette méthode.

Vous ne pouvez pas vous connecter aux ports généralement réservés. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.

Paramètres

Eléments de l’API associés

Ferme la connexion ouverte localement ou au serveur et distribue un événement netStatus en réglant la propriété code sur NetConnection.Connect.Closed.

Cette méthode déconnecte tous les objets NetStream qui s’exécutent sur la connexion. Toutes les données en attente qui n’ont pas encore été envoyées sont abandonnées (pour clore les flux locaux ou de serveur sans fermer la connexion, utilisez NetStream.close()). Si vous fermez la connexion et que vous souhaitez ensuite en créer une nouvelle, vous devez créer un nouvel objet NetConnection et rappeler la méthode connect().

La méthode close déconnecte également tous les objets partagés distants qui s’exécutent sur la connexion. Vous n’avez toutefois pas besoin de recréer l’objet partagé pour vous reconnecter. Pour rétablir la connexion à l’objet partagé, il vous suffit en effet d’appeler la méthode SharedObject.connect(). Par ailleurs, les données de l’objet partagé qui étaient en file d’attente lorsque vous avez émis NetConnection.close() sont envoyées après la reconnexion à l’objet.

Avec Flash Media Server, la meilleure pratique de développement consiste à appeler close() lorsque le client n’a plus besoin de la connexion au serveur. L’appel à close() est le moyen le plus rapide pour nettoyer les connexions non utilisées. Vous pouvez configurer le serveur pour qu’il ferme automatiquement les connexions inactives comme mesure de sauvegarde. Pour plus d’informations, voir le Guide d’administration et de configuration de Flash Media Server.

Eléments de l’API associés

Crée une connexion bidirectionnelle à une application sur Flash Media Server ou sur Flash Remoting, ou crée un point de terminaison de réseau bidirectionnel pour la communication de groupe homologue à homologue RTMFP. Pour signaler son état ou une condition d’erreur, un appel de la méthode NetConnection.connect() distribue un événement netStatus.

Appelez NetConnection.connect() pour effectuer les opérations suivantes :

• Transmettez "null" pour lire les fichiers vidéo et mp3 à partir d’un système de fichiers local ou d’un serveur Web.
• Transmettez une URL "http" pour vous connecter à un serveur d’application exécutant Flash Remoting. Utilisez la classe NetServices pour appeler des fonctions et renvoyer les résultats des serveurs d’application via un objet NetConnection. Pour plus d’informations, voir la documentation de Flash Remoting.
• Transmettez une URL "rtmp/e/s" pour vous connecter à une application de Flash Media Server.
• Transmettez une URL "rtmfp" pour créer un point de terminaison de réseau bidirectionnel en vue d’établir une communication RTMFP client-serveur, homologue à homologue et en multidiffusion IP.
• Transmettez la chaîne "rtmfp:" pour créer un point de terminaison bidirectionnel sans réseau pour la communication en multidiffusion IP RTMFP.

Tenez compte du modèle de sécurité suivant :

• Par défaut, Flash Player ou AIR refuse l’accès entre les sandbox. Un site Web peut autoriser l’accès à une ressource à l’aide d’un fichier de régulation d’URL.
• Votre application peut refuser l’accès à une ressource du serveur. Dans une application Flash Media Server, utilisez le code ActionScript côté serveur pour refuser l’accès. Voir la documentation de Flash Media Server.
• Vous ne pouvez pas appeler NetConnection.connect() si le fichier appelant se trouve dans le sandbox local avec système de fichiers.
• Vous ne pouvez pas vous connecter aux ports généralement réservés. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.
• Pour éviter qu’un fichier SWF n’appelle cette méthode, définissez le paramètre allowNetworking des balises object et embed dans la page HTML qui héberge le contenu SWF.

Néanmoins, dans Adobe AIR, le contenu du sandbox de sécurité application (contenu installé avec l’application AIR) n’est pas soumis à ces restrictions de sécurité.

Pour plus d’informations concernant la sécurité, voir la rubrique Sécurité du Pôle de développement Flash Player (disponible en anglais uniquement).

Paramètres

Eléments de l’API associés

Distribué lorsqu’une erreur est renvoyée de manière asynchrone ; autrement dit, lorsqu’elle provient du code asynchrone natif.

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

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 NetConnection 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 :

Eléments de l’API associés

Distribué si un appel de NetConnection.call() tente d’établir une connexion à un serveur situé hors du sandbox de sécurité de l’appelant.

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

Eléments de l’API associés

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 = "http://www.helpexamples.com/flash/video/cuepoints.flv";
        private var connection:NetConnection;
        private var stream:NetStream;
        private var video:Video = new Video();        

        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 {
            addChild(video);
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            video.attachNetStream(stream);
            stream.play(videoURL);
        }
    }
}

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