NetConnection  - AS3

Anger objektet som återkopplingsmetoder anropas i. Standardvärdet är denna NetConnection-instans. Om du tilldelar egenskapen client till ett annat objekt kommer återkopplingsmetoder att anropas i det objektet.

Anger huruvida programmet har anslutit till en server via en beständig RTMP-anslutning (true) eller inte (false). När det finns en anslutning via HTTP är egenskapen false, förutom om det finns en anslutning till Flash Remoting-tjänster på en programserver. Då är den true.

Den proxytyp som används för att ansluta till Flash Media Server. Möjliga värden är: "none", "HTTP", "HTTPS" och "CONNECT".

Värdet är "none" om anslutningen inte tunnlas eller är en intern SSL-anslutning.

Värdet är "HTTP" om anslutningen tunnlas via HTTP.

Värdet är "HTTPS" om anslutningen tunnlas via HTTPs.

Värdet är "CONNECT" om anslutningen tunnlas med CONNECT-metoden via en proxyserver.

Standardobjektkodningen för NetConnection-objekt. Om ett objekt skrivs till eller läses från binära data anger egenskapen defaultObjectEncoding vilken AMF-version som ska användas för att serialisera data: formatet ActionScript 3.0 (ObjectEncoding.AMF3) eller formatet ActionScript 1.0 och ActionScript 2.0 (ObjectEncoding.AMF0).

Standardvärdet är ObjectEncoding.AMF3. Om du ändrar NetConnection.defaultObjectEncoding påverkas inte befintliga NetConnection-instanser, det påverkar endast instanser som skapas därefter.

Om du vill ange kodningen för ett objekt separat (i stället för att ange objektkodning för hela programmet) anger du i stället egenskapen objectEncoding för NetConnection-objektet.

Mer information finns i beskrivningen för egenskapen objectEncoding.

Relaterade API-element

Identifieraren för den Flash Media Server-instans som den här Flash Player- eller Adobe AIR-instansen är ansluten till. Den här egenskapen fyller endast en funktion för RTMFP-anslutningar. Det här värdets egenskap finns tillgänglig endast efter att en RTMFP-anslutning har upprättats.

Relaterade API-element

Ett värde som väljs explicit av Flash Media Server och är unikt för denna anslutning. Det här värdet visas för servern som dess client.nearNonce-värde. Det här värdet definieras bara för RTMFP-, RTMPE- och RTMPTE-anslutningar.

Tid i millisekunder att vänta på ett HTTP-svar. Standardvärdet är noll.

• Värdet httpIdleTimeout är ett Number.
• När du använder en HTTP-anslutning anger ett positivt värde hur många millisekunder en inaktiv anslutning ska hållas öppen.
• Ett värde om noll anger att nätverkets standardvärde för timeout för plattformen ska användas.
• Ett negativt värde leder till ett RangeError.
• Om värdet httpIdleTimeout överstigs skickas en netStatus-händelse.
• Den här egenskapen påverkar endast NetConnection-objekt som skapats med HTTP-anslutningar. NetConnection-objekt som skapats med RTMP-, RTMFP- eller andra HTTP-kanaler påverkas inte av den här egenskapen.

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

Det totala antalet inkommande och utgående peer-anslutningar som den här instansen av Flash Player eller Adobe AIR tillåter. Standardvärdet är 8.

Det här värdet skiljer inte mellan publicerade anslutningar och prenumerantanslutningar. Om det här värdet minskas när peer-anslutningen är aktiv, kommer det nya värdet endast att påverka nya inkommande anslutningar. Befintliga anslutningar släpps ej.

Identifieraren för Flash Player- eller Adobe AIR-instansen för den här NetConnection-instansen. Den här egenskapen fyller endast en funktion för RTMFP-anslutningar.

Varje NetConnection har en unik nearID-egenskap. Ingen Flash Player- eller Adobe AIR-instans eller NetConnection-instans har samma identifierare.

Andra Flash Player- eller Adobe AIR-instanser använder den här identifieraren som peerID för nya NetStream-anslutningar till den här klienten. Den här identifieraren är alltså farID i alla peer NetStream som ansluts till den här instansen.

Relaterade API-element

Ett värde som väljs explicit av denna Flash Player- eller Adobe AIR-instans och är unik för denna anslutning. Det här värdet visas för servern som dess client.farNonce-värde. Det här värdet definieras bara för RTMFP-, RTMPE- och RTMPTE-anslutningar.

Objektkodningen för den här NetConnection-instansen.

Om ett objekt skrivs till eller läses från binära data anger egenskapen defaultObjectEncoding vilken AMF-version som ska användas för att serialisera data: formatet ActionScript 3.0 (ObjectEncoding.AMF3) eller formatet ActionScript 1.0 och ActionScript 2.0 (ObjectEncoding.AMF0). Ställ in egenskapen objectEncoding för att ställa in en AMF-version för en NetConnection-instans.

Du måste veta hur egenskapen fungerar om programmet behöver kunna kommunicera med servrar med tidigare versioner än Flash Player 9. Följande tre scenarier är möjliga:

• Ansluta till en server med stöd för AMF3 (till exempel Flex Data Services 2 eller Flash Media Server 3). Standardvärdet för defaultObjectEncoding är ObjectEncoding.AMF3. Alla NetConnection-instanser som skapas i den här filen använder AMF3-serialisering, så du behöver inte ange egenskapen objectEncoding.
• Ansluta till en server utan stöd för AMF3 (till exempel Flash Media Server 2). I det här scenariet anger du den statiska egenskapen NetConnection.defaultObjectEncoding som ObjectEncoding.AMF0. Alla NetConnection-instanser som skapats i denna SWF-fil används med AMF0-serialisering. Du behöver inte ange något värde för egenskapen objectEncoding.
• Anslutning till flera servrar som används med olika kodningsversioner. Istället för att använda defaultObjectEncoding anger du en objektkodning per anslutning med egenskapen objectEncoding för respektive anslutning. Ange ObjectEncoding.AMF0 för en anslutning till servrar med AMF0-kodning, t.ex. Flash Media Server 2. Ange ObjectEncoding.AMF3 för en anslutning till servrar med AMF3-kodning, t.ex. Flex Data Services 2.

När en NetConnection-instans är ansluten skrivskyddas egenskapen objectEncoding.

Om du använder fel kodning vid anslutningen till en server skickas händelsen netStatus av NetConnection-objektet. Egenskapen NetStatusEvent.info innehåller ett informationsobjekt med code-egenskapsvärdet NetConnection.Connect.Failed och ett meddelande om att objektkodningen är felaktig.

Relaterade API-element

Protokollet som används för att etablera anslutningen. Den här egenskapen är relevant när Flash Media Server används. Följande värden är möjliga:

• "rtmp": Real-Time Messaging Protocol (RTMP)
• "rtmpe": Krypterad RTMP
• "rtmpt": HTTP-tunnling av RTMP
• "rtmpte": HTTP-tunnling av krypterad RTMP
• "rtmps": HTTPS-baserad RTMP
• "rtmfp": Real-Time Media Flow Protocol (RTMFP)

Avgör vilka reservmetoder som ska användas om det första anslutningsförsöket till Flash Media Server misslyckas. Ange egenskapen proxyType innan metoden NetConnection.connect() anropas.

Giltiga värden är "none", "HTTP", "CONNECTOnly", "CONNECT" och "best". Standardvärdet är "none".

Om du vill använda intern SSL anger du egenskapen som "best". Om spelaren inte kan skapa en direkt anslutning till servern (via standardporten 443 eller någon annan port som du anger), och det finns en proxyserver, försöker spelare använda metoden CONNECT. Om det misslyckas tunnlas anslutningen via HTTPS.

Om egenskapen anges som "CONNECTOnly" försöker spelaren använda metoden CONNECT först. Om detta misslyckas finns inget reservalternativ.

Om egenskapen anges till "HTTP" och en direktanslutning misslyckas används HTTP-tunnling. Om egenskapen anges till "CONNECT" och en direktanslutning misslyckas används tunnelmetoden CONNECT. Vid ett misslyckat försök används inte HTTP-tunnling.

Den här egenskapen tillämpas endast om RTMP, RTMPS eller RTMPT används. Metoderna CONNECT och CONNECTOnly gäller bara datorer som är anslutna till nätverket via en proxyserver.

Ett objekt som håller alla peer-prenumeranters NetStream-objekt och som inte är kopplat till publicering av NetStream-objekt. Prenumererade NetStream-objekt som är associerade med publicerande NetStream-objekt i NetStream.peerStreams-arrayen.

Relaterade API-element

Det URI som skickas till metoden NetConnection.connect(). Om NetConnection.connect() inte har anropats eller om ingen URI skickades är denna egenskap undefined.

Anger om en säker anslutning gjordes med intern TLS (Transport Layer Security) i stället för HTTPS. Den här egenskapen är giltig endast när ett NetConnection-objekt är anslutet.

Skapar ett NetConnection-objekt. Anropa metoden connect() för att upprätta en anslutning.

Om ett program behöver kommunicera med servrar som är äldre än Flash Player 9, ska du ställa in egenskapen objectEncoding för NetConnection-objektet.

I koden som följer skapas ett NetConnection-objekt:

     var nc:NetConnection = new NetConnection();
     

Relaterade API-element

Lägger till en kontextrubrik i AMF-paketstrukturen (Action Message Format). Den här rubriken skickas med varje framtida AMF-paket. Om du anropar NetConnection.addHeader() med samma namn ersätts befintlig rubrik med den nya rubriken. Den nya rubriken används under hela körningen med NetConnection-objektet. Du kan ta bort en rubrik genom att anropa NetConnection.addHeader() med rubriknamnet för att ta bort ett odefinierat objekt.

Parametrar

Anropar ett kommando eller en metod på Flash Media Server eller på en programserver där Flash Remoting körs. Innan du anropar NetConnection.call() måste du anropa NetConnection.connect() för att ansluta till servern. Du måste skapa en serversidesfunktion för att skicka den här metoden.

Du kan inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.

Parametrar

Relaterade API-element

Stänger anslutningen som öppnades lokalt eller med servern och skickar en netStatus-händelse med code-egenskapen NetConnection.Connect.Closed.

Den här metoden kopplar från alla NetStream-objekt som körs via anslutningen. Alla data som är i kö och inte har skickats tas bort. (För att avsluta lokala- eller serverdirektuppspelningar utan att stänga anslutningen använder du NetStream.close().) Om du stänger anslutningen och sedan vill skapa en ny måste du skapa ett nytt NetConnection-objekt och anropa metoden connect() igen.

Metoden close() kopplar även från alla externa delade objekt som körs via anslutningen. Däremot behöver du inte skapa om delat objekt för att ansluta igen. Du kan istället anropa SharedObject.connect() för att återta anslutningen till delat objekt. Eventuella data i det delade objektet som fanns i kön när NetConnection.close() anropades kommer att skickas när anslutningen har upprättats igen till det delade objektet.

Med Flash Media Server är den bästa kodningsrutinen att anropa close() när klienten inte längre behöver någon anslutning till servern. Att anropa close() är det snabbaste sättet att bli av med anslutningar som inte används. Du kan konfigurera servern så att inaktiva anslutningar stängs automatiskt som en reservåtgärd. Mer information finns i Konfigurations- och administrationshandboken för Flash Media Server.

Relaterade API-element

Skapar dubbelriktad anslutning till ett program på Flash Media Server eller till Flash Remoting, eller så skapas en dubbelriktad nätverksslutpunkt för RTMFP-kommunikation i peer-to-peer-grupper. Om du vill rapportera dess status eller ett feltillstånd, kommer ett anrop till NetConnection.connect() att skicka en netStatus-händelse.

Anropa NetConnection.connect() för att göra följande:

• Skicka "null" för att spela upp videoklipp och MP3-filer från ett lokalt filsystem eller från en webbserver.
• Skicka en "http"-URL för att ansluta till en programserver som kör Flash Remoting. Använd klassen NetServices för att anropa funktioner på och returnera resultat från programservrar via ett NetConnection-objekt. Mer information finns i dokumentationen för Flash Remoting.
• Skicka en "rtmp/e/s"-URL för att ansluta till ett Flash Media Server-program.
• Skicka en "rtmfp"-URL för att skapa en dubbelriktad nätverksslutpunkt för RTMFP-kommunikation mellan klient/server, i peer-to-peer-grupper och via IP Multicast.
• Skicka strängen "rtmfp:" för att skapa en dubbelriktad nätverksslutpunkt utan server för RTMFP IP-multicast-kommunikation.

Titta på följande säkerhetsmodell:

• Som standard nekar Flash Player och AIR åtkomst mellan sandlådor. På en webbplats kan åtkomst till en resurs aktiveras genom användning av en URL-principfil.
• Programmet kan neka åtkomst till en resurs på servern. I ett Flash Media Server-program ska du använda Server-Side ActionScript-kod för att neka åtkomst. Se även Flash Media Server documentation.
• Du kan inte använda NetConnection.connect() om den anropande filen körs i en lokal sandlåda i filsystemet.
• Du kan inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.
• Om du vill förhindra att metoden anropas av en SWF-fil ställer du in parametern allowNetworking i object- och embed-taggarna på den HTML-sida där SWF-innehållet finns.

I Adobe AIR begränsas emellertid inte innehåll i säkerhetssandlådan application (innehåll som installeras med AIR-programmet) av de här säkerhetsbegränsningarna.

Mer information om säkerhet finns i avsnittet Security på Adobe Flash Player Developer Center.

Parametrar

Relaterade API-element

Skickas om ett undantag inträffar asynkront, d.v.s. från ursprunglig asynkron kod.

Den här händelsen har följande egenskaper:

Skickas om ett in- eller utdatafel orsakar en misslyckad nätverksåtgärd.

Den här händelsen har följande egenskaper:

Skickas om objektet NetConnection ger en status- eller felrapport. Händelsen netStatus innehåller egenskapen info, vilket är ett informationsobjekt som innehåller specifik information om händelsen, t.ex. om en anslutning lyckades eller misslyckades.

Den här händelsen har följande egenskaper:

Relaterade API-element

Skickas om ett anrop till NetConnection.call() försöker ansluta till en server utanför anroparens säkerhetssandlåda.

Den här händelsen har följande egenskaper:

Relaterade API-element

I detta exempel är koden som skapar objekten Video och NetStream samt anropar metoderna Video.attachNetStream() och NetStream.play() placerad i en hanterarfunktion. Hanteraren anropas endast om anslutningsförsöket till objektet NetConnection lyckades; d.v.s. om händelsen netStatus returnerar ett info-objekt med egenskapen code som anger att anslutningen gick bra. Du rekommenderas att vänta tills anslutningen är genomförd innan du anropar 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);
    }
}