Paket | flash.net |
Klasse | public class NetConnection |
Vererbung | NetConnection EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
NetConnection.connect()
auf, um die Verbindung herzustellen. Verwenden Sie die NetStream-Klasse, um Streams von Medien und Daten über die Verbindung zu senden.
Die Sicherheit betreffende Informationen zum Laden von Inhalten und Daten in Flash Player und AIR finden Sie hier:
- Um Inhalte und Daten von einem Webserver oder einem lokalen Speicherort in Flash Player zu laden, lesen Sie Flash Player Developer Center: Security.
- Um Inhalte und Daten von Flash Media Server in Flash Player und AIR zu laden, lesen Sie die Flash Media Server-Dokumentation.
- Um Inhalte und Daten in AIR zu laden, besuchen Sie das Adobe AIR Developer Center.
Zum Schreiben von Callback-Methoden für diese Klasse erweitern Sie die Klasse und die Callback-Methoden in der Unterklasse oder weisen Sie die client
-Eigenschaft einem Objekt zu und definieren Sie die Callback-Methoden in diesem Objekt.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
client : Object
Gibt das Objekt an, bei dem Callback-Methoden aufgerufen werden. | NetConnection | ||
connected : Boolean [schreibgeschützt]
Gibt an, ob die Anwendung über eine permanente RTMP-Verbindung mit einem Server verbunden ist (true) oder nicht (false). | NetConnection | ||
connectedProxyType : String [schreibgeschützt]
Der Proxytyp, der verwendet wird, um eine erfolgreiche Verbindung zu Flash Media Server herzustellen. | NetConnection | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
defaultObjectEncoding : uint [statisch]
Die Standard-Objektkodierung für NetConnection-Objekte. | NetConnection | ||
farID : String [schreibgeschützt]
Der Bezeichner der Flash Media Server-Instanz, mit dem diese Flash Player- oder Adobe AIR-Instanz verbunden ist. | NetConnection | ||
farNonce : String [schreibgeschützt]
Ein Wert, der vom Flash Media Server ausgewählt wird und für diese Verbindung eindeutig ist. | NetConnection | ||
httpIdleTimeout : Number
Die Zeit in Millisekunden, die auf eine HTTP-Antwort gewartet wird. | NetConnection | ||
maxPeerConnections : uint
Die Anzahl der eingehenden und ausgehenden Peer-Verbindungen, die diese Instanz von Flash Player oder Adobe AIR zulässt. | NetConnection | ||
nearID : String [schreibgeschützt]
Die ID dieser Flash Player- oder Adobe AIR-Instanz für diese NetConnection-Instanz. | NetConnection | ||
nearNonce : String [schreibgeschützt]
Ein Wert, der von dieser Flash Player- oder Adobe AIR-Instanz ausgewählt wird und für diese Verbindung eindeutig ist. | NetConnection | ||
objectEncoding : uint
Die Objektkodierung für diese NetConnection-Instanz. | NetConnection | ||
protocol : String [schreibgeschützt]
Das Protokoll, das zur Herstellung der Verbindung verwendet wird. | NetConnection | ||
proxyType : String
Legt fest, welche Fallback-Methoden zum Einsatz kommen, wenn der erste Verbindungsversuch mit Flash Media Server fehlschlägt. | NetConnection | ||
unconnectedPeerStreams : Array [schreibgeschützt]
Ein Objekt, das alle Peer-Subscriber-NetStream-Objekte enthält, die nicht mit veröffentlichenden NetStream-Objekten verknüpft sind. | NetConnection | ||
uri : String [schreibgeschützt]
Der an die NetConnection.connect()-Methode übergebene URI. | NetConnection | ||
usingTLS : Boolean [schreibgeschützt]
Gibt an, ob eine sichere Verbindung über TLS (Transport Layer Security) statt HTTPS hergestellt wurde. | NetConnection |
Methode | Definiert von | ||
---|---|---|---|
Erstellt ein NetConnection-Objekt. | NetConnection | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Fügt der Action Message Format (AMF)-Paketstruktur eine Kontextkopfzeile hinzu. | NetConnection | ||
Ruft auf Flash Media Server oder auf einem Anwendungsserver, auf dem Flash Remoting ausgeführt wird, einen Befehl oder eine Methode auf. | NetConnection | ||
Schließt die lokal oder zum Server geöffnete Verbindung und löst ein netStatus-Ereignis mit der code-Eigenschaft „NetConnection.Connect.Closed“ aus. | NetConnection | ||
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. | NetConnection | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn eine Ausnahme asynchron, d. h. aus nativem asynchronem Code ausgelöst wird. | NetConnection | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird beim Auftreten eines I/O-Fehlers ausgelöst, durch den ein Netzwerkvorgang fehlschlägt. | NetConnection | |||
Wird ausgelöst, wenn der Status oder die Fehlerbedingung eines NetConnection-Objekts protokolliert wird. | NetConnection | |||
Wird ausgelöst, wenn mit einem Aufruf von „NetConnection.call()“ versucht wird, eine Verbindung mit einem Server außerhalb der Sicherheitssandbox des Aufrufers herzustellen. | NetConnection |
client | Eigenschaft |
client:Object
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get client():Object
public function set client(value:Object):void
Auslöser
TypeError — Die client -Eigenschaft muss auf ein Objekt eingestellt werden, das nicht null ist.
|
connected | Eigenschaft |
connected:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get connected():Boolean
connectedProxyType | Eigenschaft |
connectedProxyType:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get connectedProxyType():String
Auslöser
ArgumentError — Es wurde versucht, ohne Verbindung der NetConnection-Instanz auf diese Eigenschaft zuzugreifen.
|
defaultObjectEncoding | Eigenschaft |
defaultObjectEncoding:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
.
Implementierung
public static function get defaultObjectEncoding():uint
public static function set defaultObjectEncoding(value:uint):void
Verwandte API-Elemente
farID | Eigenschaft |
farID:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.
Implementierung
public function get farID():String
Verwandte API-Elemente
farNonce | Eigenschaft |
farNonce:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.
Implementierung
public function get farNonce():String
httpIdleTimeout | Eigenschaft |
httpIdleTimeout:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.6 |
Die Zeit in Millisekunden, die auf eine HTTP-Antwort gewartet wird. Der Standardwert ist 0.
- Der
httpIdleTimeout
-Wert ist vom TypNumber
. - 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 einnetStatus
-Ereignis abgesetzt. - Dieses Eigenschaft betrifft nur
NetConnection
-Objekte, die mit HTTP-Verbindungen erstellt wurden. AufNetConnection
-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;
NetConnection
möglicherweise mehr Sekunden als mit dem httpIdleTimeout
-Wert angegeben, bis die Zeitüberschreitung wirksam wird.
Implementierung
public function get httpIdleTimeout():Number
public function set httpIdleTimeout(value:Number):void
maxPeerConnections | Eigenschaft |
maxPeerConnections:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.
Implementierung
public function get maxPeerConnections():uint
public function set maxPeerConnections(value:uint):void
nearID | Eigenschaft |
nearID:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.
Implementierung
public function get nearID():String
Verwandte API-Elemente
nearNonce | Eigenschaft |
nearNonce:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.
Implementierung
public function get nearNonce():String
objectEncoding | Eigenschaft |
objectEncoding:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
istObjectEncoding.AMF3
. Alle in dieser Datei erstellten NetConnection-Instanzen verwenden die AMF3-Serialisierung, deshalb brauchen Sie dieobjectEncoding
-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
aufObjectEncoding.AMF0
. Für alle in dieser SWF-Datei erstellten NetConnection-Instanzen wird die AMF0-Serialisierung verwendet. Die EigenschaftobjectEncoding
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 EigenschaftobjectEncoding
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), aufObjectEncoding.AMF0
, und für die Verbindung mit Servern, die AMF3-Kodierung verwenden (z. B. Flex Data Services 2), aufObjectEncoding.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.
Implementierung
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
Auslöser
ReferenceError — Es wurde versucht, bei bereits hergestellter Verbindung der NetConnection-Instanz den Wert der Eigenschaft objectEncoding einzustellen.
| |
ArgumentError — Für diese Eigenschaft wurde ein anderer Wert als ObjectEncoding.AMF0 oder ObjectEncoding.AMF3 eingestellt.
|
Verwandte API-Elemente
protocol | Eigenschaft |
protocol:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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)
Implementierung
public function get protocol():String
Auslöser
ArgumentError — Es wurde versucht, ohne Verbindung der NetConnection-Instanz auf diese Eigenschaft zuzugreifen.
|
proxyType | Eigenschaft |
proxyType:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get proxyType():String
public function set proxyType(value:String):void
unconnectedPeerStreams | Eigenschaft |
unconnectedPeerStreams:Array
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.
Implementierung
public function get unconnectedPeerStreams():Array
Verwandte API-Elemente
uri | Eigenschaft |
uri:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get uri():String
usingTLS | Eigenschaft |
usingTLS:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementierung
public function get usingTLS():Boolean
Auslöser
ArgumentError — Es wurde versucht, ohne Verbindung der NetConnection-Instanz auf diese Eigenschaft zuzugreifen.
|
NetConnection | () | Konstruktor |
public function NetConnection()
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
addHeader | () | Methode |
public function addHeader(operation:String, mustUnderstand:Boolean = false, param:Object = null):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
operation:String — Identifiziert den Header und die damit verknüpften ActionScript-Objektdaten.
| |
mustUnderstand:Boolean (default = false ) — Der Wert true gibt an, dass der Server diesen Header vor der Verarbeitung der darauf folgenden Header oder Meldungen erkennen und verarbeiten muss.
| |
param:Object (default = null ) — Ein beliebiges ActionScript-Objekt.
|
call | () | Methode |
public function call(command:String, responder:Responder, ... arguments):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
command:String — Eine in der Form [objectPath/]method angegebene Methode. Beispiel: Der Befehl someObject/doSomething fordert den Remote-Server auf, die Methode clientObject.someObject.doSomething() mit allen optionalen ... arguments -Parametern aufzurufen. Wenn der Objektpfad fehlt, wird die clientObject.doSomething() -Methode auf dem Remote-Server aufgerufen.
Mit Flash Media Server ist | |
responder:Responder — Ein optionales Objekt, das zur Verarbeitung der vom Server zurückgegebenen Werte verwendet wird. Für das Responder-Objekt können zwei Methoden zur Verarbeitung der zurückgegebenen Ergebnisse definiert werden: result und status . Bei Rückgabe eines Fehlers wird status aufgerufen, andernfalls result . Das Responder-Objekt verarbeitet Fehlermeldungen, die sich auf bestimmte Operationen beziehen, wohingegen das NetConnection-Objekt auf Fehlermeldungen reagiert, die sich auf den Verbindungsstatus beziehen.
| |
... arguments — Optionale Argumente, die einen beliebigen ActionScript-Typ aufweisen können, einschließlich eines Verweises auf ein anderes ActionScript-Objekt. Diese Argumente werden an die im Parameter command angegebene Methode übergeben, wenn die Methode auf dem Remote-Anwendungsserver ausgeführt wird.
|
Ereignisse
securityError: — Mit einem Aufruf wurde versucht, mit einem Server außerhalb der Sicherheitssandbox des Aufrufers zu kommunizieren. Sie können dieses Problem umgehen, indem Sie eine Richtliniendatei auf dem entsprechenden Server verwenden.
|
Verwandte API-Elemente
close | () | Methode |
public function close():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
connect | () | Methode |
public function connect(command:String, ... arguments):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 Tagsobject
undembed
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
command:String — Verwenden Sie einen der folgenden Werte für den command -Parameter:
Für diesen Verbindungstyp gelten die folgenden Einschränkungen: Nur Peers im selben LAN können einander erkennen. Mit IP-Multicast kann Flash Player Streams empfangen, aber nicht senden. Flash Player und AIR können Streams in einer Peer-to-Peer-Gruppe senden und empfangen, die Peers müssen jedoch mit IP-Multicast in demselben LAN erkannt werden. Dieses Verfahren kann nicht für die Eins-zu-Eins-Kommunikation verwendet werden. | |
... arguments — Optionale Parameter beliebigen Typs, die an die in command angegebene Anwendung übergeben werden. Mit Flash Media Server werden die zusätzlichen Argumente an die Ereignisprozedur application.onConnect() im serverseitigen Programmcode der Anwendung übergeben. Sie müssen die Argumente in onConnect() definieren und verarbeiten.
|
Auslöser
ArgumentError — Der an den Parameter command übergebene URI hat ein ungültiges Format.
| |
IOError — Die Verbindung ist fehlgeschlagen. Dieser Fall kann eintreten, wenn Sie connect() über eine netStatus -Ereignisprozedur aufrufen, was nicht zulässig ist.
| |
SecurityError — Über lokale SWF-Dateien im Dateisystem kann keine Verbindung mit dem Internet hergestellt werden. Sie können dieses Problem vermeiden, indem Sie die entsprechende Datei als lokal mit Netzwerkzugang oder als vertrauenswürdig klassifizieren.
| |
SecurityError — 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.
|
Verwandte API-Elemente
asyncError | Ereignis |
flash.events.AsyncErrorEvent
Eigenschaft AsyncErrorEvent.type =
flash.events.AsyncErrorEvent.ASYNC_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird ausgelöst, wenn eine Ausnahme asynchron ausgelöst wird – das heißt, aus nativem asynchronem Code.
Die KonstanteAsyncErrorEvent.ASYNC_ERROR
definiert den Wert der type
-Eigenschaft eines asyncError
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, das das Ereignis auslöst. |
error | Der Fehler, der das Ereignis ausgelöst hat. |
ioError | Ereignis |
flash.events.IOErrorEvent
Eigenschaft IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird beim Auftreten eines I/O-Fehlers ausgelöst, durch den ein Netzwerkvorgang fehlschlägt.
Definiert den Wert der Eigenschafttype
eines ioError
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
errorID | Die Referenznummer des spezifischen Fehlers (nur AIR). |
target | Das Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt. |
text | Der als Fehlermeldung anzuzeigende Text. |
netStatus | Ereignis |
flash.events.NetStatusEvent
Eigenschaft NetStatusEvent.type =
flash.events.NetStatusEvent.NET_STATUS
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
eines netStatus
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
info | Ein Objekt mit Eigenschaften, die den Status oder die Fehlerbedingung des Objekts beschreiben. |
target | Das NetConnection- oder NetStream-Objekt, dessen Status protokolliert wird. |
Verwandte API-Elemente
securityError | Ereignis |
flash.events.SecurityErrorEvent
Eigenschaft SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird ausgelöst, wenn mit einem Aufruf von „NetConnection.call()“ versucht wird, eine Verbindung mit einem Server außerhalb der Sicherheitssandbox des Aufrufers herzustellen.
Die KonstanteSecurityErrorEvent.SECURITY_ERROR
definiert den Wert der type
-Eigenschaft eines securityError
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, das den Sicherheitsfehler ausgibt. |
text | Der als Fehlermeldung anzuzeigende Text. |
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); } }
Tue Jun 12 2018, 10:04 AM Z