FLVPlaybackCaptioning  - AS3

FLVPlaybackCaptioning bileşeninin, resim yazısı için TextField nesnesini otomatik olarak taşıyıp taşımayacağını ve yeniden boyutlandırıp boyutlandırmayacağını belirler.

autoLayout özelliği true değerine ayarlanırsa, resim yazılarını içeren DisplayObject örneği veya TextField nesnesi, FLVPlayback örneğinin altından 10 piksel görüntüler. Resim yazısı alanı, her tarafta 10 piksel kenar boşluğu bırakarak FLVPlayback örneğinin genişliğini kapsar.

Bu özellik true değerine ayarlandığında, DisplayObject örneği veya TextField nesnesi doğrudan FLVPlayback örneği üzerinden görüntülenir. Kendi TextField nesnenizi oluşturuyorsanız, autoLayout öğesini false değerine ayarlamanız gerekir. wordWrap = false olursa, resim yazısı alanı FLVPlayback örneği üzerinden ortalanır ancak bu FLVPlayback örneğinden daha geniş olabilir.

Mizanpajı denetlemek için captionChange olayını dinleyerek TextField nesnesi örneğinin ne zaman oluşturulduğunu belirlemeniz gerekir.

Varsayılan değer şudur true.

İlgili API Öğeleri

Resim yazısını etkinleştirmek ve devre dışı bırakmak için açıp/kapatma yetenekleri sağlayan captionButton FLVPlayback özel kullanıcı arabirimi bileşeni örneğini tanımlar.

captionButton özelliği, playButton, pauseButton, muteButton, vb. gibi FLVPlayback özelliklerine benzer işlevler gösterir.

İlgili API Öğeleri

Resim yazılarının görüntüleneceği DisplayObject örneğini ayarlar.

Örneği bir TextField nesnesi olarak ayarlarsanız, bu doğrudan hedeflenir. Örneği bir veya birkaç TextField nesnesi içeren bir DisplayObjectContainer olarak ayarlarsanız, resim yazıları en düşük görüntüleme diziniyle TextField nesnesinde görüntülenir.

DisplayObjectContainer yöntemi, 9 ölçekli arka plana sahip film klibi gibi bir nesneyi destekler, TextField nesnesinin boyutu değiştiğinde bu nesne ölçeklenebilir.

Daha karmaşık ölçekleme ve çizim için, kod yazarak DisplayObjectContainer yönteminin bir captionChange olayını dinlemesini sağlayın.

Not captionTargetName veya captionTarget özelliği ayarlanmazsa, FLVPlaybackCaptioning örneği, bu biçimle captionTarget özelliği tarafından ayarlanmış bir metin alanı oluşturur:

• siyah arka plan (background = true; backgroundColor = 0x000000;)
• beyaz metin (textColor = 0xFFFFFF)
• autoSize = TextFieldAutoSize.LEFT
• multiLine = true
• wordWrap = true
• font = "_sans"
• boyut = 12

Bu değerleri özelleştirmek için captionTargetCreated olayını dinleyin.

İlgili API Öğeleri

Resim yazılarını içeren bir Textfield nesnesinin yer aldığı TextField object veya MovieClip öğesinin örnek adı.

Herhangi bir hedef belirtmemek için bu özelliği boş bir dizeye (yani, bir hedef belirtilmez) veya auto değerine ayarlayın. Bu özellik birincil olarak Bileşen denetçisinde kullanılır. Kod yazıyorsanız, bunun yerine captionTarget özelliğini kullanın.

Varsayılan değer şudur auto.

İlgili API Öğeleri

Resim yazısı uygulanacak FLVPlayback örneğini ayarlar. FLVPlayback örneğinin, FLVPlaybackCaptioning örneğiyle aynı üst öğeye sahip olması gerekir.

flvPlaybackName ve flvPlayback özelliği ayarlanmazsa, FLVPlaybackCaptioning örneği bulduğu ilk örnekle aynı üst öğeyi ve resim yazısını içeren bir FLVPlayback örneğini arar.

İlgili API Öğeleri

Resim yazısı uygulamak istediğiniz FLVPlayback örneği için FLVPlayback örneği adını ayarlar.

Herhangi bir hedef belirtmemek için bunu boş bir dizeye veya auto değerine ayarlayın. FLVPlayback örneğinin, FLVPlaybackCaptioning örneğiyle aynı üst öğeye sahip olması gerekir.

FLVPlayback örneği adı birincil olarak Bileşen denetçisinde kullanılır. Kod yazıyorsanız, flvPlayback özelliğini kullanın.

flvPlaybackName veya flvPlayback özelliği ayarlanmazsa ya da auto değerine ayarlanırsa, FLVPlaybackCaptioning örneği, bulduğu ilk örnekle aynı üst öğeyi ve resim yazılarını içeren bir FLVPlayback örneğini arar.

Varsayılan değer şudur auto.

İlgili API Öğeleri

Resim yazılarını görüntülemek için kullanılır; true = resim yazılarını görüntüle, false = resim yazılarını görüntüleme.

Kullanıcının resim yazısını etkinleştirmesine ve devre dışı bırakmasına izin vermek için captionButton özelliğini kullanırsanız, showCaptions özelliğini false değerine ayarlayın.

Varsayılan değer şudur true.

İlgili API Öğeleri

true değerine ayarlandığında Zamanlanmış Metin dosyasından biçimlendirme talimatlarını sınırlandırır.

simpleFormatting özelliği true değerine ayarlanırsa şu stiller desteklenmez:

• tts:backgroundColor
• tts:color
• tts:fontSize
• tts:fontFamily
• tts:wrapOption

simpleFormatting özelliği true değerine ayarlanırsa, şu stiller desteklenir:

• tts:fontStyle
• tts:fontWeight
• tts:textAlign

Resim yazısı bilgilerini içeren Zamanlanmış Metin XML dosyasının URL'si (zorunlu özellik).

Birden çok dil izi desteği.

track özelliği en iyi şekilde gömülü işaret noktalarıyla birden çok dil izinin desteklenmesinde kullanılır.

FLVPlaybackCaptioning işaret noktaları için desteklenen biçimleri izlemeniz gerekir.

track özelliği 0 dışında bir değere ayarlanırsa, FLVPlaybackCaptioning bileşeni işaret noktasında bir text<n> özelliğini arar, burada n, iz değeridir.

Örneğin, track == 1 olursa, FLVPlayBackCaptioning bileşeni işaret noktasında text1 parametresini arar. Eşlenen bir parametre bulunmazsa, işaret noktasındaki text özelliği kullanılır.

Varsayılan değer şudur 0.

Resim yazısını FLVPlayback bileşeninde belirli bir VideoPlayer'a bağlar.

Birden çok video oynatıcıda resim yazısı kullanmak isterseniz (FLVPlayback bileşeninde activeVideoPlayerIndex ve visibleVideoPlayerIndex özelliklerini kullanarak), kullanacağınız her VideoPlayer için FLVPlaybackCaptioning bileşeninin bir örneğini oluşturmanız ve bu özelliği dizine karşılık gelecek şekilde ayarlamanız gerekir.

Yalnızca bir video oynatıcı kullanıldığında VideoPlayer dizini varsayılan olarak 0 olur.

İlgili API Öğeleri

Yeni bir FLVPlaybackCaptioning örneği oluşturur.

Resim yazısında arama dizesi bulunan FLVPlayback bileşeni işaret noktalarının bir dizisini döndürür.

Parametreler

Resim yazılarını içeren bir FLVPlayback bileşeni işaret noktaları dizisini döndürür.

HTML biçimli bir kopya olarak tüm resim yazılarını içeren bir dizeyi döndürür.

Resim yazılarının her biri, "fl_video_caption" class niteliği, "fl_video_caption_2_0_" dizesiyle başlayan benzersiz bir id niteliği ve resim yazısının videoda görüntülendiği zaman kodunu belirten bir title niteliği ile bir p etiketine dahil edilir.

Aşağıda, döndürülen HTML'in kısa bir örneği verilmiştir:

		 <div id="fl_video_transcript" class="fl_video_transcript">
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_1" title="0:00.50"><i>( speaking French ): </i><br/><b>George: </b> Bonjour, Marie.</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_2" title="0:01.75"><b>Marie: </b> Bonjour, George.</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_3" title="0:03.75">VoilÀ une sucette.</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_4" title="0:05.50"><b>George: </b> C'est pour moi?</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_5" title="0:06.50"><b>Marie: </b> Oui, c'est pour toi.</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_6" title="0:08.00"><b>George: </b> Merci, Marie!</p>
		 	<p class="fl_video_caption" id="fl_video_caption_2_0_7" title="0:09.50"><b>Marie: </b> De rien, George.</p>
		 </div>
		 

Parametreler

Saniye sayısını bir zaman kodu dizesi olarak döndürür.

Parametreler

Resim yazısı hedef metin alanına bir resim yazısı eklenip kaldırıldığında gönderilir.

Şu koşullar doğru olduğunda da olay gönderilir:

• captionTargetName özelliği ayarlanmadığında
• captionTarget özelliği ayarlanmadığında
• FLVPlaybackCaptioning örneği, resim yazısı için otomatik olarak bir TextField nesnesi oluşturduğunda.

captionChange olayının CaptionChangeEvent.CAPTION_CHANGE sabiti vardır.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

captionTarget özelliği oluşturulduktan sonra ancak resim yazıları eklenmeden önce (captionTarget özelliği boştur) gönderilir.

Özel bir DisplayObject ile captionTarget özelliği ayarlanırsa veya captionTargetName özelliği ayarlanırsa, bu olay gönderilmez.

TextField nesnesinin özelliklerini (örneğin, defaultTextFormat özelliği) özelleştiriyorsanız bu olayı dinleyin.

captionTargetCreated olayının CaptionTargetEvent.CAPTION_TARGET_CREATED sabiti vardır.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Zamanlanmış Metin XML verilerinin tamamı yüklendikten sonra gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

URLLoader.load() olayına yapılan bir çağrı, HTTP üzerinden Zamanlanmış Metin XML dosyasına erişmeye çalışıp geçerli Flash Player ortamı istek için durum kodunu algılayabiliyor ve verebiliyorsa gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

URLLoader.load() olayına yapılan bir çağrı, Zamanlanmış Metin XML dosyasının indirilmesini sonlandıran önemli bir hata verdiğinde gönderilir.

Bu olay işlenmezse bir hata atılır.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Zamanlanmış Metin XML dosyasını yüklemek üzere indirme işlemi başladığında, URLLoader.load() yöntemine yapılan bir çağrıyı takiben gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Zamanlanmış Metin XML dosyasının indirilmesi devam ederken veri alındığında gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

URLLoader.load() olayına yapılan bir çağrı, sanal güvenlik alanı dışındaki bir sunucudan Zamanlanmış Metin XML dosyası yüklemeyi denediğinde gönderilir.

Bu olay işlenmezse bir hata atılır.

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 izi FLA dosyasına yazın:

trace (FLVPlaybackCaptioning.SHORT_VERSION);

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

İ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 izi FLA dosyasına yazın:

trace (FLVPlaybackCaptioning.VERSION);

VERSION değişkeni, değiştirme ve oluşturma numaralarının yanı sıra büyük ve küçük sürüm numaralarını da içerir, örneğin, 2.0.0.xx. SHORT_VERSION değişkeni, yalnızca büyük ve küçük sürüm numaralarını içerir, örneğin, 2.0.

İlgili API Öğeleri

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

1. Yeni bir Flash Dosyası açın (ActionScript 3.0).
2. FLVPlayback bileşenini Sahne Alanı üzerinde 0,0 konumuna yerleştirin ve player örnek adını verin.
3. FLVPlaybackCaptioning bileşenini sahne alanında 0,0 konumuna yerleştirin ve captioning örnek adını verin.
4. CaptionButton bileşenini Sahne Alanı üzerine yerleştirin.
5. FLA dosyasını kaydedin ve bu dosyaya bir ad verin; örneğin, captionEx.
6. Yeni bir ActionScript dosyası açın.
7. Aşağıdaki sınıf örnek kodunu yeni bir ActionScript dosyasına yapıştırın ve bu dosyayı FLA dosyanızın da olduğu dizine FLVPlaybackCaptioningExample.as olarak kaydedin.
8. FLA dosyasında (örneğin, captionEx), Özellikler denetçisinde, Document sınıfı girişini FLVPlaybackCaptioningExample olarak ayarlayın.
9. Kontrol Et > Filmi Test Et'i seçin.

package
{
    import fl.video.CaptionChangeEvent;
    import fl.video.FLVPlayback;
    import fl.video.FLVPlaybackCaptioning;
    import flash.display.Sprite;
    import flash.text.TextField;
    
    public class FLVPlaybackCaptioningExample extends Sprite {

        private var videoPath:String = "http://www.helpexamples.com/flash/video/caption_video.flv";
        private var captioningPath:String = "http://www.helpexamples.com/flash/video/caption_video.xml";
        
        public function FLVPlaybackCaptioningExample() {
            player.source = videoPath;
            player.skin = "SkinOverAllNoCaption.swf";
            player.skinBackgroundColor = 0x666666;
            player.skinBackgroundAlpha = 0.5;

            captioning.flvPlayback = player;
            captioning.source = captioningPath;
            captioning.autoLayout = false;            
            captioning.addEventListener(CaptionChangeEvent.CAPTION_CHANGE, onCaptionChange);
        }

        private function onCaptionChange(e:CaptionChangeEvent):void {
            var tf:* = e.target.captionTarget;
            var player:FLVPlayback = e.target.flvPlayback;

            // move the caption below the video
            tf.y = 210;            
        }
    }
}