NetConnection  - AS3

Gibt das Objekt an, bei dem Callback-Methoden aufgerufen werden. Standardeinstellung ist diese NetConnection-Instanz. Wenn Sie die client-Eigenschaft auf ein anderes Objekt einstellen, werden die Callback-Methoden bei dem eingestellten Objekt aufgerufen.

Gibt an, ob die Anwendung über eine permanente RTMP-Verbindung mit einem Server verbunden ist (true) oder nicht (false). Bei einer Verbindung mit HTTP hat diese Eigenschaft den Wert false, es sei denn, die Verbindung besteht zu Flash Remoting-Diensten auf einem Anwendungsserver, in welchem Fall der Wert true ist.

Der Proxytyp, der verwendet wird, um eine erfolgreiche Verbindung zu Flash Media Server herzustellen. Mögliche Werte sind: "none", "HTTP", "HTTPS" oder "CONNECT".

Der Wert ist "none", wenn die Verbindung nicht getunnelt ist oder es sich um eine native SSL-Verbindung handelt.

Der Wert ist "HTTP", wenn die Verbindung über HTTP getunnelt wird.

Der Wert ist "HTTPS", wenn die Verbindung über HTTPS getunnelt wird.

Der Wert ist "CONNECT", wenn die Verbindung mithilfe der CONNECT-Methode über einen Proxyserver getunnelt wird.

Die Standard-Objektkodierung für NetConnection-Objekte. Wenn ein Objekt in Binärdaten geschrieben oder aus Binärdaten gelesen wird, gibt die Eigenschaft defaultObjectEncoding an, welche Action Message Format (AMF)-Version für die Serialisierung der Daten verwendet wird: ActionScript 3.0 (ObjectEncoding.AMF3) oder ActionScript 1.0 und ActionScript 2.0 (ObjectEncoding.AMF0).

Der Standardwert ist ObjectEncoding.AMF3. Eine Änderung der Einstellung für NetConnection.defaultObjectEncoding wirkt sich nicht auf bereits vorhandene NetConnection-Instanzen, sondern nur auf nach der Änderung erstellte Instanzen aus.

Um die Objektkodierungen separat einzustellen (anstatt einer Objektkodierung für die gesamte Anwendung), verwenden Sie hingegen die Eigenschaft objectEncoding des NetConnection-Objekts.

Nähere Informationen finden Sie in der Beschreibung der Eigenschaft objectEncoding.

Verwandte API-Elemente

Der Bezeichner der Flash Media Server-Instanz, mit dem diese Flash Player- oder Adobe AIR-Instanz verbunden ist. Diese Eigenschaft ist nur für RTMFP-Verbindungen von Bedeutung. Der Wert dieser Eigenschaft ist nur verfügbar, nachdem eine RTMFP-Verbindung hergestellt wurde.

Verwandte API-Elemente

Ein Wert, der vom Flash Media Server ausgewählt wird und für diese Verbindung eindeutig ist. Dieser Wert erscheint für den Server als client.nearNonce-Wert. Dieser Wert wird nur für RTMFP-, RTMPE- und RTMPTE-Verbindungen definiert.

Die Zeit in Millisekunden, die auf eine HTTP-Antwort gewartet wird. Der Standardwert ist 0.

• Der httpIdleTimeout-Wert ist vom Typ Number.
• Bei Verwendung einer HTTP-Verbindung zeigt ein positiver Wert die Anzahl der Millisekunden an, für die eine inaktive Verbindung geöffnet bleiben soll.
• Der Wert 0 zeigt an, dass der Netzwerkstandardwert für die Zeitüberschreitung für die Plattform verwendet werden soll.
• Ein negativer Wert führt zu einem RangeError.
• Beim Überschreiten des httpIdleTimeout-Werts wird ein netStatus-Ereignis abgesetzt.
• Dieses Eigenschaft betrifft nur NetConnection-Objekte, die mit HTTP-Verbindungen erstellt wurden. Auf NetConnection-Objekte, die mit RTMP, RTMFP oder anderen HTTP-Kanälen erstellt wurden, hat diese Eigenschaft keine Auswirkungen.

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

Die Anzahl der eingehenden und ausgehenden Peer-Verbindungen, die diese Instanz von Flash Player oder Adobe AIR zulässt. Der Standardwert ist 8.

Dieser Wert unterscheidet nicht zwischen Herausgeber- und Abonnenten-Verbindungen. Wenn dieser Wert verringert wird, während Peer-Verbindungen vorhanden sind, wirkt sich der neue Wert nur auf neu eingehende Verbindungen aus. Bestehende Verbindungen werden nicht fallen gelassen.

Die ID dieser Flash Player- oder Adobe AIR-Instanz für diese NetConnection-Instanz. Diese Eigenschaft ist nur für RTMFP-Verbindungen von Bedeutung.

Jede NetConnection-Instanz hat eine eindeutige nearID-Eigenschaft. Keine Flash Player-, Adobe AIR- oder NetConnection-Instanz hat die gleiche ID.

Andere Flash Player- oder Adobe AIR-Instanzen verwenden diese ID als peerID für neue NetStream-Verbindungen für diesen Client. Somit ist diese ID die farID für alle Peer-NetStreams, die eine Verbindung zu dieser Instanz herstellen.

Verwandte API-Elemente

Ein Wert, der von dieser Flash Player- oder Adobe AIR-Instanz ausgewählt wird und für diese Verbindung eindeutig ist. Dieser Wert erscheint für den Server als client.farNonce-Wert. Dieser Wert wird nur für RTMFP-, RTMPE- und RTMPTE-Verbindungen definiert.

Die Objektkodierung für diese NetConnection-Instanz.

Wenn ein Objekt in Binärdaten geschrieben oder aus Binärdaten gelesen wird, gibt die Eigenschaft defaultObjectEncoding an, welche Action Message Format (AMF)-Version für die Serialisierung der Daten verwendet wird: ActionScript 3.0 (ObjectEncoding.AMF3) oder ActionScript 1.0 und ActionScript 2.0 (ObjectEncoding.AMF0). Stellen Sie die objectEncoding-Eigenschaft ein, um eine AMF-Version für eine NetConnection-Instanz festzulegen.

Es ist wichtig, die Funktionsweise dieser Eigenschaft zu verstehen, wenn die Kommunikation der Anwendung mit Servern erforderlich ist, die eine ältere Version als Flash Player 9 aufweisen. Die folgenden drei Szenarios sind möglich:

• Verbindung mit einem Server, der AMF3 unterstützt (zum Beispiel Flex Data Services 2 oder Flash Media Server 3). Der Standardwert für defaultObjectEncoding ist ObjectEncoding.AMF3. Alle in dieser Datei erstellten NetConnection-Instanzen verwenden die AMF3-Serialisierung, deshalb brauchen Sie die objectEncoding-Eigenschaft nicht festzulegen.
• Verbindung mit einem Server, der AMF3 nicht unterstützt (zum Beispiel Flash Media Server 2). Setzen Sie in diesem Fall die statische Eigenschaft NetConnection.defaultObjectEncoding auf ObjectEncoding.AMF0. Für alle in dieser SWF-Datei erstellten NetConnection-Instanzen wird die AMF0-Serialisierung verwendet. Die Eigenschaft objectEncoding muss nicht gesetzt werden.
• Herstellung einer Verbindung zu mehreren Servern mit verschiedenen Kodierungsversionen. Anstatt defaultObjectEncoding zu verwenden, legen Sie die Objektkodierung pro Verbindung fest, indem Sie die Eigenschaft objectEncoding für jede einzelne Verbindung verwenden. Setzen Sie die Eigenschaft für die Verbindung mit Servern, die AMF0-Kodierung verwenden (z. B. Flash Media Server 2), auf ObjectEncoding.AMF0, und für die Verbindung mit Servern, die AMF3-Kodierung verwenden (z. B. Flex Data Services 2), auf ObjectEncoding.AMF3.

Sobald die Verbindung für eine NetConnection-Instanz hergestellt ist, kann die Eigenschaft objectEncoding nicht mehr geändert werden.

Wenn Sie die falsche Kodierung für die Herstellung einer Serververbindung verwenden, löst das NetConnection-Objekt das netStatus-Ereignis. Die NetStatusEvent.info-Eigenschaft enthält ein Informationsobjekt mit dem code-Eigenschaftswert NetConnection.Connect.Failed und einer Beschreibung, die angibt, dass die Objektkodierung ungültig ist.

Verwandte API-Elemente

Das Protokoll, das zur Herstellung der Verbindung verwendet wird. Diese Eigenschaft ist relevant, wenn Flash Media Server verwendet wird. Mögliche Werte sind wie folgt:

• "rtmp": Real-Time Messaging Protocol (RTMP)
• "rtmpe": Verschlüsseltes RTMP
• "rtmpt": RTMP über HTTP-Tunnel
• "rtmpte": Verschlüsseltes RTMP über HTTP-Tunnel
• "rtmps": HTTPS-basiertes RTMP
• "rtmfp": Real-Time Media Flow Protocol (RTMFP)

Legt fest, welche Fallback-Methoden zum Einsatz kommen, wenn der erste Verbindungsversuch mit Flash Media Server fehlschlägt. Legen Sie einen Wert für die proxyType-Eigenschaft fest, bevor Sie die NetConnection.connect()-Methode aufrufen.

Mögliche Werte sind "none", "HTTP", "CONNECTOnly", "CONNECT" und "best". Der Standardwert ist "none".

Um natives SSL zu verwenden, setzen Sie die Eigenschaft auf "best". Wenn der Player keine direkte Verbindung zum Server herstellen kann (über den Standardport 443 oder über einen anderen Port, den Sie angeben) und ein Proxyserver vorhanden ist, versucht der Player, die CONNECT-Methode zu verwenden. Wenn dieser Versuch fehlschlägt, tunnelt der Player über HTTPS.

Wenn die Eigenschaft auf "CONNECTOnly" gesetzt wird, versucht der Player zuerst, die CONNECT-Methode zu verwenden. Wenn dies nicht funktioniert, gibt es keinen Ersatzvorgang.

Wenn für die Eigenschaft der Wert „HTTP“ eingestellt ist und eine direkte Verbindung fehlschlägt, wird HTTP-Tunneling verwendet. Wenn für die Eigenschaft der Wert „CONNECT“ eingestellt ist und eine direkte Verbindung fehlschlägt, wird die Tunneling-Methode CONNECT verwendet. Wenn diese Methode ebenfalls fehlschlägt, erfolgt kein Fallback auf HTTP-Tunneling.

Diese Eigenschaft ist nur bei Verwendung von RTMP, RTMPS oder RTMPT anwendbar. Die CONNECT- und CONNECTOnly-Methoden können nur bei Benutzern angewendet werden, die über einen Proxyserver mit dem Netzwerk verbunden sind.

Ein Objekt, das alle Peer-Subscriber-NetStream-Objekte enthält, die nicht mit veröffentlichenden NetStream-Objekten verknüpft sind. NetStream-Abonnentenobjekte, die mit veröffentlichenden NetStream-Objekten verknüpft sind, sind im NetStream.peerStreams-Array.

Verwandte API-Elemente

Der an die NetConnection.connect()-Methode übergebene URI. Wenn die NetConnection.connect()-Methode nicht aufgerufen oder kein URI übergeben wurde, weist diese Eigenschaft den Wert undefined auf.

Gibt an, ob eine sichere Verbindung über TLS (Transport Layer Security) statt HTTPS hergestellt wurde. Diese Eigenschaft ist nur gültig, wenn eine Verbindung mit einem NetConnection-Objekt besteht.

Erstellt ein NetConnection-Objekt. Rufen Sie die connect()-Methode auf, um eine Verbindung herzustellen.

Wenn die Kommunikation einer Anwendung mit älteren Serverversionen als Flash Player 9 erforderlich ist, stellen Sie die objectEncoding-Eigenschaft des NetConnection-Objekts ein.

Mit dem folgenden Code wird ein NetConnection-Objekt erstellt:

     var nc:NetConnection = new NetConnection();
     

Verwandte API-Elemente

Fügt der Action Message Format (AMF)-Paketstruktur eine Kontextkopfzeile hinzu. Dieser Header wird mit allen weiteren AMF-Paketen gesendet. Wenn Sie die NetConnection.addHeader()-Methode mit demselben Namen aufrufen, wird der vorhandene Header durch den neuen Header ersetzt, der für die Dauer des NetConnection-Objekts erhalten bleibt. Sie können einen Header entfernen, indem Sie die NetConnection.addHeader()-Methode mit dem Namen des Headers aufrufen.

Parameter

Ruft auf Flash Media Server oder auf einem Anwendungsserver, auf dem Flash Remoting ausgeführt wird, einen Befehl oder eine Methode auf. Bevor Sie NetConnection.call() aufrufen, müssen Sie NetConnection.connect() aufrufen, um die Verbindung zum Server herzustellen. Sie müssen eine serverseitige Funktion erstellen, die an diese Methode übergeben wird.

Eine Verbindung mit normalerweise reservierten Ports ist nicht möglich. Eine vollständige Liste der gesperrten Ports finden Sie unter „Beschränken von Netzwerk-APIs“ im ActionScript 3.0 Entwicklerhandbuch.

Parameter

Verwandte API-Elemente

Schließt die lokal oder zum Server geöffnete Verbindung und löst ein netStatus-Ereignis mit der code-Eigenschaft NetConnection.Connect.Closed aus.

Mit dieser Methode werden alle NetStream-Objekte, die über die Verbindung ausgeführt werden, getrennt. Alle Daten in der Warteschlange, die noch nicht gesendet wurden, werden verworfen. (Um lokale oder serverbasierte Streams zu beenden, ohne die Verbindung zu schließen, verwenden Sie NetStream.close().) Wenn Sie die Verbindung schließen und dann eine neue erstellen möchten, müssen Sie ein neues NetConnection-Objekt erstellen und dann erneut die connect()-Methode aufrufen.

Die close-Methode trennt außerdem alle gemeinsamen Remote-Objekte, die diese Verbindung verwenden. Zur erneuten Verbindungsherstellung müssen Sie das gemeinsame Objekt jedoch nicht neu erstellen. Rufen Sie stattdessen die SharedObject.connect()-Methode auf, um die Verbindung mit dem gemeinsamen Objekt wiederherzustellen. Nach der Wiederherstellung der Verbindung mit dem gemeinsamen Objekt werden außerdem alle Daten, die sich beim Aufruf von NetConnection.close() in der Warteschlange befanden, gesendet.

Mit Flash Media Server ist es beim Entwickeln am besten, close() aufzurufen, wenn der Client die Verbindung zum Server nicht mehr benötigt. Das Aufrufen von close() ist die schnellste Möglichkeit, nicht verwendete Verbindungen zu schließen. Sie können die Server als Backup-Maßnahme so konfigurieren, dass nicht verwendete Verbindungen geschlossen werden. Weitere Informationen finden Sie im Flash Media Server Configuration and Administration Guide.

Verwandte API-Elemente

Erstellt eine bidirektionale Verbindung mit einer Anwendung auf Flash Media Server oder mit Flash Remoting, oder erstellt einen bidirektionalen Netzwerkendpunkt für die RTMFP-Peer-to-Peer-Gruppenkommunikation. Um den Status oder eine Fehlerbedingung zu melden, setzt ein Aufruf von NetConnection.connect() ein netStatus-Ereignis ab.

Rufen Sie NetConnection.connect() auf, um Folgendes auszuführen:

• Übergeben Sie "null", um Video- und MP3-Dateien aus einem lokalen Dateisystem oder von einem Webserver abzuspielen.
• Übergeben Sie eine http-URL, um eine Verbindung zu einem Anwendungsserver, auf dem Flash Remoting ausgeführt wird, herzustellen. Mit der NetServices-Klasse rufen Sie über ein NetConnection-Objekt Funktionen auf und Ergebnisse von Anwendungsservern auf. Weitere Informationen finden Sie in der Flash Remoting-Dokumentation.
• Übergeben Sie eine "rtmp/e/s"-URL, um eine Verbindung zu einer Flash Media Server-Anwendung herzustellen.
• Übergeben Sie eine "rtmfp"-URL, um einen bidirektionalen Netzwerkendpunkt für RTMFP-Client-Server-, Peer-to-Peer- und IP-Multicast-Kommunikation zu erstellen.
• Übergeben Sie den String "rtmfp:", um einen serverlosen bidirektionalen Netzwerkendpunkt für die RTMFP IP-Multicast-Kommunikation zu erstellen.

Ziehen Sie das folgende Sicherheitsmodell in Betracht:

• Standardmäßig lässt Flash Player oder AIR Sandbox-übergreifende Zugriffe nicht zu. Eine Website kann den Zugriff auf eine Ressource gewähren, indem eine URL-Richtliniendatei verwendet wird.
• Ihre Anwendung kann den Zugriff auf eine Ressource auf dem Server verhindern. Verwenden Sie in einer Flash Media Server-Anwendung serverseitigen ActionScript-Code, um den Zugriff zu verhindern. Lesen Sie dazu die Flash Media Server-Dokumentation.
• Sie können NetConnection.connect() nicht aufrufen, wenn sich die aufrufende Datei in der lokalen Sandbox des Dateisystems befindet.
• Eine Verbindung mit normalerweise reservierten Ports ist nicht möglich. Eine vollständige Liste der gesperrten Ports finden Sie unter „Beschränken von Netzwerk-APIs“ im ActionScript 3.0 Entwicklerhandbuch.
• Um zu verhindern, dass eine SWF-Datei diese Methode aufruft, legen Sie in der HTML-Seite, die den SWF-Inhalt enthält, den Parameter allowNetworking der Tags object und embed fest.

In Adobe AIR unterliegt Inhalt in der Sicherheitssandbox der Anwendung (Inhalt, der mit der AIR-Anwendung installiert wird) nicht diesen Sicherheitseinschränkungen.

Weitere Informationen zum Thema Sicherheit finden Sie im Adobe Flash Player Developer Center: Security.

Parameter

Verwandte API-Elemente

Wird ausgelöst, wenn eine Ausnahme asynchron ausgelöst wird – das heißt, aus nativem asynchronem Code.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird beim Auftreten eines I/O-Fehlers ausgelöst, durch den ein Netzwerkvorgang fehlschlägt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Status oder die Fehlerbedingung eines NetConnection-Objekts protokolliert wird. Das Ereignis netStatus enthält die Eigenschaft info. Dabei handelt es sich um ein Informationsobjekt mit spezifischen Informationen über das Ereignis, z. B., ob ein Verbindungsversuch erfolgreich war oder fehlgeschlagen ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn mit einem Aufruf von „NetConnection.call()“ versucht wird, eine Verbindung mit einem Server außerhalb der Sicherheitssandbox des Aufrufers herzustellen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

In diesem Fall wird der Code zur Erstellung des Video- und NetStream-Objekts und zum Aufrufen der Methoden Video.attachNetStream() und NetStream.play() in eine Prozedurfunktion eingefügt. Die Prozedur wird nur aufgerufen, wenn die Verbindung mit dem NetConnection-Objekt erfolgreich hergestellt werden kann, d. h. wenn das Ereignis netStatus ein info-Objekt mit einer code-Eigenschaft zurückgibt, die Erfolg angibt. Es wird empfohlen, die erfolgreiche Verbindungsherstellung abzuwarten, bevor Sie NetStream.play() aufrufen.

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