Indique l’objet sur lequel appeler des méthodes de rappel. 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 Flash Player est connecté (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 de proxy utilisé pour réussir à appeler NetConnection.connect() pour Flash Media Server : "none", "HTTP", "HTTPS" ou "CONNECT". La valeur est "none" si la connexion ne passe pas par un tunnel, "HTTP" si la connexion passe par un tunnel via HTTP, "HTTPS" si la connexion passe par un tunnel via HTTPS et "CONNECT" si la connexion passe par un tunnel via la méthode HTTP CONNECT.

Encodage d’objet par défaut des objets NetConnection créés dans le fichier SWF. 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 le codage d’un objet séparément (plutôt que de définir le codage de tous les objets du fichier SWF), réglez la propriété objectEncoding de l’objet NetConnection.

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

Voir aussi

Encodage de l'objet de cette occurrence de NetConnection.

Lorsqu'un objet est écrit ou lu à partir de données binaires, la propriété objectEncoding indique la version 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 fichier SWF ActionScript 3.0 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 de NetConnection créées dans ce fichier SWF utilisent la sérialisation AMF3 et il est inutile d’indiquer à Flash Player quel encodage AMF utiliser.
• 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, Flash Player 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.

Voir aussi

Détermine les méthodes de secours à utiliser lorsque la première tentative de connexion au serveur échoue. Vous devez définir la propriété proxyType avant d’appeler la méthode NetConnection.connect().

Les valeurs acceptables sont "none", "HTTP", "CONNECT" et "best".

Dans Flash Player 9, la valeur par défaut de cette propriété est none. Si vous ne modifiez pas cette valeur, Flash Player utilise le tunnelage HTTPS pour RTMPS. Si la propriété est définie sur "best", le client tente de se connecter via SSL natif. Si la connexion échoue, d'autres méthodes de connexion sont essayées. 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 réglée 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.

Remarque :dans Flash Player 9, cette propriété est applicable uniquement lors de l'utilisation de RTMP, RTMPS ou RTMPT. La méthode CONNECT est réservée aux utilisateurs qui sont connectés au réseau par un serveur proxy.

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 connect() pour établir une connexion.

Si le fichier SWF doit communiquer avec des serveurs sortis avant Flash Player 9, vous devrez peut-être définir la propriété objectEncoding de l’objet NetConnection.

Voir aussi

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

Invoque 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.

Paramètres

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, consultez le Guide de configuration et d'administration de Flash Media Server.

Voir aussi

Crée une connexion bidirectionnelle entre Flash Player et une application Flash Media Server. Un objet NetConnection est similaire à un canal entre le client et le serveur. Utilisez des objets NetStream pour envoyer des flux à travers ce canal. Pour plus d'informations sur les codecs et les formats de fichier pris en charge par Flash Media Server, consultez la Documentation de Flash Media Server.

Sans Flash Media Server, appelez NetConnection pour lire des fichiers vidéo et MP3 depuis un système de fichiers local ou un serveur Web. Pour plus d'informations sur les codecs et les formats de fichier pris en charge, consultez http://www.adobe.com/go/hardware_scaling_fr.

Crée une connexion bidirectionnelle entre Flash Player et un serveur d'application exécutant le service 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, consultez la Documentation de Flash Remoting.

Lorsque vous utilisez cette méthode, tenez compte du modèle de sécurité de Flash Player et des considérations de sécurité suivantes :

• Par défaut, Flash Player 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 interdomaines.
• Votre application peut refuser l'accès à une ressource du serveur. Dans une application Flash Media Server, vous devez ajouter du code côté serveur pour refuser l'accès. Pour plus d'informations, consultez la documentation de Flash Media Server.
• Vous ne pouvez pas utiliser NetConnection.connect() si le fichier SWF appelant se trouve dans le sandbox local avec système de fichiers.
• Vous pouvez éviter qu'un fichier SWF n'utilise cette méthode en définissant le paramètre allowNetworking des balises object et embed dans la page HTML qui héberge le contenu SWF.

Pour plus d'informations, consultez les références suivantes :

• Le chapitre relatif à la sécurité du manuel Programmation d'ActionScript 3.0 et les derniers commentaires disponibles dans LiveDocs
• Le Livre blanc sur la sécurité de Flash Player 9

Paramètres

Voir aussi

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 :

Voir aussi

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

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

Voir aussi

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 {
            stream = 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);
    }
}