NetConnection  - AS3

Üzerinde geri çağırma yöntemlerinin çağrıldığı nesneyi gösterir. Varsayılan öğe NetConnection öğesidir. client özelliğini başka bir nesneye ayarlarsanız, geri çağırma yöntemleri bu diğer nesne üzerinde çağrılır.

Uygulamanın sunucuya kalıcı bir RTMP bağlantısı aracılığıyla bağlanıp (true) bağlanmadığını (false) gösterir. HTTP üzerinden bağlandığında, bir uygulama sunucusu üzerinde Flash Remoting hizmetlerine bağlı olması (bu durumda true) dışında bu özellik false değerindedir.

Flash Media Server ile başarılı bir bağlantı kurmak için kullanılan proxy türü. Olası değerler şunlardır: "none", "HTTP", "HTTPS" veya "CONNECT".

Bağlantı tünelli değilse veya yerel bir SSL bağlantısı ise değer "none" olur.

Bağlantının tünellemesi HTTP üzerinden yapıldıysa değer "HTTP" olur.

Bağlantının tünellemesi HTTPS üzerinden yapıldıysa değer "HTTPS" olur,

Bağlantının tünellemesi bir proxy sunucusu üzerinden CONNECT yöntemi kullanılarak yapılmışsa değer "CONNECT" olur.

NetConnection nesneleri için varsayılan nesne kodlaması. Bir nesne ikili verilere yazıldığında veya buradan okunduğunda, defaultObjectEncoding özelliği verileri serileştirmek için hangi Action Message Format (AMF) sürümünün kullanıldığını gösterir: ActionScript 3.0 biçimi (ObjectEncoding.AMF3) veya ActionScript 1.0 ve ActionScript 2.0 biçimi (ObjectEncoding.AMF0).

Varsayılan değer ObjectEncoding.AMF3 şeklindedir. NetConnection.defaultObjectEncoding öğesinin değiştirilmesi varolan NetConnection örneklerini etkilemez; yalnızca daha sonra oluşturulan örnekleri etkiler.

Bir nesnenin kodlamasını ayrı olarak ayarlamak için (tüm uygulamaya yönelik nesne kodlamasını ayarlamak yerine), NetConnection nesnesinin objectEncoding özelliğini ayarlayın.

Daha ayrıntılı bilgi için objectEncoding özelliğinin açıklamasına bakın.

İlgili API Öğeleri

Bu Flash Player veya Adobe AIR örneğinin bağlı olduğu Flash Media Server örneğinin kimliği. Bu özellik yalnızca RTMFP bağlantıları için anlamlıdır. Bu özelliğin değeri yalnızca bir RTMFP bağlantısı kurulduktan sonra kullanılabilir.

İlgili API Öğeleri

Daha sonra Flash Media Server tarafından seçilen ve bu bağlantı için benzersiz olan değer. Bu değer sunucuya kendi client.nearNonce değeri olarak görünür. Bu değer yalnızca RTMFP, RTMPE ve RTMPTE bağlantıları için tanımlanır.

HTTP yanıtının bekleneceği milisaniye cinsinden süre. Varsayılan değer sıfırdır.

• httpIdleTimeout değeri bir Number öğesidir.
• HTTP bağlantısı kullanılırken, pozitif bir değer, etkin olmayan bir bağlantının açık kalacağı milisaniye sayısını belirtir.
• Sıfır değeri, platform için varsayılan ağ boşta kalma zaman aşımı değerinin kullanılacağını belirtir.
• Negatif değer bir RangeError ile sonuçlanır.
• httpIdleTimeout değeri aşılırsa, bir netStatus olayı gönderilir.
• Bu özellik yalnızca HTTP bağlantıları ile oluşturulan NetConnection nesnelerini etkiler. RTMP, RTMFP veya diğer HTTP kanalları ile oluşturulan NetConnection nesneleri bu özellikten etkilenmeden kalır.

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

Bu Flash Player veya Adobe AIR örneğinin izin verdiği gelen ve giden eş bağlantılarının toplam sayısı. Varsayılan değer 8'dir.

Bu değer, yayıncı ile abone bağlantılarını ayırt etmez. Eş bağlantıları varken bu değer düşürülürse, yeni değer yalnızca yeni gelen bağlantıları etkiler. Varolan bağlantılar düşmez.

Bu NetConnection örneği için bu Flash Player veya Adobe AIR örneğinin kimliği. Bu özellik yalnızca RTMFP bağlantıları için anlamlıdır.

Her NetConnection örneğinin benzersiz bir nearID özelliği vardır. Hiçbir Flash Player veya Adobe AIR örneği ya da NetConnection örneği aynı kimliğe sahip olmaz.

Diğer Flash Player veya Adobe AIR örnekleri, bu istemcinin yeni NetStream bağlantıları için peerID olarak bu kimliği kullanır. Daha sonra bu kimlik, bu örneğe bağlanan herhangi bir eş NetStream'deki farID olur.

İlgili API Öğeleri

Daha sonra bu Flash Player veya Adobe AIR örneği tarafından seçilen ve bu bağlantı için benzersiz olan değer. Bu değer sunucuya kendi client.farNonce değeri olarak görünür. Bu değer yalnızca RTMFP, RTMPE ve RTMPTE bağlantıları için tanımlanır.

Bu NetConnection örneği için nesne kodlaması.

Bir nesne ikili verilere yazıldığında veya buradan okunduğunda, defaultObjectEncoding özelliği verileri serileştirmek için hangi Action Message Format (AMF) sürümünün kullanıldığını gösterir: ActionScript 3.0 biçimi (ObjectEncoding.AMF3) veya ActionScript 1.0 ve ActionScript 2.0 biçimi (ObjectEncoding.AMF0). Bir NetConnection örneğine yönelik bir AMF sürümü ayarlamak için objectEncoding özelliğini ayarlayın.

Uygulamanızın Flash Player 9'dan önce piyasaya sürülmüş sunucularla iletişime geçmesi gerekiyorsa bu özelliği anlamanız önemlidir. Şu üç senaryo olasıdır:

• AMF3'ü (örneğin Flex Data Services 2 veya Flash Media Server 3) destekleyen bir sunucuya bağlanma. defaultObjectEncoding öğesinin varsayılan değeri ObjectEncoding.AMF3 şeklindedir. Bu dosyada oluşturulan tüm NetConnection örnekleri, AMF3 serileştirmesini kullanır, yani objectEncoding özelliğini ayarlamanız gerekmez.
• AMF3'ü desteklemeyen bir sunucuya (örneğin, Flash Media Server 2) bağlanma. Bu senaryoda statik NetConnection.defaultObjectEncoding özelliğini ObjectEncoding.AMF0 olarak ayarlayın. Bu SWF dosyasında oluşturulan tüm NetConnection örnekleri AMF0 serileştirmesini kullanır. objectEncoding özelliğini ayarlamanız gerekmez.
• Farklı kodlama sürümleri kullanan birden çok sunucuya bağlanma. defaultObjectEncoding öğesini kullanmak yerine, her bağlantı için objectEncoding özelliğini kullanarak nesne kodlamasını bağlantı başına temelinde ayarlayın. Flash Media Server 2 gibi AMF0 kodlamasını kullanan sunuculara bağlanmak için bu öğeyi ObjectEncoding.AMF0 olarak ayarlayın ve Flex Data Services 2 gibi AMF3 kodlamasını kullanan sunuculara bağlanmak için bu öğeyi ObjectEncoding.AMF3 olarak ayarlayın.

Bir NetConnection örneği bağlandığında, objectEncoding özelliği salt okunur olur.

Sunucuya bağlanmak için yanlış kodlamayı kullanıyorsanız, NetConnection nesnesi netStatus olayını gönderir. NetStatusEvent.info özelliği, code özelliği değeri NetConnection.Connect.Failed olan bir bilgi nesnesi ve nesne kodlamasının yanlış olduğunu belirten bir açıklama içerir.

İlgili API Öğeleri

Bağlantı kurmak için kullanılan protokol. Bu özellik, Flash Media Server kullanılırken uygundur. Olası değerler şunlardır:

• "rtmp": Gerçek Zamanlı Mesajlaşma Protokolü (RTMP)
• "rtmpe": Şifrelenmiş RTMP
• "rtmpt": HTTP tünel oluşturma RTMP
• "rtmpte": HTTP tünel oluşturma şifrelenmiş RTMP
• "rtmps": HTTPS temelli RTMP
• "rtmfp": Gerçek Zamanlı Medya Akışı Protokolü (RTMFP)

Flash Media Server'a yapılan ilk bağlantı denemesi başarısız olursa hangi yardımcı yöntemlerin deneneceğini belirler. NetConnection.connect() yöntemini çağırmadan önce proxyType özelliğini ayarlayın.

Kabul edilebilir değerler "none", "HTTP", "CONNECTOnly", "CONNECT" ve "best" değerleridir. Varsayılan değer "none" değeridir.

Yerel SSL'yi kullanmak için, özelliği "best" olarak ayarlayın. Oynatıcı sunucuyla doğrudan bağlantı kuramıyorsa (varsayılan olan 443 bağlantı noktası veya belirlediğiniz başka bir bağlantı noktası üzerinden) ve bir proxy sunucusu varsa, oynatıcı CONNECT yöntemini kullanmayı dener. Bu deneme başarısız olursa, oynatıcı HTTPS üzerinden tünelleme yapar.

Özellik, "CONNECTOnly" olarak ayarlandıysa oynatıcı CONNECT yöntemini önce kullanmayı dener. Bu işlem başarısız olursa geri dönüş olmaz.

Özellik "HTTP" olarak ayarlanırsa ve bir doğrudan bağlantı başarısız olursa, HTTP tünellemesi kullanılır. Özellik "CONNECT" olarak ayarlanırsa ve bir doğrudan bağlantı başarısız olursa CONNECT tünelleme yöntemi kullanılır. Bu işlem başarısız olursa bağlantı, HTTP tünellemesine başlamaz.

Bu özellik, yalnızca RTMP, RTMPS veya RTMPT kullanılırken uygulanabilir. CONNECT ve CONNECTOnly yöntemleri yalnızca bir proxy sunucusu ile ağa bağlı olan kullanıcılar için uygulanabilir.

Yayıncı NetStream nesneleriyle ilgili olmayan tüm katılımcı abone NetStream nesnelerini tutan bir nesne. Yayın NetStream nesneleriyle ilişkilendirilmiş abone NetStream nesneleri, NetStream.peerStreams dizisinde bulunur.

İlgili API Öğeleri

NetConnection.connect() yöntemine iletilen URI. NetConnection.connect() çağrılmamışsa veya herhangi bir URI iletilmemişse, bu özellik undefined olur.

Güvenli bir bağlantının HTTPS yerine yerel Transport Layer Security (Taşıma Katmanı Güvenliği) (TLS) ile kurulup kurulmadığını gösterir. Bu özellik yalnızca bir NetConnection nesnesi bağlandığında geçerlidir.

Bir NetConnection nesnesi oluşturur. Bir bağlantı yapmak için connect() öğesini çağırın.

Uygulamanın Flash Player 9'dan önce piyasaya sürülen sunucularla iletişime geçmesi gerekiyorsa, NetConnection nesnesinin objectEncoding özelliğini ayarlayın.

Şu kod bir NetConnection nesnesi oluşturur.

     var nc:NetConnection = new NetConnection();
     

İlgili API Öğeleri

Action Message Format (AMF) paket yapısına bir bağlam üstbilgisi ekler. Bu üstbilgi daha sonraki her AMF paketiyle birlikte gönderilir. Aynı adı kullanarak NetConnection.addHeader() öğesini çağırırsanız yeni üstbilgi varolan üstbilginin yerine geçer ve yeni üstbilgi, NetConnection nesnesinin süresi boyunca kalıcı olur. Tanımlanmamış bir nesneyi kaldırmak için üstbilginin adına sahip NetConnection.addHeader() öğesini çağırarak bir üstbilgiyi kaldırabilirsiniz.

Parametreler

Flash Media Server veya Flash Remoting uygulamasının çalıştığı bir uygulama sunucusu üzerinde bir komut veya yöntem çağırır. NetConnection.call() öğesini çağırmadan önce sunucuya bağlanmak için NetConnection.connect() öğesini çağırmalısınız. Bu yönteme iletmek için sunucu taraflı bir işlev oluşturmalısınız.

Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.

Parametreler

İlgili API Öğeleri

Yerel olarak veya sunucu ile yapılmış bağlantıyı keser ve NetConnection.Connect.Closed öğesinin code özelliği ile bir netStatus olayını gönderir.

Bu yöntem, bağlantı üzerinde çalışan tüm NetStream nesnelerinin bağlantısını keser. Gönderilmemiş sıralanan verilerin tümü atılır. (Bağlantıyı kapatmadan yerel akışları veya sunucu akışlarını sonlandırmak için NetStream.close() öğesini kullanın.) Bağlantıyı kapatıp ardından yeni bir bağlantı oluşturmak isterseniz, yeni bir NetConnection nesnesi oluşturupconnect() yöntemini tekrar çağırmalısınız.

close() yöntemi ayrıca bu bağlantı üzerinde çalışan tüm uzak paylaşılan nesnelerin bağlantısını keser. Ancak yeniden bağlanmak için paylaşılan nesneyi yeniden oluşturmanız gerekmez. Bunun yerine, paylaşılan nesneyle yeniden bağlantı kurmak için SharedObject.connect() öğesini çağırmanız yeterlidir. Ayrıca NetConnection.close() komutunu verdiğinizde sıraya alınmış olan paylaşılan nesnedeki tüm veriler, paylaşılan nesneyle yeniden bağlantı kurulduktan sonra gönderilecektir.

Flash Media Server'da, istemcinin artık sunucuya bağlanması gerekmediğinde en iyi geliştirme uygulaması close() öğesini çağırmaktır. close() öğesinin çağrılması, kullanılmayan bağlantıları temizlemenin en hızlı yoludur. Sunucuyu, boşta kalan bağlantıları bir yedekleme önlemi olarak otomatik olarak kapatacak şekilde konfigüre edebilirsiniz. Daha fazla bilgi için Flash Media Server Configuration ve Administration Guide konularına bakın.

İlgili API Öğeleri

Flash Media Server üzerinde bir uygulamaya veya Flash Remoting uygulamasına iki yönlü bir bağlantı oluşturur veya RTMFP eşler arası grup iletişimi için iki yönlü bir ağ uç noktası oluşturur. Durumunu veya hata koşulunu bildirmek için, NetConnection.connect() öğesi bir netStatus olayı dağıtır.

Aşağıdakileri yapmak için NetConnection.connect() öğesini çağırın:

• Yerel dosya sisteminden veya web sunucusundan video ve MP3 dosyalar oynatmak için "null" öğesini iletin.
• Flash Remoting ile çalışan bir uygulama sunucusuna bağlanmak için bir "http" URL'si iletin. Bir NetConnection üzerinde işlevleri çağırmak ve uygulama sunucularından sonuçlar döndürmek için NetServices sınıfını kullanın. Daha fazla bilgi için, bkz. Flash Remoting belgeleri.
• Bir Flash Media Server uygulamasına bağlanmak için bir "rtmp/e/s" URL'si iletin.
• RTMFP istemci sunucusu, eşler arası ve IP çoklu yayın iletişimi için bir iki yönlü ağ uç noktası oluşturmak için bir "rtmfp" URL'si iletin.
• RTMFP IP çoklu yayın iletişimi için sunucusuz, iki yönlü bir ağ uç noktası oluşturmak için "rtmfp:" dizesini iletin.

Aşağıdaki güvenlik modelini göz önünde bulundurun:

• Varsayılan olarak, Flash Player veya AIR, sanal alanlar arasında erişime izin vermez. Bir web sitesi, URL ilke dosyası kullanılarak bir kaynağa erişilmesini sağlayabilir.
• Uygulamanız, sunucu üzerindeki bir kaynağa erişimi reddedebilir. Flash Media Server uygulamasında erişimi reddetmek için, Sunucu Tarafı ActionScript kodunu kullanın. Bkz. Flash Media Server belgeleri.
• Çağıran dosya, dosya sistemine sahip yerel sanal alandaysa, NetConnection.connect() öğesini çağıramazsınız.
• Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.
• Bir SWF dosyasının bu yöntemi kullanmasını önlemek için, SWF içeriğini kapsayan HTML sayfasındaki object ve embed etiketlerinin allowNetworking parametresini ayarlayın.

Ancak Adobe AIR'de, application güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için bkz. Adobe Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Parametreler

İlgili API Öğeleri

Eşzamansız olarak, yani yerel eşzamansız koddan bir istisna atıldığında gönderilir.

Bu olay şu özelliklere sahiptir:

Bir ağ işleminin başarısız olmasına neden olan bir girdi veya çıktı hatası ortaya çıktığında gönderilir.

Bu olay şu özelliklere sahiptir:

Bir NetConnection nesnesi durumunu veya hata koşulunu bildirirken gönderilir. netStatus olayı bir info özelliği içerir. Bu özellik, bir bağlantı denemesinin başarılı olup olmaması gibi olay hakkında belirli bilgiler içeren bir bilgi nesnesidir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

NetConnection.call() öğesine yapılan bir çağrı, çağıranın güvenlik sanal alanının dışındaki bir sunucuya bağlanma girişiminde bulunduğunda gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bu örnekte, Video ve NetStream nesnelerini oluşturan ve Video.attachNetStream() ve NetStream.play() yöntemlerini çağıran kod bir işleyici işlevine yerleştirilir. İşleyici yalnızca, NetConnection nesnesine bağlanmak için yapılan denemenin başarılı olması durumunda; yani netStatus olayı, başarılı olunduğunu gösteren codeözelliğine sahip bir info nesnesi döndürdüğünde çağrılır. NetStream.play() öğesini çağırmadan önce başarılı bir bağlantı yapılmasını beklemeniz önerilir.

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