VideoPlayer  - AS3 Flash

Videonun, registrationX, registrationY, registrationWidth ve registrationHeight özelliklerine göre nasıl görüntüleneceğini belirtir. scaleMode özelliği VideoScaleMode.MAINTAIN_ASPECT_RATIO veya VideoScaleMode.NO_SCALE olarak ayarlandığında align özelliği bu otomatik mizanpajı yapar. Bir FLV dosyası yüklendikten sonra bu özelliğin değiştirilmesi, otomatik bir mizanpajın hemen başlamasına neden olur. Değerler VideoAlign sınıfından gelir.

Varsayılan değer şudur VideoAlign.CENTER.

İlgili API Öğeleri

true olduğunda, oynatıcı akışın sonuna ulaştığından veya stop() yöntemi çağrıldığından dolayı oynatma durdurulduğunda FLV dosyasının Kare 1'e geri sarılmasına neden olan bir Boolean değeri. Canlı akışlar için bu özellik anlamsızdır.

Varsayılan değer şudur false.

Bir video akışı oynatılmaya başlamadan önce arabelleğe alınacak saniye sayısını belirten bir sayı. RTMP üzerinden akışa alınan ve indirilmeyip yalnızca arabelleğe alınan FLV dosyaları için bu ayarın varsayılan 0,1 değerinden daha yüksek bir değere çıkarılması önemli olabilir. HTTP üzerinden aşamalı şekilde indirilen bir FLV dosyası için bu değerin artırılması daha eski ve yavaş bilgisayarlarda yüksek kaliteli video görüntülemeyi iyileştirebilse de, çok düşük düzeyde önem taşır.

Önceden kaydedilmiş (canlı olmayan) video için bufferTime özelliğini 0 değerine ayarlamayın; varsayılan arabellek süresini kullanın veya arabellek süresini artırın.

Bu özellik, FLV dosyasının oynatma başlamadan önce indirilecek miktarını belirtmez.

İlgili API Öğeleri

HTTP indirmesinin indirme kapsamını bayt sayısı olarak belirten bir sayı. Akış olmadığında, akış Flash Media Server'dan (FMS) olduğunda veya henüz bilgi bulunmadığında 0 döndürür. Döndürülen değer yalnızca HTTP indirme için kullanışlıdır.

HTTP indirme için indirilen toplam bayt sayısını belirten bir sayı. Akış olmadığında, akış Flash Media Server'dan (FMS) olduğunda veya henüz bilgi bulunmadığında -1 döndürür. Döndürülen değer yalnızca HTTP indirme için kullanışlıdır.

VideoPlayer örneğinin yüksekliğini belirleyen bir sayı (piksel cinsinden).

Not: Bu özelliği, fl.video.VideoPlayer.videoHeight özelliğine benzeyen flash.media.Video.height özelliğiyle karıştırmayın.

İlgili API Öğeleri

Oynatmanın duraklatılması veya durdurulması nedeniyle Flash, Flash Media Server gibi bir video sunucusuna yapılan boştaki bağlantıyı sonlandırmadan önce geçecek milisaniye cinsinden süre. Bu özelliğin, HTTP üzerinden indirilen FLV dosyasında herhangi bir etkisi yoktur.

Bu özellik, video akışı zaten boştayken ayarlanırsa, yeni değerle birlikte zaman aşımı süresini yeniden başlatır.

Tüm VideoPlayer nesnelerinin varsayılan INCManager uygulaması olarak özel sınıfınızı kullanmasını sağlamak için iNCManagerClass özelliğini, sınıf nesnesine veya özel sınıfınızın dize adına ayarlayın. FLVPlayback sınıfı, özel sınıfın tanımını içerirken, video oynatıcı bu tanımı içermez.

Varsayılan değer dize olarak "fl.video.NCManager" öğesidir.

Video akışı canlıysa true olan bir Boolean değeri. Bu özellik ancak Flash Media Server veya diğer Flash Video Akış Hizmeti gibi bir video sunucusundan akışa alınırken etkilidir. HTTP indirme için bu özelliğin değeri yok sayılır.

Önceden kaydedilmiş bir video akışını video oynatıcıya gönderirken isLive özelliğini false değerine ve canlı yayın gibi gerçek zamanlı verileri gönderirken true değerine ayarlayın. isLive özelliğini false değerine ayarladığınızda daha iyi performans elde etmek için, bufferTime özelliğini 0 değerine ayarlamayın.

İlgili API Öğeleri

FLV dosyası RTMP kullanılarak bir Flash Media Server'dan (FMS) akışa alınıyorsa true olan bir Boolean değeri. Diğer tüm FLV dosya kaynakları için bunun değeri false olur.

İlgili API Öğeleri

Varsa, NetSteam.onMetaData() geri çağırma yöntemine yapılan bir çağrıdan alınan meta veri bilgi paketi olan nesne. metadataReceived olayı gönderilirken hazırdır.

FLV dosyası Flash 8 kodlayıcısıyla kodlanırsa, metadata özelliği şu bilgileri içerir. Eski FLV dosyaları yalnızca height, width ve duration değerlerini içerir.

İlgili API Öğeleri

INCManager uygulayan sınıfın bir örneğine erişim sağlayan INCManager (NCManager sınıfının arabirimi) nesnesi.

Özel başlatma gerektiren özel bir INCManager uygulamak için bu özelliği kullanabilirsiniz.

İlgili API Öğeleri

Video oynatıcı tarafından oluşturulan NetConnection örneğine doğrudan erişilmesini sağlar.

Video oynatıcı tarafından oluşturulan NetStream örneğine doğrudan erişilmesini sağlar.

NetStream öğesinin client özelliği için bir özel sınıf kaydeder. Varsayılan olarak, fl.video.VideoPlayerClient kullanılır; bu sınıf onMetaData() ve onCuePoint() mesajlarını işler. Diğer mesajlar için onImageData() ve onTextData() gibi özel işleme eklemek üzere kendi sınıfınızı oluşturabilir ve bu özelliği sınıfa ayarlayabilirsiniz.

Sınıf yapıcısının tek parametresi olarak VideoPlayer örneğini alması ve bir Boolean ready özelliğine sahip olması gerekir. Client, dosyanın başında beklenen veri mesajlarını halen beklerken bu özellik false olmalıdır. Bu mesajlar alınmadan önce VideoPlayer, yeniden boyutlandırma otomatik geri sarma işlemi yaparsa, bu mesajlar asla alınamaz. Varsayılan olarak, onMetaData() öğesi çağrılır çağrılmaz fl.video.VideoPlayerClient öğesi ready özelliğinden true değerini döndürür.

Bu özelliği sınıf nesnesine (aşağıdaki örnekte görüldüğü gibi) veya sınıfın dize adına ayarlayabilirsiniz:

        import fl.video.
        VideoPlayer.netStreamClientClass = MyCustomClient;
        

Sınıfı SWF dosyasına derlenmeye zorlamak için bu özelliği sınıfın dize adına ayarlamanın tek başına yeterli olmayacağını unutmayın. Varsayılan değer dize adı değil, fl.video.VideoPlayerClient sınıf nesnesidir.

Tüm özel uygulamaların fl.video.VideoPlayer alt sınıfı olması önerilir. Aksi takdirde, VideoPlayer ve FLVPlayback bileşeninde yerleşik olarak bulunan meta verinin ve işaret noktası işlemenin bozulması riski vardır.

Varsayılan değer şudur fl.video.VideoPlayerClient.

Küçük bir değer olabilen ve geçerli oynatma kafası zamanını veya konumunu yansıtan saniye cinsinden bir sayı. Bu özelliğin ayarlanması aramayı tetikler ve tüm arama kısıtlamalarını içerir.

Oynatma kafası zamanı değiştiğinde (FLV dosyası oynatılırken 0,25 saniyede bir), bileşen playheadUpdate olayını gönderir.

Birçok nedenden dolayı, playheadTime özelliği seek yöntemlerinden biri çağrıldıktan veya playheadTime öğesi aramaya neden olacak şekilde ayarlandıktan hemen sonra beklenen değere sahip olmayabilir. Öncelikle aşamalı indirme için yalnızca bir anahtar kareye kadar arama yapabilirsiniz, böylece arama sizi belirtilen zamandan sonraki ilk anahtar karenin zamanına götürür. (Akışa alırken, kaynak FLV dosyası tam belirtilen zamanda bir anahtar kare içermese de, arama tam belirtilen zamana gider.) İkinci olarak, arama eşzamansızdır, böylece bir seek yöntemi çağırırsanız veya playheadTime özelliğini ayarlarsanız, playheadTime hemen güncellenmez. Arama tamamlandıktan sonraki zamanı almak için, playheadTime özelliği güncelleninceye kadar tetiklenmeyen seek olayını dinleyin.

İlgili API Öğeleri

Her playheadUpdate olayı arasındaki süreyi milisaniye cinsinden belirten bir sayı. FLV dosyası oynatılırken bu özelliğin ayarlanması zamanlayıcıyı yeniden başlatır.

ActionScript işaret noktaları oynatma kafası güncellemelerinde başladığından, playheadUpdateInterval özelliği değerinin düşürülmesi, ActionScript işaret noktalarının doğruluğunu artırabilir.

Oynatma kafası güncelleme aralığı, global setInterval() yöntemine yapılan bir çağrıyla ayarlandığından, bu şekilde ayarlanan diğer aralıklarda olduğu gibi güncelleme de SWF dosyası kare hızından daha sık aralıkta tetiklenemez. Bu noktadan yola çıkarak bir örnek vermek gerekirse, saniye başına 12 kare olan varsayılan kare hızı için oluşturabileceğiniz etkili en düşük aralık yaklaşık 83 milisaniye veya 1/12 saniyedir (1000/12 milisaniye)

Varsayılan değer şudur 250.

İlgili API Öğeleri

Her progress olayı arasındaki süreyi milisaniye olarak belirten bir sayı. Video akışı oynatılırken bu özelliği ayarlarsanız, zamanlayıcı yeniden başlatılır.

Otomatik yeniden boyutlandırma sırasında video içeriğinin hizalanmasında kullanılan yükseklik. registrationHeight özelliğini height özelliğiyle karıştırmayın. height özelliği, video içeriğinin gerçek yüksekliğini yansıtır.

Örnek 1, şu ayarlarla bir 80x80 FLV dosyası yükleyin.

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Örnek 2, örnek 1 ile aynı senaryoyu şu ayarlarla yükleyin:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Örnek 3, örnek 2 ile aynı senaryoyu şu ayarlarla yükleyin:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

registrationHeight özelliğinin ayarlanması height özelliğinin ayarlanmasına eşdeğerdir.(Aynı şekilde tersi de geçerlidir.) Başka bir özelliğin ayarlanması veya yüksekliği değiştiren bir yöntemin çağrılması da (örn. scaleX, setSize ve setScale) height ve registrationHeight öğelerinin senkronize olmasını sağlar.

İlgili API Öğeleri

Otomatik yeniden boyutlandırma sırasında video içeriğinin hizalanmasında kullanılan genişlik. registrationWidth özelliğini width özelliğiyle karıştırmayın. width özelliği, video içeriğinin gerçek genişliğini yansıtır.

Örnek 1, şu ayarlarla bir 80x80 FLV dosyası yükleyin.

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Örnek 2, örnek 1 ile aynı senaryoyu şu ayarlarla yükleyin:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Örnek 3, örnek 2 ile aynı senaryoyu şu ayarlarla yükleyin:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

registrationWidth özelliğinin ayarlanması width özelliğinin ayarlanmasına eşdeğerdir. (Aynı şekilde tersi de geçerlidir.) Başka bir özelliğin ayarlanması veya genişliği değiştiren bir yöntemin çağrılması da (örn. scaleX, setSize ve setScale) width ve registrationWidth öğelerinin senkronize olmasını sağlar.

İlgili API Öğeleri

Otomatik yeniden boyutlandırma sırasında video içeriğinin hizalanmasında kullanılan x koordinatı. Video içeriğinin gerçek konumunu yansıtan x özelliğiyle karıştırmayın.

Örnek 1, şu ayarlarla bir 80x80 FLV dosyası yükleyin.

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Örnek 2, örnek 1 ile aynı senaryoyu şu ayarlarla yükleyin:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Örnek 3, örnek 2 ile aynı senaryoyu şu ayarlarla yükleyin:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

x veya registrationX özelliği ayarlandığında, ikinci özellik birinciden kaydırma düzeyini korumak için değiştirilir. Örneğin, x = 10 ve registrationX = 20 olursa, x = 110 ayarı registrationX = 120 ayarını da yapar.

İlgili API Öğeleri

Otomatik yeniden boyutlandırma sırasında video içeriğinin hizalanmasında kullanılan y koordinatı. Video içeriğinin gerçek konumunu yansıtan y özelliğiyle karıştırmayın.

Örnek 1, şu ayarlarla bir 80x80 FLV dosyası yükleyin.

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Örnek 2, örnek 1 ile aynı senaryoyu şu ayarlarla yükleyin:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Örnek 3, örnek 2 ile aynı senaryoyu şu ayarlarla yükleyin:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

y veya registrationY özelliği ayarlandığında, ikinci özellik birinciden kaydırma düzeyini korumak için değiştirilir. Örneğin, y = 10 ve registrationY = 20 olursa, y = 110 ayarı registrationY = 120 ayarını da yapar.

İlgili API Öğeleri

Yüklendikten sonra videonun nasıl yeniden boyutlandırılacağını belirtir. VideoScaleMode.MAINTAIN_ASPECT_RATIO değerine ayarlanırsa, registrationX, registrationY, registrationWidth ve registrationHeight tarafından tanımlanan dikdörtgen içinde video en boy oranını korur. VideoScaleMode.NO_SCALE değerine ayarlanırsa, videonun otomatik olarak kaynak FLV dosyasının boyutlarına göre boyutlandırılmasını sağlar. VideoScaleMode.EXACT_FIT olarak ayarlanırsa, kaynak FLV dosyasının boyutlarının yok sayılmasını ve videonun registrationX, registrationY, registrationWidth ve registrationHeight tarafından tanımlanan dikdörtgene sığacak şekilde uzatılmasını sağlar. Bir FLV dosyası yüklendikten sonra bu ayarlanırsa, hemen bir otomatik mizanpaj başlatılır. Değerler VideoScaleMode içinden gelir.

Varsayılan değer şudur VideoScaleMode.MAINTAIN_ASPECT_RATIO.

İlgili API Öğeleri

Yatay ölçek olan bir sayı.

Varsayılan değer şudur 1.

İlgili API Öğeleri

Dikey ölçek olan bir sayı.

Varsayılan değer şudur 1.

İlgili API Öğeleri

Daha fazla ses denetimi kullanıma sunmak için NetStream.soundTransform özelliğine doğrudan erişim olanağı sağlar. Ayarları değiştirmek için bu özelliği ayarlayın; geçerli ayarları almak için özelliğin getter accessor yöntemini kullanın.

İlgili API Öğeleri

Akışa alınacak FLV dosyasının URL'sini ve nasıl akışa alınacağını belirten bir dize. Bu URL, FLV dosyasına giden bir HTTP URL'si, bir akışa giden RTMP URL'si veya XML dosyasına giden bir HTTP URL'si olabilir.

Bileşen denetçisi veya Özellik denetçisi yoluyla bu özelliği ayarlarsanız, bir sonraki enterFrame olayında FLV yüklenip oynatılmaya başlar. Bu gecikme, diğer özellikler arasından yüklemeyi etkileyen isLive, autoPlay ve cuePoints özelliklerini ayarlamanız için zaman verir. Aynı zamanda birinci kareye yerleştirilen ActionScript'in oynatmaya başlanmadan önce FLVPlayback bileşenini etkilemesine izin verir.

Bu özelliği ActionScript yoluyla ayarlarsanız, autoPlay özelliği false değerine ayarlandığında bu özellik hemen VideoPlayer.load() yöntemini çağırır. Alternatif olarak autoPlay özelliği true değerine ayarlandığında bu VideoPlayer.play() yöntemini çağırır. autoPlay, totalTime ve isLive özellikleri yeni FLV dosyasının nasıl yükleneceğini etkiler, bu nedenle de source özelliğini ayarlamadan önce bu özellikleri ayarlamanız gerekir.

Yeni FLV dosyasının otomatik olarak oynatılmasını önlemek için autoPlay özelliğini false değerine ayarlayın.

İlgili API Öğeleri

Bileşenin durumunu belirleyen bir dize. Bu özellik, load(), play(), stop(), pause() ve seek() yöntemleri tarafından ayarlanır.

state özelliğinin olası değerleri şunlardır: buffering, connectionError, disconnected, loading, paused, playing, rewinding, seeking ve stopped. Bu durumları test etmek için FLVPlayback sınıfı özelliklerini kullanabilirsiniz.

İlgili API Öğeleri

Yanıt verme durumundayken true olan bir Boolean değeri. Yanıt vermeme durumundayken, play(), load(), stop(), pause() ve seek() yöntemlerine yapılan çağrılar sıraya alınır ve daha sonra durum yanıt verme durumuna geçtiğinde çalıştırılır. Bu çağrılar kuyruğa alınıp sonra çalıştırıldığından, genellikle stateResponsive özelliğinin değerini izlemek gerekmez. Yanıt verme durumları şunlardır: stopped, playing, paused ve buffering.

İlgili API Öğeleri

Videonun toplam oynatma süresi olan saniye cinsinden bir sayı.

Flash Media Server'dan (FMS) akış alınırken ve varsayılan NCManager kullanılırken bu değer, sunucu tarafındaki uygulama programlama arabirimleri (API) tarafından otomatik olarak belirlenir ve bu özellik yoluyla ayarlanmış veya meta verilerden toplanmış her şeyi geçersiz kılar. source özelliği ayarlandıktan sonra stopped veya playing durumuna ulaşıldığında bu özellik okumaya hazırdır. FMS'den canlı akışlar için bu özellik anlamsızdır.

HTTP indirmede, FLV dosyasında gömülü meta veri varsa bu değer otomatik olarak belirlenir; aksi takdirde değeri siz açıkça ayarsınız, yoksa değer NaN olur. Bu değeri açıkça ayarlarsanız, akıştaki meta veri değeri yok sayılır.

Bu özelliği ayarladığınızda, source ayarlanarak yüklenen bir sonraki FLV dosyası için değer etkili olur. Zaten yüklenmiş bir FLV dosyası üzerinde bu değerin etkisi yoktur. Ayrıca, bir FLV dosyası yükleninceye kadar bu özellik iletilen yeni değeri döndürmez.

Bu özellik hiç ayarlanmazsa (açıkça veya otomatik şekilde) oynatma yine çalışır ancak arama denetimleriyle ilgili sorun oluşabilir.

Açıkça ayarlanmadığı sürece, bu değer meta veriden geçerli bir değere ayarlanıncaya kadar NaN olacaktır.

İlgili API Öğeleri

Yüklenen FLV dosyasının kaynak genişliği. Henüz bilgi yoksa bu özellik -1 döndürür.

İlgili API Öğeleri

Yüklenen FLV dosyasının kaynak genişliği. Henüz bilgi yoksa bu özellik -1 döndürür.

İlgili API Öğeleri

true olduğunda VideoPlayer örneğini görünebilir duruma getiren bir Boolean değeri. false olduğunda örneği görünmez duruma getirir.

Varsayılan değer şudur true.

Ses düzeyi denetimi ayarını belirten 0 - 1 arasında bir sayı.

Varsayılan değer şudur 1.

İlgili API Öğeleri

Sahne'deki VideoPlayer örneğinin genişliğini belirleyen sayı.

Not: flash.media.Video.width özelliği fl.video.VideoPlayer.videoWidth özelliğine benzer.

İlgili API Öğeleri

Video oynatıcının yatay konumunu belirten sayı (piksel cinsinden).

x özelliğinin ayarlanması registrationX özelliğini de etkiler. x veya registrationX özelliği ayarlandığında, ikinci özellik birinciden kaydırma düzeyini korumak için değiştirilir. Örneğin, x = 10 ve registrationX = 20 olursa, x = 110 ayarı registrationX = 120 ayarını da yapar.

İlgili API Öğeleri

Video oynatıcının yatay konumunu belirten sayı (piksel cinsinden).

y özelliğinin ayarlanması registrationY özelliğini de etkiler. y veya registrationY özelliği ayarlandığında, ikinci özellik birinciden kaydırma düzeyini korumak için değiştirilir. Örneğin, y = 10 ve registrationY = 20 olursa, y = 110 ayarı registrationY = 120 ayarını da yapar.

İlgili API Öğeleri

Belirtilen genişlik ve yükseklik ile bir VideoPlayer nesnesi oluşturur.

İlgili API Öğeleri

Video akışını ve Flash Media Server bağlantısını kapanmaya zorlar. Bu yöntem close olayını tetikler. Boşta kalma zaman aşımı işlevi akışı kapatma görevini gerçekleştirdiğinden, genellikle bu yöntemi doğrudan çağırmanız gerekmez.

İlgili API Öğeleri

play() yöntemine benzer, ancak FLV dosyasının oynatılmaksızın yüklenmesine neden olur. Uygun durumdaysa otomatik yeniden boyutlandırma gerçekleşir ve FLV dosyasının birinci karesi gösterilir. İlk yükleme ve otomatik mizanpajın ardından durum VideoState.PAUSED olur.

Bu yöntem, play() yöntemiyle aynı parametreleri alır ancak load() yöntemini bir URL olmadan çağıramazsınız. Aksi takdirde bir hata atılır. Video oynatıcı yanıt vermeme durumundaysa, load() yöntemi isteği sıraya alır.

Parametreler

İlgili API Öğeleri

INCManager.connectToURL() yöntemine çağrı yapılmasının ardından bağlantı tamamlandıktan veya başarısız olduktan sonra INCManager tarafından çağrılır. Bağlantı başarısız olduysa, çağrı yapmadan önce INCManager.netConnection özelliğini null değerine veya tanımsız değere ayarlayın.

İlgili API Öğeleri

INCManager.reconnect() yöntemine çağrı yapılmasının ardından yeniden bağlanma tamamlandıktan veya başarısız olduktan sonra INCManager tarafından çağrılır. Bağlantı başarısız olursa çağrı yapmadan önce INCManager.netconnection özelliğini null değerine ayarlayın.

İlgili API Öğeleri

Videonun oynatılmasını duraklatır. Video duraklatılırsa veya durdurulursa, herhangi bir etki oluşturmaz. Oynatmayı tekrar başlatmak için play() öğesini çağırın. Parametre almaz.

Oynatıcı yanıt vermeme durumundaysa pause() yöntemi isteği sıraya alır.

Herhangi bir akış bağlı değilken çağrılırsa bir hata atar. Bu yöntemin çağrılmasının ne zaman güvenli olduğunu belirlemek için stateChange olayını ve connected özelliğini kullanın.

Oynatıcı durdurulmuş durumdaysa, pause() yöntemine yapılan bir çağrının herhangi bir etkisi olmaz ve oynatıcı durdurulmuş durumda kalır.

İlgili API Öğeleri

Videonun oynatılmasına neden olur. Video duraklatıldığında veya durdurulduğunda ya da video zaten oynatılıyorken çağrılabilir. Zaten yüklenmiş bir videoyu oynatmak veya yeni bir akış yüklemek üzere bir URL iletmek için herhangi bir argüman olmadan bu yöntemi çağırın.

Oynatıcı yanıt vermeme durumundaysa, isteği sıraya alır.

Herhangi bir akış bağlı değilken argüman olmadan çağrılırsa bir istisna atar. Bu yöntemin çağrılmasının ne zaman güvenli olduğunu belirlemek için stateChange olayını ve connected özelliğini kullanın.

Parametreler

İlgili API Öğeleri

FLV dosyasının yeterli bölümü indirildiğinde dosyayı oynatır. FLV dosyası indirildiyse veya Flash Media Server'dan (FMS) akışa alıyorsanız, playWhenEnoughDownloaded() yönteminin çağrılması parametresiz play() yöntemiyle aynıdır. Bu yöntemin çağrılması oynatmayı duraklatmaz, bu nedenle birçok durumda bu yöntemi çağırmadan önce pause() yöntemini çağırmak isteyebilirsiniz.

Dosya içinde, saniye cinsinden üç ondalık basamak (milisaniye) kesinliğinde belirtilen belirli bir zamanı arar. Video oynatılıyorsa, o noktadan itibaren oynatılmaya devam eder. Video duraklatılmışsa, o noktaya kadar arama yapar ve duraklatılmış şekilde kalır. Video durdurulmuşsa, o noktaya kadar arama yapar ve duraklatılmış duruma girer. Canlı akışlar üzerinde bir etkisi yoktur.

Siz arama yöntemlerinden birini çağırdıktan veya playheadTime öğesinin arama yapmasını sağladıktan sonra playheadTime özelliği beklenen değere sahip olmayabilir. Aşamalı indirme için yalnızca bir ana kareye kadar arama yapabilirsiniz, böylece arama sizi belirtilen zamandan sonraki ilk ana karenin zamanına götürür.

Not: Akışa alırken, kaynak FLV dosyası tam belirtilen zamanda bir ana kare içermese de, arama tam belirtilen zamana gider.

Arama eşzamansızdır, böylece bir seek yöntemi çağırırsanız veya playheadTime özelliğini ayarlarsanız, playheadTime hemen güncellenmez. Arama tamamlandıktan sonraki zamanı almak için, playheadTime özelliği güncelleninceye kadar başlatılmayan seek olayını dinleyin.

Herhangi bir akış bağlı değilken çağrılırsa bir hata atar. Bu yöntemin çağrılmasının ne zaman güvenli olduğunu belirlemek için stateChange olayını ve connected özelliğini kullanın.

Parametreler

İlgili API Öğeleri

Aynı anda scaleX ve scaleY özelliklerini ayarlar. scaleX veya scaleY özelliğinin ayrı ayrı ayarlanması iki autolayout olayını tetiklerken, setScale() yönteminin çağrılması yalnızca bir autolayout olayını tetikler.

scaleMode özelliği VideoScaleMode.MAINTAIN_ASPECT_RATIO veya VideoScaleMode.NO_SCALE olursa, bu yöntemin çağrılması hemen bir autolayout olayına neden olur.

Parametreler

İlgili API Öğeleri

Aynı anda width ve height özelliklerini ayarlar. width veya height özelliğinin ayrı ayrı ayarlanması iki autolayout olayını tetiklerken, setSize() yönteminin çağrılması yalnızca bir autolayout olayını tetikler.

scaleMode özelliği VideoScaleMode.MAINTAIN_ASPECT_RATIO veya VideoScaleMode.NO_SCALE olursa, bu yöntemin çağrılması hemen bir autolayout olayını tetikler.

Parametreler

İlgili API Öğeleri

Videonun oynatılmasını durdurur. autoRewind öğesi true değerine ayarlanırsa, birinci kareye geri sarar. Video zaten durdurulmuşsa, herhangi bir etki oluşturmaz. Oynatmayı tekrar başlatmak için play() öğesini çağırın. Parametre almaz.

Oynatıcı yanıt vermeme durumundaysa, isteği sıraya alır.

Herhangi bir akış bağlı değilken çağrılırsa bir hata atar. Bu yöntemin çağrılmasının ne zaman güvenli olduğunu belirlemek için stateChange olayını ve connected özelliğini kullanın.

İlgili API Öğeleri

autoRewind özelliği true değerine ayarlandığı için oynatma kafası video oynatıcının başına getirildiğinde gönderilir.

autoRewound olayı VideoEvent türünde olup VideoEvent.AUTO_REWOUND sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

VideoPlayer örneği, zaman aşımına uğramak suretiyle veya close() yöntemine yapılan bir çağrıyla NetConnection'ı kapattığında ya da siz load() veya play() yöntemlerini çağırdığınızda ya da source özelliğini ayarlayıp bunun sonucunda RTMP bağlantısının kapanmasına neden olduğunuzda VideoPlayer örneği tarafından gönderilir. FLVPlayback örneği yalnızca Flash Media Server'dan (FMS) veya başka Flash Video Akış Hizmeti'nden (FVSS) akışa alındığında bu olayı gönderir.

close olayı VideoEvent türünde olup VideoEvent.CLOSE sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Oynatıcı FLV dosyasının sonuna ulaştığı için oynatma tamamlandığında gönderilir. stop() veya pause() yöntemlerini çağırır veya karşılık gelen denetimleri tıklatırsanız bileşen olayı göndermez.

Uygulama, aşamalı indirme kullandığında, totalTime özelliğini açıkça ayarlamaz ve meta verideki süreyi belirtmeyen bir FLV dosyasını indirir. Video oynatıcı bu olayı göndermeden önce totalTime özelliğini yaklaşık bir toplam değere ayarlar.

Video oynatıcı ayrıca stateChange ve stopped olaylarını da gönderir.

complete olayı VideoEvent türünde olup VideoEvent.COMPLETE sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bir işaret noktasına ulaşıldığında gönderilir. Olay nesnesi, NetStream.onCuePoint olay geri çağrısı tarafından alınan bilgi nesnesinin yer aldığı bir info özelliğine sahiptir. ActionScript işaret noktaları için bu, ActionScript işaret noktası yöntem ve özelliklerine iletilen nesneyi içerir.

cuePoint olayı MetadataEvent türünde olup MetadataEvent.CUE_POINT sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

drmAuthenticate olayı

drmError olayı

drmError olayı

Video oynatıcı yeniden boyutlandırıldığında veya şekillendirildiğinde gönderilir. İki mizanpaj senaryosu şu şekildedir:

• Video oynatıcı, autoLayout olayı kullanılarak veya setScale() ya da setSize() yöntemleri çağrılarak veya width, height, scaleX ve scaleY özellikleri değiştirilerek düzenlenirse.
• Farklı boyutlarda iki video oynatıcı varsa ve visibleVideoPlayerIndex özelliği bir video oynatıcıdan diğerine geçirilirse.

layout olayı LayoutEvent türünde olup LayoutEvent.LAYOUT sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

FLV dosyasının meta verilerine ilk ulaşıldığı anda gönderilir. Olay nesnesi, NetStream.onMetaData olay geri çağrısı tarafından alınan bilgi nesnesinin yer aldığı bir info özelliğine sahiptir.

metadataReceived olayı MetadataEvent türünde olup MetadataEvent.METADATA_RECEIVED sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

FLV dosyası playheadUpdateInterval özelliği tarafından belirtilen sıklıkta oynatıldığı sırada veya geri sarma başlatıldığında gönderilir. Bir arama gerçekleşmediği sürece video oynatıcı duraklatıldığında veya durdurulduğunda bileşen bu olayı göndermez.

playheadUpdate olayı VideoEvent türünde olup VideoEvent.PLAYHEAD_UPDATE sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

İndirilen bayt sayısındaki ilerlemeyi gösterir. Yükleme başladığında başlayıp tüm baytlar yüklendiğinde ve ağ hatası kalmadığında sona ererek progressInterval özelliğinin belirttiği sıklıkta gönderilir. Varsayılan değer, yükleme çağrıldığında başlayıp tüm baytlar yüklendiğinde ve ağ hatası kalmadığında sona ererek 0,25 saniyede birdir. Yüklenen baytları veya arabellekteki bayt sayısını kontrol etmek için bu olayı kullanın.

Yalnızca aşamalı HTTP indirme için gönderilir. İlerlemeyi indirilen bayt sayısı cinsinden belirtir. Bu olay nesnesi, bytesLoaded ve bytesTotal özelliklerine sahiptir ve bu özellikler aynı adların FLVPlayback özellikleriyle aynıdır.

progress olayı VideoProgressEvent türünde olup VideoProgressEvent.PROGRESS sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bir FLV dosyası yüklendiğinde ve görüntülenmeye hazır olduğunda gönderilen olay. play() veya load() yöntemiyle yeni bir FLV dosyası yükledikten sonra yanıt verme durumuna ilk girdiğinizde başlatılır. Yüklenen her FLV dosyası için yalnızca bir defa başlatılır.

ready olayı VideoEvent türünde olup VideoEvent.READY sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Oynatma durumu değiştiğinde gönderilir. Bir autoRewind çağrısı tamamlandığında geri sarma durumunda stateChange olayı gönderilir. Geri sarma tamamlanmadan stateChange olayı başlatılmaz.

Oynatmanın, bağlanma, yeniden boyutlandırma veya geri sarmanın ortasında olduğu gibi yanıt vermeme durumuna ne zaman girdiğini veya bu durumdan ne zaman çıktığını izlemek için bu olay kullanılabilir. play(), pause(), stop() ve seek() yöntemleri, oynatıcı yanıt verme durumuna girdiğinde çalıştırılacak istekleri kuyruğa alır.

stateChange olayı VideoEvent türünde olup VideoEvent.STATE_CHANGE sabitine sahiptir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bileşenin kısa sürüm numarasını gösteren durum değişkeni. Sürüm numarası, bir FLA dosyasına sahip olduğunuzda veya bileşen sürümünü bilmeniz gerektiğinde kullanışlıdır. Bileşen sürümünü belirlemek için, şu kod izini FLA dosyasına girin:

FLVPlayback.SHORT_VERSION

SHORT_VERSION değişkeni yalnızca büyük ve küçük sürüm numaralarını içerir, 2.0 gibi.VERSION değişkeni düzeltme ve oluşturma numaralarının yanı sıra büyük ve küçük sürüm numaralarını içerir, 2.0.0.11 gibi.

İlgili API Öğeleri

Bileşenin uzun sürüm numarasını gösteren durum değişkeni. Sürüm numarası, bir FLA dosyasına sahip olduğunuzda veya bileşen sürümünü bilmeniz gerektiğinde kullanışlıdır. Bileşen sürümünü belirlemek için, şu kod izini FLA dosyasına girin:

FLVPlayback.VERSION

VERSION değişkeni, düzeltme ve oluşturma numaralarının yanı sıra büyük ve küçük sürüm numaralarını içerir; örneğin, 2.0.0.11.SHORT_VERSION değişkeni yalnızca büyük ve küçük sürüm numaralarını içerir, 2.0 gibi.

İlgili API Öğeleri

Örneği çalıştırmak için şu adımları izleyin:

1. Kütüphaneye FLVPlayback bileşenini ekleyin.
2. testVideoPath öğesini bir FLV dosyası için mutlak veya göreceli bir yolla değiştirin.
3. Bu kodu FLA dosyanızla aynı dizine VideoPlayerExample.as olarak kaydedin.
4. FLA dosyasındaki Document sınıfını VideoPlayerExample olarak ayarlayın.

package
{
    import fl.video.VideoPlayer;
    import flash.display.Sprite;
    import flash.filters.BlurFilter;

    public class VideoPlayerExample extends Sprite 
    {
        private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv"
        private var player:VideoPlayer;
        private var blurryPlayer:VideoPlayer;
        
        public function VideoPlayerExample() {
            player = new VideoPlayer();
            player.play(videoPath);
            player.setScale(0.75, 0.75);
            addChild(player);
            
            blurryPlayer = new VideoPlayer();
            blurryPlayer.play(videoPath);
            blurryPlayer.setScale(0.75,0.75);
            blurryPlayer.filters = [ new BlurFilter(8, 8, 1) ];
            blurryPlayer.x = 250;
            addChild(blurryPlayer);            
        }
    }
}