AVURLStream - Adobe ActionScript® 3 (AS3 ) API Başvurusu

Paket	flash.media
Sınıf	public class AVURLStream
Miras Alma	AVURLStream URLStream EventDispatcher Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

URLStream sınıfı indirilen URL'lere düşük düzeyli erişim sağlar. Veri, dosyanın tamamının URLLoader ile birlikte tamamlanmasını beklemek yerine indirildikten hemen sonra uygulama kodu tarafından kullanılabilir. URLStream sınıfı, indirilmesi tamamlanmadan önce bir akışı kapatmanızı sağlar. İndirilen dosyanın içindekiler, ham ikili veriler şeklinde kullanılabilir.

URLStream öğesindeki okuma işlemleri tıkanmasızdır. Başka bir deyişle, okumadan önce yeterli miktarda verinin olup olmadığını belirlemek için bytesAvailable özelliğini kullanabilirsiniz. Yeterli miktarda veri yoksa bir EOFError istisnası atılır.

İkili verilerin tümü, en önemli bayt ilk sırada olacak şekilde big-endian biçiminde kodlanır.

URLStream sınıfıyla birlikte URL indirme için geçerli olan güvenlik kuralları, URLLoader nesneleri için kullanılan kurallarla aynıdır. İlke dosyaları gerektiğinde indirilebilir. Yerel dosya güvenlik kuralları zorunlu kılınır ve gerektiğinde güvenlik uyarıları verilir.

İlgili API Öğeleri

URLLoader
URLRequest

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		bytesAvailable : uint [salt okunur] Girdi arabelleğindeki okunmak için bekleyen bayt sayısını döndürür.	URLStream
		connected : Boolean [salt okunur] Bu URLStream nesnesinin o anda bağlı olup olmadığını gösterir.	URLStream
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		cookieHeader : String [salt yazılır]	AVURLStream
		endian : String Veri için bayt sırasını belirtir.	URLStream
		objectEncoding : uint Bir nesneyi okurken veya yazarken kullanılan Action Message Format (AMF) sürümünü kontrol eder.	URLStream

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.	EventDispatcher
		close():void Hemen akışı kapatır ve indirme işlemini iptal eder.	URLStream
		dispatchEvent(event:Event):Boolean Olay akışına bir olay gönderir.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.	EventDispatcher
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		load(request:URLRequest):void [geçersiz kıl] request parametresinde belirtilen URL'yi indirmeye başlar.	AVURLStream
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		readBoolean():Boolean Akıştan bir Boolean değer okur.	URLStream
		readByte():int Akıştan işaretli bir bayt okur.	URLStream
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Akıştan uzunluk kadar bayt veri okur.	URLStream
		readDouble():Number Akıştan bir IEEE 754 çift kesinlikli kayar nokta sayısı okur.	URLStream
		readFloat():Number Akıştan bir IEEE 754 tek kesinlikli kayan nokta sayı okur.	URLStream
		readInt():int Akıştan işaretli bir 32 bitlik tam sayı okur.	URLStream
		readMultiByte(length:uint, charSet:String):String Bayt akışından, belirtilen karakter kümesini kullanarak belirtilen uzunlukta çok baytlı bir dize okur.	URLStream
		readObject():* Soketten gelen ve Action Message Format (AMF) olarak kodlanmış bir nesne okur.	URLStream
		readShort():int Akıştan işaretli bir 16 bitlik tam sayı okur.	URLStream
		readUnsignedByte():uint Akıştan işaretsiz bir bayt okur.	URLStream
		readUnsignedInt():uint Akıştan işaretsiz bir 32 bitlik tam sayı okur.	URLStream
		readUnsignedShort():uint Akıştan işaretsiz bir 16 bitlik tam sayı okur.	URLStream
		readUTF():String Akıştan bir UTF-8 dizesi okur.	URLStream
		readUTFBytes(length:uint):String Akıştan bir dizi uzunluk UTF-8 baytları okur ve bir dize döndürür.	URLStream
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher nesnesinden bir dinleyiciyi kaldırır.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object
		willTrigger(type:String):Boolean Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder.	EventDispatcher

Olaylar

Olaylarla ilgili daha fazla bilgi için tıklatın

Miras Alınan Olayları Gizle

Miras Alınan Olayları Göster

	Özet	Tanımlayan:
activate	[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.	EventDispatcher
complete	Veriler başarılı şekilde yüklendiğinde gönderilir.	URLStream
deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher
httpResponseStatus	URLStream.load() yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa ve Adobe AIR, istek için durum kodunu algılayıp döndürebiliyorsa gönderilir.	URLStream
httpStatus	URLStream.load() çağrısı HTTP üzerinden verilere erişmeye çalışıyorsa ve Flash Player veya Adobe AIR istek için durum kodunu algılayabiliyor ve döndürebiliyorsa gönderilir.	URLStream
ioError	Bir yükleme işleminin başarısız olmasına neden olan bir girdi/çıktı hatası ortaya çıktığında gönderilir.	URLStream
open	Bir yükleme işlemi başladığında gönderilir.	URLStream
progress	İndirme işlemi ilerlerken veri alındığında gönderilir.	URLStream
securityError	URLStream.load() öğesine yapılan bir çağrı, güvenlik sanal alanının dışındaki bir sunucudan veri yüklemeye çalıştığında gönderilir.	URLStream

Özellik Ayrıntısı

cookieHeader

özellik

cookieHeader:String [salt yazılır]

Uygulama
public function set cookieHeader(value:String):void

Yöntem Ayrıntısı

load

()

yöntem

override public function load(request:URLRequest):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

request parametresinde belirtilen URL'yi indirmeye başlar.

Not: İndirilen bir dosya ASCII olmayan karakterler içeriyorsa (İngilizce dışındaki birçok dilde görüldüğü gibi) dosyayı, ASCII gibi Unicode olmayan bir biçimin aksine UTF-8 veya UTF-16 kodlamasıyla kaydetmeniz önerilir.

Yükleme işlemi anında başarısız oluyorsa, hatayı açıklayan bir IOError veya SecurityError (yerel dosya güvenlik hatası da dahil) istisnası atılır. Aksi halde URL indirmesi, indirme işlemini başarıyla başlatıyorsa bir open olayı gönderilir veya bir hata oluşması durumunda bir error olayı gönderilir.

Varsayılan olarak, çağıran SWF dosyası ve yüklediğiniz URL tamamen aynı etki alanında olmalıdır. Örneğin www.adobe.com adresindeki bir SWF dosyası yalnızca www.adobe.com adresinde bulunan kaynaklardan veri yükleyebilir. Farklı bir etki alanından veri yüklemek için, verileri barındıran sunucuya bir URL ilke dosyası yerleştirin.

Flash Player'da genel olarak rezerve edilen 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.

Flash Player ve sonrasında SWF içeriğini kapsayan HTML sayfasındaki object ve embed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz.

Flash Player 10 ve daha sonrası ile AIR 1.5 ve daha sonrasında, yükleme (POST gövdesi içinde "content-disposition" başlığında "filename" parametresiyle belirtilir) içeren çok bölümlü bir Content-Type (örneğin, "multipart/form-data") kullanıyorsanız, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabidir.

Fare tıklatma veya tuş basışı gibi kullanıcı tarafından başlatılan bir eyleme yanıt olarak POST işleminin gerçekleştirilmesi gerekir.
POST işlemi etki alanları arasıysa (POST hedefi, POST isteğini gönderen SWF dosyasıyla aynı sunucuda değilse), hedef sunucunun etki alanları arası erişime izin veren bir URL ilke dosyası sağlaması gerekir.

Ayrıca çok bölümlü herhangi bir Content-Type için sözdiziminin geçerli olması gerekir (RFC2046 standartlarına göre). Sözdizimi geçersiz görünüyorsa, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabi olur.

Bu kurallar, uygulama dışı sanal alanlardaki AIR içeriğine de uygulanır. Ancak, Adobe AIR'da uygulama sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kullanılmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Developer Center Konusu: Güvenlik.

AIR'da, bir URLRequest nesnesi httpResponse durum olayı için kaydedilebilir. httpStatus olayından farklı olarak, httpResponseStatus olayı herhangi bir yanıt verisinden önce teslim edilir. Ayrıca, httpResponseStatus olayı, responseHeaders ve responseURL özelliklerine yönelik değerleri (httpStatus olayı için tanımsızdır) içerir. httpResponseStatus olayının (varsa) herhangi bir complete veya error olayından önce (ve buna ek olarak) gönderileceğini unutmayın.

Bir httpResponseStatus olay dinleyicisi bulunuyorsa, yanıt mesajının gövdesi her zaman gönderilir; ve HTTP durum kodu yanıtları her zaman bir complete olayıyla sonuçlanır. Bu, HTTP yanıt durumu bir başarıyı da bir hatayı da gösterse geçerlidir.

AIR'da, httpResponseStatus olay dinleyicisi bulunmuyorsa, davranış SWF sürümüne göre değişir:

SWF 9 içeriği için, HTTP yanıt mesajının gövdesi yalnızca HTTP yanıt durumu başarıyı gösterdiğinde gönderilir. Aksi takdirde (hata varsa), gövde gönderilmez ve URLRequest nesnesi bir IOError olayı gönderir.
SWF 10 içeriği için, HTTP yanıt mesajının gövdesi her zaman gönderilir. Hata oluştuğunda, URLRequest nesnesi bir IOError olayı gönderir.

Parametreler

request:URLRequest — İndirilecek URL'yi belirten bir URLRequest nesnesi. Bu parametrenin değeri veya iletilen URLRequest nesnesinin URLRequest.url özelliği null ise uygulama bir boş işaretçi hatası atar.

Olaylar

	`complete:Event` — Veriler başarılı şekilde yüklendikten sonra gönderilir. Bir `httpResponseStatus` olay dinleyicisi varsa, HTTP yanıt durumu bir başarıyı veya bir hatayı gösterdiğinde, URLRequest nesnesi ayrıca bir `complete` olayı gönderir.

	`httpStatus:HTTPStatusEvent` — HTTP tarafından erişim gerçekleşirse ve geçerli ortam durum kodlarını almayı desteklerse, bir `complete` veya `error` olayının yanı sıra bu olayları da alabilirsiniz.

	`httpResponseStatus:HTTPStatusEvent` — `load()` yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa ve Adobe AIR, istek için durum kodunu algılayıp döndürebiliyorsa gönderilir.

	`ioError:IOErrorEvent` — Yükleme işlemi tamamlanamadı.

	`open:Event` — Bir yükleme işlemi başladığında gönderilir.

	`securityError:SecurityErrorEvent` — Bir yükleme işlemi, arayanın güvenlik sanal alanının dışındaki bir sunucudan veri almaya çalıştı. Bu sorun, sunucu üzerinde bir ilke dosyası kullanarak çözülebilir.

Atar

	`ArgumentError` — `URLRequest.requestHeader` nesneleri yasaklanmış belirli HTTP istek üstbilgilerini içermeyebilir. Daha fazla bilgi için, URLRequestHeader sınıfı açıklamasına bakın.

	`MemoryError` — Bu hata, şu nedenlerden dolayı meydana gelebilir: Flash Player veya Adobe AIR, `URLRequest.data` parametresini UTF8'den MBCS'ye dönüştüremiyor. Bu hata, `load()` öğesine iletilen URLRequest nesnesinin bir `GET` işlemi gerçekleştirecek şekilde ayarlanması ve `System.useCodePage` öğesinin `true` olarak ayarlanması durumunda ortaya çıkabilir. Flash Player veya Adobe AIR, `POST` verileri için bellek ayıramıyor. Bu hata, load öğesine iletilen URLRequest nesnesinin bir `POST` işlemi gerçekleştirecek şekilde ayarlanması durumunda meydana gelebilir.

	`SecurityError` — Güvenilmeyen yerel SWF dosyaları İnternet ile iletişim kuramayabilir. Bu sorun SWF dosyası ağa sahip yerel veya güvenilir olarak yeniden sınıflandırılarak çözülebilir.

	`SecurityError` — Ortak olarak ayrılmış bir bağlantı noktasına bağlanmayı deniyorsunuzdur. 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.

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

AVURLStream - AS3

Paketlerx

Dil Öğeleri

Ekler

Paket flash.media

cookieHeader

load