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

Paket	flash.media
Sınıf	public class MediaPromise
Miras Alma	MediaPromise EventDispatcher Object
Uygular	IFilePromise

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

MediaPromise sınıfı, bir medya nesnesinin sunulacağına yönelik sözü temsil eder.

Bir MediaEvent nesnesinin data özelliği bir MediaPromise örneğidir. Söz verilen medya nesnesine erişmek için MediaPromise yöntemlerini kullanabilirsiniz. Desteklenen medya biçimleri arasında hareketsiz görüntüler ve videolar vardır.

Bir MediaPromise nesnesi oluşturamazsınız. new MediaPromise() öğesinin çağrılması bir çalışma zamanı hatası oluşturur.

İlgili API Öğeleri

MediaEvent
IFilePromise
Loader.LoadFilePromise()
IDataInput
CameraRoll.browseForImage()
CameraUI

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		file : File [salt okunur] Medya nesnesini temsil eden File örneği (varsa).	MediaPromise
		isAsync : Boolean [salt okunur] Temel veri kaynağının eşzamanlı veya eşzamansız olup olmadığını bildirir.	MediaPromise
		mediaType : String [salt okunur] Genel medya türü, görüntü veya video.	MediaPromise
		relativePath : String [salt okunur] Medya nesnesinin dosya adı (varsa).	MediaPromise

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 Veri kaynağını kapatır.	MediaPromise
		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
		open():IDataInput Temel veri kaynağını açar ve bu kaynağı okumanıza olanak veren IDataInput örneğini döndürür.	MediaPromise
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher nesnesinden bir dinleyiciyi kaldırır.	EventDispatcher
		reportError(e:ErrorEvent):void Çalışma zamanı tarafından hata bildirmek için kullanılır.	MediaPromise
		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
close	Temel veri akışı kapatıldığında bir MediaPromise nesnesi bir close olayı gönderir.	MediaPromise
complete	MediaPromise nesnesi, tüm veriler okunduğunda bir complete olayı gönderir.	MediaPromise
deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher
ioError	Temel veri akışı okunurken bir hatayla karşılaşıldığında MediaPromise nesnesi bir ioError olayı gönderir.	MediaPromise
progress	Veri kullanılabilir olduğunda bir MediaPromise nesnesi progress olayları gönderir.	MediaPromise

Özellik Ayrıntısı

file

özellik

file:File [salt okunur]

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Medya nesnesini temsil eden File örneği (varsa).

Temel veri kaynağının dosya tabanlı olması ve dosyanın uygulamanız için erişilebilir olması halinde bu özellik bir File nesnesine başvuru yapar. Aksi halde, özellik null olur.

Uygulama
public function get file():File

isAsync

özellik

isAsync:Boolean [salt okunur]

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Temel veri kaynağının eşzamanlı veya eşzamansız olup olmadığını bildirir.

Uygulama
public function get isAsync():Boolean

mediaType

özellik

mediaType:String [salt okunur]

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Genel medya türü, görüntü veya video.

MediaType sınıfındaki sabitler bu özelliğin olası değerlerini tanımlar:

MediaType.IMAGE
MediaType.VIDEO

Uygulama
public function get mediaType():String

İlgili API Öğeleri

MediaType

relativePath

özellik

relativePath:String [salt okunur]

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Medya nesnesinin dosya adı (varsa).

Temel veri kaynağının dosya tabanlı olması ve dosyanın uygulamanız için erişilebilir olması halinde bir dosya adı mevcut olur. Aksi halde, özellik null olur.

Uygulama
public function get relativePath():String

Yöntem Ayrıntısı

close

()

yöntem

public function close():void

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Veri kaynağını kapatır.

open

()

yöntem

public function open():IDataInput

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Temel veri kaynağını açar ve bu kaynağı okumanıza olanak veren IDataInput örneğini döndürür.

Temel veri kaynağı eşzamansız olursa, MediaPromise nesnesi okunacak verilerin olup olmadığını belirtmek için progress ve complete olayları gönderir. Veri kaynağı eşzamanlı olursa, tüm veriler derhal kullanılabilir olur ve bu olaylar gönderilmez.

Not: Verileri el ile okumak yerine, Loader sınıfının loadFilePromise() yöntemini kullanarak bir MediaPromise nesnesi yükleyebilirsiniz.

Döndürür

IDataInput

İlgili API Öğeleri

Loader.loadFilePromise()

reportError

()

yöntem

public function reportError(e:ErrorEvent):void

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Çalışma zamanı tarafından hata bildirmek için kullanılır.

Uygulama kodu bu yöntemi çağırmamalıdır.

Parametreler

e:ErrorEvent — gönderilecek error olayı.

Olay Ayrıntısı

close

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.CLOSE

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Temel veri akışı kapatıldığında bir MediaPromise nesnesi bir close olayı gönderir.

Event.CLOSE sabiti, close olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	Bağlantısı kapatılan nesne.

complete

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.COMPLETE

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

MediaPromise nesnesi, tüm veriler okunduğunda bir complete olayı gönderir. Olay, temel akışta daha fazla verinin bulunmadığını gösterir.

Eşzamanlı bir veri kaynağı tarafından bir complete olayı gönderilmez.

Event.COMPLETE sabiti, complete olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	Yüklemesi tamamlanan network nesnesi.

ioError

Olay

Olay Nesne Türü: flash.events.IOErrorEvent
özellik IOErrorEvent.type = flash.events.IOErrorEvent.IOERROR

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Temel veri akışı okunurken bir hatayla karşılaşıldığında MediaPromise nesnesi bir ioError olayı gönderir. Bu olay gönderildikten sonra daha fazla veri okunamaz.

progress

Olay

Olay Nesne Türü: flash.events.ProgressEvent
özellik ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Dil Sürümü:

ActionScript 3.0

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

AIR 2.5

Veri kullanılabilir olduğunda bir MediaPromise nesnesi progress olayları gönderir.

Sonuncu olay dışındaki tüm progress olaylarının bytesTotal özelliği 0 değerine sahiptir. Tüm veriler derhal kullanılabilir olursa progress olayları gönderilmeyebilir. Eşzamanlı veri kaynakları tarafından progress olayları gönderilmez.

Bir progress olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`bytesLoaded`	Dinleyici olayı işlerken yüklenen öğe veya bayt sayısı.
`bytesTotal`	Yükleme işlemi başarılı olursa yüklenecek toplam öğe veya bayt sayısı.
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	İlerlemeyi bildiren nesne.

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

MediaPromise - AS3

Sınıflar x

file

isAsync

mediaType

relativePath

close

open

reportError

close

complete

ioError

progress