NetConnection  - AS3

Geeft het object aan waarop callback-methoden worden aangeroepen. Het standaardobject is deze instantie NetConnection. Wanneer u de eigenschap client op een ander object instelt, worden callback-methoden voor dat object aangeroepen.

Hiermee wordt aangegeven of de toepassing verbinding heeft gemaakt met een server via een blijvende RTMP-verbinding (true) of niet (false). Bij verbinding via HTTP is deze eigenschap false. Bij verbinding met Flash Remoting-services op een toepassingsserver is deze eigenschap true.

Het proxytype dat is gebruikt om een verbinding met Flash Media Server tot stand te brengen. Mogelijke waarden zijn: "none", "HTTP", "HTTPS" of "CONNECT".

De waarde is "none" als de verbinding geen tunnelverbinding is of als de verbinding een native SSL-verbinding is.

De waarde is "HTTP" als de verbinding een HTTP-tunnelverbinding is.

De waarde is "HTTPS" als de verbinding een HTTPS-tunnelverbinding is.

De waarde is "CONNECT" als de verbinding een tunnelverbinding is die via een proxyserver tot stand is gebracht met de methode CONNECT.

De standaardobjectcodering voor NetConnection-objecten. Wanneer een object wordt geschreven naar of gelezen van binaire gegevens, geeft de eigenschap defaultObjectEncoding aan welke versie van AMF (Action Message Format) wordt gebruikt om serienummering op de gegevens toe te passen: de indeling van ActionScript 3.0 (ObjectEncoding.AMF3) of de indeling van ActionScript 1.0 en ActionScript 2.0 (ObjectEncoding.AMF0).

De standaardwaarde is ObjectEncoding.AMF3. Wijzigingen in NetConnection.defaultObjectEncoding zijn niet van invloed op bestaande instanties NetConnection maar alleen op instanties die daarna worden gemaakt.

Wanneer u de codering van een object afzonderlijk wilt instellen (in plaats van de objectcodering voor de gehele toepassing in te stellen), stelt u in plaats daarvan de eigenschap objectEncoding van het object NetConnection in.

Zie de beschrijving van de eigenschap objectEncoding voor meer informatie.

Verwante API-elementen

De ID van de instantie van Flash Media Server waarmee deze instantie van Flash Player of Adobe AIR is verbonden. Deze eigenschap is alleen relevant voor RTMFP-verbindingen. De waarde van deze eigenschap is alleen beschikbaar nadat er een RTMFP-verbinding tot stand is gebracht.

Verwante API-elementen

Een waarde die in wezen door de Flash Media Server wordt gekozen en uniek is voor deze verbinding. Deze waarde wordt als de waarde client.nearNonce van de server weergegeven. Deze waarde wordt alleen gedefinieerd voor RTMFP-, RTMPE- en RTMPTE-verbindingen.

Het aantal milliseconden dat moet worden gewacht op een HTTP-antwoord. De standaardwaarde is nul.

• De waarde van httpIdleTimeout is een Number.
• Wanneer u een HTTP-verbinding gebruikt, wordt met een positieve waarde het aantal milliseconden aangegeven dat een niet-actieve verbinding open moet blijven.
• De waarde nul geeft aan dat de standaardtime-outwaarde voor niet-actieve netwerken van het platform moet worden gebruikt.
• Een negatieve waarde resulteert in een RangeError.
• Als de httpIdleTimeout-waarde wordt overschreden, wordt een netStatus-gebeurtenis verzonden.
• Deze eigenschap is alleen van invloed op NetConnection-objecten die met HTTP-verbindingen zijn gemaakt. NetConnection-objecten die met RTMP, RTMFP of andere HTTP-kanalen zijn gemaakt, worden niet beïnvloed door deze eigenschap.

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

Het totale aantal inkomende en uitgaande gelijkwaardige verbindingen dat is toegestaan door deze instantie van Flash Player of Adobe AIR. De standaardwaarde is 8.

Deze waarde maakt geen onderscheid tussen uitgever- en abonneeverbindingen. Als de waarde wordt verminderd terwijl er gelijkwaardige verbindingen aanwezig zijn, heeft de nieuwe waarde alleen invloed op inkomende verbindingen. Bestaande verbindingen worden niet verwijderd.

De ID van deze instantie van Flash Player of Adobe AIR voor deze instantie van NetConnection. Deze eigenschap is alleen relevant voor RTMFP-verbindingen.

Elke instantie van NetConnection heeft een unieke eigenschap nearID. Instanties van Flash Player, Adobe AIR of NetConnection hebben nooit dezelfde ID.

Andere instanties van Flash Player of Adobe AIR gebruiken deze ID als peerID voor nieuwe NetStream-verbindingen met deze client. Hierdoor is deze ID de farID in elke gelijkwaardige NetStream die verbinding maakt met deze instantie.

Verwante API-elementen

Een waarde die in wezen door deze instantie van Flash Player of Adobe AIR wordt gekozen en uniek is voor deze verbinding. Deze waarde wordt als de waarde client.farNonce van de server weergegeven. Deze waarde wordt alleen gedefinieerd voor RTMFP-, RTMPE- en RTMPTE-verbindingen.

De objectcodering voor deze instantie NetConnection.

Wanneer een object wordt geschreven naar of gelezen uit binaire gegevens, geeft de eigenschap defaultObjectEncoding aan welke versie van AMF (Action Message Format) wordt gebruikt om serienummering op de gegevens toe te passen: de indeling van ActionScript 3.0 (ObjectEncoding.AMF3) of de indeling van ActionScript 1.0 en ActionScript 2.0 (ObjectEncoding.AMF0). Stel de eigenschap objectEncoding zo in dat een AMF-versie voor een instantie NetConnection wordt ingesteld.

Het is belangrijk dat u deze eigenschap begrijpt wanneer de toepassing moet communiceren met servers die vóór Flash Player 9 zijn uitgebracht. De volgende drie scenario's zijn mogelijk:

• Verbinding maken met een server die AMF3 ondersteunt (bijvoorbeeld Flex Data Services 2 of Flash Media Server 3). De standaardwaarde van defaultObjectEncoding is ObjectEncoding.AMF3. Alle NetConnection-instanties die in dit bestand zijn gemaakt, gebruiken AMF3-serialiatie. U hoeft de eigenschap objectEncoding dus niet in te stellen.
• Verbinding maken met een server die AMF3 niet ondersteunt (bijvoorbeeld Flash Media Server 2). In dit scenario stelt u de statische eigenschap NetConnection.defaultObjectEncoding in op ObjectEncoding.AMF0. Alle instanties NetConnection die in dit SWF-bestand worden gemaakt, gebruiken AMF0-serienummering. U hoeft de eigenschap objectEncoding niet in te stellen.
• Er wordt verbinding gemaakt met meerdere servers die verschillende coderingsversies gebruiken. In plaats van defaultObjectEncoding te gebruiken, stelt u de objectcodering per verbinding in met behulp van de eigenschap objectEncoding voor elke verbinding. Stel deze eigenschap in op ObjectEncoding.AMF0 wanneer u verbinding wilt maken met servers die AMF0-codering gebruiken, zoals Flash Media Server 2. Stel de eigenschap in op ObjectEncoding.AMF3 wanneer u verbinding wilt maken met servers die AMF3-codering gebruiken, zoals Flex Data Services 2.

Nadat een instantie NetConnection is verbonden, is de eigenschap objectEncoding alleen-lezen.

Wanneer u de onjuiste codering gebruikt om verbinding te maken met een server, verzendt het NetConnection de netStatus-gebeurtenis. De eigenschap NetStatusEvent.info bevat een informatieobject met de eigenschap code die de waarde NetConnection.Connect.Failed heeft, en een beschrijving waarin wordt uitgelegd dat de objectcodering onjuist is.

Verwante API-elementen

Het protocol dat wordt gebruikt om de verbinding tot stand te brengen. Deze eigenschap is relevant wanneer Flash Media Server wordt gebruikt. Mogelijke waarden zijn:

• rtmp: Real-Time Messaging Protocol (RTMP)
• rtmpe: RTMP met encryptie
• rtmpt: RTMP met HTTP-tunneling
• rtmpte: RTMP met encryptie en HTTP-tunneling
• rtmps: RTMP die is gebaseerd op HTTPS
• rtmfp: Real-Time Media Flow Protocol (RTMFP)

Bepaalt welke terugvalmethoden worden geprobeerd wanneer de eerste verbindingspoging met Flash Media Server mislukt. U moet de eigenschap proxyType instellen voordat u de methode NetConnection.connect() aanroept.

Acceptabele waarden zijn "none", "HTTP", "CONNECTOnly", "CONNECT" en "best". De standaardwaarde is "none".

Stel de eigenschap in op "best" om native SSL te gebruiken. Als de speler geen rechtstreekse verbinding met de server kan maken (via de standaardpoort 443 of via een andere door u opgegeven poort) en er is een proxyserver ingesteld, probeert de speler de methode CONNECT te gebruiken. Als dit mislukt, probeert de speler een HTTP-tunnelverbinding te maken.

Als de eigenschap is ingesteld op "CONNECTOnly", probeert de speler eerst de CONNECT-methode te gebruiken. Als dit mislukt, is er geen fallback.

Als de eigenschap is ingesteld op HTTP en een directe verbinding mislukt, wordt de HTTP-tunnelmethode gebruikt. Als de eigenschap is ingesteld op CONNECT en een directe verbinding mislukt, wordt de CONNECT-tunnelmethode gebruikt. Als dit mislukt, valt de verbinding niet terug op de HTTP-tunnelmethode.

Deze deze eigenschap is alleen van toepassing bij gebruik van RTMP, RTMPS of RTMPT. De methoden CONNECT en CONNECTOnly zijn alleen van toepassing op gebruikers die met het netwerk verbonden zijn door een proxyserver.

Een object dat alle objecten van de gelijkwaardige NetStream-abonnee-objecten bevat die niet zijn gekoppeld aan publicerende NetStream-objecten. NetStream-abonneeobjecten die zijn gekoppeld aan NetStream-publicatieobjecten bevinden zich in de array NetStream.peerStreams.

Verwante API-elementen

De URI die wordt doorgegeven aan de methode NetConnection.connect(). Wanneer NetConnection.connect() niet is aangeroepen of wanneer geen URI is doorgegeven, is deze eigenschap undefined.

Geeft aan of een beveiligde verbinding is gemaakt via native TLS (Transport Layer Security) in plaats van via HTTPS. Deze eigenschap is alleen geldig wanneer een object NetConnection is verbonden.

Maakt een object NetConnection. Roep connect() aan om verbinding te maken.

Als een toepassing moet communiceren met servers die vóór Flash Player 9 zijn uitgebracht, stelt u de eigenschap objectEncoding van het object NetConnection in.

Met de volgende code maakt u een object NetConnection:

     var nc:NetConnection = new NetConnection();
     

Verwante API-elementen

Voegt een contextheader toe aan de AMF-pakketstructuur (Action Message Format). Deze header wordt met elk toekomstig AMF-pakket verzonden. Wanneer u NetConnection.addHeader() aanroept met dezelfde naam, vervangt de nieuwe header de bestaande header en blijft de nieuwe header behouden tijdens de duur van het object NetConnection. U kunt een header verwijderen door NetConnection.addHeader() aan te roepen met de naam van de header om een ongedefinieerd object te verwijderen.

Parameters

Roept een opdracht of methode aan op Flash Media Server of op een toepassingsserver waarop Flash Remoting wordt uitgevoerd. Voordat u NetConnection.call() aanroept, moet u NetConnection.connect() aanroepen om verbinding te maken met de server. U moet een serverfunctie maken om deze methode door te geven.

U kunt geen verbinding maken met algemeen gereserveerde poorten. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.

Parameters

Verwante API-elementen

Sluit de verbinding die lokaal of met de server is geopend en verzendt een gebeurtenis netStatus met een eigenschap code van NetConnection.Connect.Closed.

Deze methode verbreekt de verbinding van alle objecten NetStream die via de verbinding worden uitgevoerd. Gegevens in een wachtrij die niet zijn verzonden, worden verwijderd. (Wanneer u lokale streams of serverstreams wilt beëindigen zonder de verbinding te sluiten, gebruikt u NetStream.close().) Wanneer u de verbinding sluit en vervolgens een nieuwe wilt maken, moet u een nieuw object NetConnection maken en de methode connect() nogmaals aanroepen.

De methode close() verbreekt ook de verbinding met alle externe gezamenlijke objecten die via deze verbinding worden uitgevoerd. U hoeft het gezamenlijke object echter niet opnieuw te maken om opnieuw verbinding te maken. In plaats daarvan roept u eenvoudig SharedObject.connect() aan om de verbinding met het gezamenlijke object opnieuw tot stand te brengen. Eventuele gegevens in het gezamenlijke object die in de wachtrij zijn geplaatst toen u NetConnection.close() aanriep, worden verzonden nadat u de verbinding met het gezamenlijke object herstelt.

Met Flash Media Server kunt u het beste close() aanroepen wanneer de client geen verbinding met de server meer nodig heeft. Het aanroepen van close() is de snelste manier om ongebruikte verbindingen op te schonen. U kunt de server zo configureren dat als back-upmaatregel inactieve verbindingen automatisch worden gesloten. Raadpleeg de Flash Media Server Configuration and Administration Guide voor meer informatie.

Verwante API-elementen

Maakt een verbinding in twee richtingen met een toepassing op Flash Media Server of met Flash Remoting, of maakt een netwerkeindpunt in twee richtingen voor RTMFP peer-to-peergroepscommunicatie. Als u een status- of foutvoorwaarde wilt rapporteren, wordt met het aanroepen van NetConnection.connect() een gebeurtenis netStatus verzonden.

Roep NetConnection.connect() aan om het volgende te doen:

• Geef 'null' door om video- en MP3-bestanden vanuit een lokaal bestandssysteem of vanaf een webserver af te spelen.
• Geef een URL van het type 'http' door om verbinding te maken met een toepassingsserver waarop Flash Remoting wordt uitgevoerd. Gebruik de klasse NetServices om functies aan te roepen op en resultaten te retourneren vanaf toepassingsservers over een object NetConnection. Raadpleeg de documentatie bij Flash Remoting voor meer informatie.
• Geef een URL van het type 'rtmp/e/s' door om verbinding te maken met een Flash Media Server-toepassing.
• Geef een URL van het type 'rtmfp' door om een netwerkeindpunt in twee richtingen te maken voor RTMFP-client-servercommunicatie, peer-to-peercommunicatie en IP-multicastcommunicatie.
• Geef de tekenreeks 'rtmfp:' door om een serverloos netwerkeindpunt in twee richtingen voor RTMFP IP-multicastcommunicatie te maken.

Overweeg het volgende beveiligingsmodel:

• Standaard weigert Flash Player of AIR toegang tussen sandboxes. Websites kunnen toegang tot een bron toestaan door een bestand met URL-beleid te gebruiken.
• Uw toepassing kan toegang tot een bron op de server weigeren. Gebruik in een Flash Media Server-toepassing Server-Side ActionScript-code om toegang te weigeren. Zie de Documentatie van Flash Media Server.
• U kunt NetConnection.connect() niet aanroepen wanneer het aanroepende bestand zich in de sandbox Lokaal-met-bestandssysteem bevindt.
• U kunt geen verbinding maken met algemeen gereserveerde poorten. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.
• Als u wilt voorkomen dat een SWF-bestand deze methode gebruikt, stelt u de parameter allowNetworking van de tags object en embed in op de HTML-pagina die de SWF-inhoud bevat.

In Adobe AIR is de inhoud in de application -beveiligingssandbox (inhoud die met de AIR-toepassing is geïnstalleerd), echter niet beperkt tot deze beveiligingsbeperkingen.

Lees voor meer informatie over beveiliging het onderwerp Security in het Adobe Flash Player Developer Center.

Parameters

Verwante API-elementen

Wordt verzonden wanneer een uitzondering asynchroon wordt gegenereerd, dat wil zeggen, vanuit native asynchrone code.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een invoer- of uitvoerfout optreedt die ertoe leidt dat een netwerkbewerking mislukt.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden wanneer een object NetConnection de status of fout ervan meldt. De gebeurtenis netStatus bevat een eigenschap info. Dit is een informatieobject dat specifieke informatie over de gebeurtenis bevat, zoals of een poging om verbinding te maken is geslaagd of mislukt.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer een aanroep naar NetConnection.call() verbinding probeert te maken met een server buiten de beveiligingssandbox van de aanroeper.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

In dit voorbeeld wordt de code die de objecten Video en NetStream maakt en de methoden Video.attachNetStream() en NetStream.play() aanroept, in een handlerfunctie geplaatst. De handler wordt alleen aangeroepen wanneer verbinding wordt gemaakt met het object NetConnection, dat wil zeggen, wanneer de gebeurtenis netStatus een object info retourneert waarvan de eigenschap code aangeeft dat de verbinding is gelukt. Het wordt aanbevolen te wachten totdat de verbinding is gelukt voordat u NetStream.play() aanroept.

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