搭配使用提示點和註解功能

瞭解 FLVPlaybackCaptioning 提示點標準
瞭解事件內嵌提示點的註解功能
使用內嵌提示點支援多國語言音軌

提示點可以讓您與視訊進行互動；例如，您可以控制 FLV 檔的播放選項或顯示視訊中特定時點的文字。如果不想在 FLV 檔上使用 Timed Text XML 檔，您可以在 FLV 檔中內嵌事件提示點，然後將這些提示點與文字建立關聯。本節將提供 FLVPlaybackCaptioning 組件提示點標準的資訊，並概要說明如何將這些提示點與註解功能文字建立關聯。如需有關如何使用「視訊匯入」精靈或 Flash Video Encoder 內嵌事件提示點的詳細資訊，請參閱「使用 Flash」中的第 16 章「使用視訊」。

瞭解 FLVPlaybackCaptioning 提示點標準

在 FLV 檔的中繼資料內，提示點會以具有下列屬性的物件來表示： name 、 time 、 type 和 parameters 。FLVPlaybackCaptioning ActionScript 提示點具有下列特質：

name

name 屬性是包含所指定之提示點名稱的字串。 name 屬性必須以 fl.video.caption.2.0. 前置詞做為開頭，並在此前置詞後面加上字串。字串是一連串的正整數，它會逐漸遞增以保持每個名稱的唯一性。前置詞包括版本號碼，與 FLVPlayback 版本號碼相符。用於 Adobe Flash CS4 以及更新版本時，必須將版本號碼設定為 2.0 。

time

time 屬性是註解的預定顯示時間。

type

type 屬性是一個字串，其值為 "event" 。

parameters

parameters 屬性是一個支援下列名稱和值配對的陣列：

text:String: 註解的 HTML 格式文字。這個文字會直接傳遞給 TextField.htmlText 屬性。FLVPlaybackCaptioning 組件支援選擇性的 text: n 屬性，它可以支援使用多國語言音軌。如需詳細資訊，請參閱使用內嵌提示點支援多國語言音軌。
endTime:Number: 註解應該要消失的時間。如果您並未指定這個「屬性」， FLVPlaybackCaptioning 組件會假設它不是數字 (NaN)，而且註解將一直顯示到 FLV 檔完成 (FLVPlayback 實體傳送 VideoEvent.COMPLETE 事件 ) 為止。請以秒數為單位，指定 endTime:Number 屬性。
backgroundColor:uint: 此參數會設定 TextField.backgroundColor 。這個屬性是選擇性的。
backgroundColorAlpha:Boolean: 如果 backgroundColor 的 Alpha 為 0%，則參數將設定 TextField.background = !backgroundColor 。這個屬性是選擇性的。
wrapOption:Boolean: 此參數會設定 TextField.wordWrap。這個屬性是選擇性的。

瞭解事件內嵌提示點的註解功能

如果您沒有包含 FLV 檔註解的 Timed Text XML 檔，可以讓包含註解功能的 XML 檔與事件內嵌提示點產生關聯，以建立註解功能。XML 樣本假設您已經執行過下列步驟而在視訊中建立了事件內嵌提示點：

加入事件提示點 (遵照 FLVPlaybackCaptioning 標準)，並將視訊編碼。
在 Flash 中，將 FLVPlayback 組件和 FLVPlaybackCaptioning 組件拖曳到「舞台」上。
設定 FLVPlayback 和 FLVPlaybackCaptioning 組件的來源屬性 (FLV 檔的位置和 XML 檔的位置)。

發佈。

下列樣本會將 XML 匯入編碼器：

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<FLVCoreCuePoints> 
 
    <CuePoint> 
        <Time>9136</Time> 
        <Type>event</Type> 
        <Name>fl.video.caption.2.0.index1</Name> 
        <Parameters> 
            <Parameter> 
                <Name>text</Name> 
                <Value><![CDATA[Captioning text for the first cue point]]></Value> 
            </Parameter> 
        </Parameters> 
    </CuePoint> 
 
    <CuePoint> 
        <Time>19327</Time> 
        <Type>event</Type> 
        <Name>fl.video.caption.2.0.index2</Name> 
        <Parameters> 
            <Parameter> 
                <Name>text</Name> 
                <Value><![CDATA[Captioning text for the second cue point]]></Value> 
            </Parameter> 
        </Parameters> 
    </CuePoint> 
 
    <CuePoint> 
        <Time>24247</Time> 
        <Type>event</Type> 
        <Name>fl.video.caption.2.0.index3</Name> 
        <Parameters> 
            <Parameter> 
                <Name>text</Name> 
                <Value><![CDATA[Captioning text for the third cue point]]></Value> 
            </Parameter> 
        </Parameters> 
    </CuePoint> 
 
    <CuePoint> 
        <Time>36546</Time> 
        <Type>event</Type> 
        <Name>fl.video.caption.2.0.index4</Name> 
        <Parameters> 
            <Parameter> 
                <Name>text</Name> 
                <Value><![CDATA[Captioning text for the fourth cue point]]></Value> 
            </Parameter> 
        </Parameters> 
    </CuePoint> 
 
</FLVCoreCuePoints>

FLVPlaybackCaptioning 組件也可以使用內嵌提示點來支援多國語言音軌。如需詳細資訊，請參閱使用內嵌提示點支援多國語言音軌。

使用內嵌提示點支援多國語言音軌

只要 Timed Text XML 檔遵循 FLVPlaybackCaptioning 提示點標準，FLVPlaybackCaptioning track 屬性就可以使用內嵌提示點來支援多國語言音軌 (如需詳細資訊，請參閱瞭解 FLVPlaybackCaptioning 提示點標準 )。但是 FLVPlaybackCaptioning 組件在獨立的 XML 檔中不支援多國語言音軌。如果要使用 track 屬性，請將屬性設定為一個不等於 0 的值。例如，設定 track 屬性為 1 ( track == 1) 時，FLVPlaybackCaptioning 組件將會搜尋提示點參數。如果找不到相符的部分，則使用提示點參數中的 text 屬性。如需詳細資訊，請參閱「適用於 Adobe Flash Platform 的 ActionScript 3.0 參考」中的 track 屬性。