VideoPlayer  - AS3 Flash

指定視訊相對於 registrationX、registrationY、registrationWidth 和 registrationHeight 屬性的顯示方式。 當 scaleMode 屬性設定為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE 時，align 屬性會進行這項自動配置。 在 FLV 檔載入之後變更此屬性，會立即啟動自動配置。 這些值都來自 VideoAlign 類別。

預設值為 VideoAlign.CENTER。

相關 API 元素

Boolean 值，如果為 true，則會在播放停止時讓 FLV 檔倒帶到「影格 1」，這可能是因為播放程式到達串流的結尾或者呼叫了 stop() 方法所造成的。 這個屬性對於即時串流而言是沒有意義的。

預設值為 false。

數字，用以指定視訊串流開始播放之前，記憶體中緩衝的秒數。 對於透過 RTMP 串流的 FLV 檔 (不會下載而只會存在於記憶體中的緩衝區)，將這項設定從預設值 0.1 增加是很重要的。對於透過 HTTP 進行漸進式下載的 FLV 檔，雖然增加這個預設值可能可以改善老舊、運作緩慢電腦上檢視高解析視訊的效能，但是助益不大。

對於事先錄製 (非即時) 視訊，請勿將 bufferTime 屬性設定為 0；請使用預設的緩衝時間或增加緩衝時間。

這個屬性不會指定開始播放之前要下載的 FLV 檔數量。

相關 API 元素

數字，會指出 HTTP 下載作業的完成度，以位元組數目表示。 在沒有串流、串流來自 Flash Media Server (FMS) 或尚無法取得資訊時，會傳回 0。 只有針對 HTTP 下載作業，這個傳回值才會特別有用。

數字，會指定 HTTP 下載作業的已下載總位元組數。 在沒有串流、串流來自 Flash Media Server (FMS) 或尚無法取得資訊時，會傳回 -1。 只有針對 HTTP 下載作業，這個傳回值才會特別有用。

數字，用以指定 VideoPlayer 實體的高度，以像素為單位。

注意：請勿將此屬性與類似 fl.video.VideoPlayer.videoHeight 屬性的 flash.media.Video.height 屬性混淆。

相關 API 元素

Flash 因為播放暫停或停止而中斷視訊伺服器 (例如 Flash Media Server) 閒置連線之前的時間長度，以毫秒為單位。 如果是透過 HTTP 來下載 FLV 檔，這個屬性是沒有作用的。

如果在視訊串流已經閒置時設定這個屬性，它會使用新值來重新起始逾時期間。

若要讓所有 VideoPlayer 物件都使用您自訂的類別做為預設的 INCManager 實作，請將 iNCManagerClass 屬性設定為該自訂類別的類別物件或字串名稱。 FLVPlayback 類別包含自訂類別的定義，而視訊播放程式則不包含。

字串形式的預設值為 "fl.video.NCManager"。

Boolean 值，當視訊串流處於即時狀態則為 true。 只有從視訊伺服器 (例如 Flash Media Server 或其他「Flash 視訊串流服務」) 進行串流處理時，這個屬性才有效。如果是採用 HTTP 下載的方式，這個屬性值會被忽略。

在將事先錄製的視訊串流傳送到視訊播放程式時，將 isLive 屬性設定為 false，而在傳送即時資料 (如即時廣播) 時，將此屬性設定為 true。 當您將 isLive 屬性設定為 false 時，為了獲得較佳的效能，請勿將 bufferTime 屬性設定為 0。

相關 API 元素

Boolean 值，使用 RTMP 從 Flash Media Server (FMS) 串流處理 FLV 檔時則為 true。 對於其他任何 FLV 檔來源，則值為 false。

相關 API 元素

物件，它是從 NetSteam.onMetaData() 回呼方法之呼叫接收的中繼資料資訊封包 (如果有的話)。 當傳送 metadataReceived 事件後即可使用。

如果 FLV 檔是以 Flash 8 編碼器編碼，則 metadata 屬性會包含下列資訊。 舊版的 FLV 檔只會包含 height、width 和 duration 值。

相關 API 元素

INCManager 物件，讓使用者能夠存取實作 INCManager 的類別實體，即 NCManager 類別的介面。

您可以使用這個屬性，實作需要自訂初始化的自訂 INCManager。

相關 API 元素

允許直接存取視訊播放程式所建立的 NetConnection 實體。

允許直接存取視訊播放程式所建立的 NetStream 實體。

註冊 NetStream 之 client 屬性的自訂類別。根據預設，會使用 fl.video.VideoPlayerClient，此類別會處理 onMetaData() 和 onCuePoint() 訊息。若要針對其他訊息 (例如 onImageData() 和 onTextData()) 加入自訂處理作業，您可以建立自己的類別並將此屬性設定至該類別。

該類別的建構函式必須使用 VideoPlayer 實體做為它的唯一參數，而且它必須具有 Boolean ready 屬性。當用戶端仍在等待任何必須位於檔案開頭的資料訊息期間，此屬性都必須為 false。如果 VideoPlayer 在收到這些訊息之前調整自動倒帶的大小，可能就無法收到這些訊息。根據預設，一旦呼叫 onMetaData()，fl.video.VideoPlayerClient 將從此 ready 屬性傳回 true。

您可以將屬性設定為類別物件本身 (如下列範例中所示) 或類別的字串名稱：

        import fl.video.
        VideoPlayer.netStreamClientClass = MyCustomClient;
        

請注意，若要強制將類別編譯至 SWF 中，將屬性設定為類別的字串名稱是不夠的。預設值為 fl.video.VideoPlayerClient 類別物件，而非字串名稱。

強烈建議所有的自訂實作都應該將 fl.video.VideoPlayer 當做子類別，否則，可能會破壞內建於 VideoPlayer 和 FLVPlayback 組件的中繼資料和提示點處理。

預設值為 fl.video.VideoPlayerClient。

數字，表示目前播放磁頭時間或位置，以秒為單位，可以是分數值。 設定這個屬性會觸發搜尋的動作，必須遵守所有的搜尋限制條件。

當播放磁頭時間變更時 (包括在 FLV 檔播放期間每 0.25 秒一次)，組件會傳送 playheadUpdate 事件。

基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 其次，搜尋作業是非同步的，所以如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。

相關 API 元素

數字，表示每個 playheadUpdate 事件之間的時間長度，以毫秒為單位。 在 FLV 檔播放同時設定這個屬性，將會重新啟動計時器。

由於 ActionScript 提示點始於播放磁頭更新，因此，降低 playheadUpdateInterval 屬性的值，可能會增加 ActionScript 提示點的精確度。

播放磁頭更新間隔是藉由呼叫全域 setInterval() 方法所設定，所以無論設定了何種間隔，其觸發更新的次數不會比 SWF 檔影格速率多。 以每秒 12 個影格的預設影格速率為例，您能夠得到的最低有效間隔大約是 83 毫秒，或是除以 12 的 1 秒鐘 (1000 毫秒)。

預設值為 250。

相關 API 元素

數字，表示每個 progress 事件之間的時間長度，以毫秒為單位。 若您在視訊串流播放的同時設定這個屬性，計時器將重新啟動。

在自動調整大小時，用來對齊視訊內容的高度。 請勿將 registrationHeight 屬性和 height 屬性混淆。 height 屬性會反映視訊內容的實際高度。

範例 1，使用下列設定載入 80x80 的 FLV 檔：

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

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

範例 2，載入與範例 1 相同的案例，但是使用下列設定：

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

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

範例 3，載入與範例 2 相同的案例，但是使用下列設定：

• scaleMode = VideoScaleMode.EXACT_FIT

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

設定 registrationHeight 屬性相當於 height 屬性，反之亦然。 設定其他任何會改變高度的屬性，或呼叫任何會改變高度的方法 (例如 scaleX、setSize 和 setScale) 時，也會使 height 和 registrationHeight 保持同步。

相關 API 元素

在自動調整大小時，用來對齊視訊內容的寬度。 請勿將 registrationWidth 屬性和 width 屬性混淆。 width 屬性會反映視訊內容的實際寬度。

範例 1，使用下列設定載入 80x80 的 FLV 檔：

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

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

範例 2，載入與範例 1 相同的案例，但是使用下列設定：

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

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

範例 3，載入與範例 2 相同的案例，但是使用下列設定：

• scaleMode = VideoScaleMode.EXACT_FIT

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

設定 registrationWidth 屬性相當於設定 width 屬性，反之亦然。 設定其他任何會改變寬度的屬性，或呼叫任何會改變寬度的方法 (例如 scaleX、setSize 和 setScale) 時，也會使 width 和 registrationWidth 保持同步。

相關 API 元素

在自動調整大小時，用來對齊視訊內容的 x 座標。 請勿與 x 屬性搞混，這個屬性會反映視訊內容的實際位置。

範例 1，使用下列設定載入 80x80 的 FLV 檔：

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

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

範例 2，載入與範例 1 相同的案例，但是使用下列設定：

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

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

範例 3，載入與範例 2 相同的案例，但是使用下列設定：

• scaleMode = VideoScaleMode.EXACT_FIT

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

設定 x 或 registrationX 屬性時，後者會變更以維持它與前者的偏移值。 例如，如果 x = 10 而且 registrationX = 20，則設定 x = 110 時也會設定 registrationX = 120。

相關 API 元素

在自動調整大小時，用來對齊視訊內容的 y 座標。 請勿與 y 屬性搞混，這個屬性會反映視訊內容的實際位置。

範例 1，使用下列設定載入 80x80 的 FLV 檔：

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

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

範例 2，載入與範例 1 相同的案例，但是使用下列設定：

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

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

範例 3，載入與範例 2 相同的案例，但是使用下列設定：

• scaleMode = VideoScaleMode.EXACT_FIT

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

設定 y 或 registrationY 屬性時，後者會變更以維持它與前者的偏移值。 例如，如果 y = 10 而且 registrationY = 20，則設定 y = 110 時也會設定 registrationY = 120。

相關 API 元素

會指定載入視訊之後將如何調整大小。 如果設定為 VideoScaleMode.MAINTAIN_ASPECT_RATIO，則會將視訊比例維持在 registrationX、registrationY、registrationWidth 和 registrationHeight 所定義的矩形以內。 如果設定為 VideoScaleMode.NO_SCALE，則會讓視訊大小自動調整為來源 FLV 檔的尺寸。 如果設定為 VideoScaleMode.EXACT_FIT，則會導致忽略來源 FLV 檔的尺寸，並且拉伸視訊以符合由 registrationX、registrationY、registrationWidth 和 registrationHeight 所定義的矩形。 如果在 FLV 檔載入之後設定此屬性，就會立即開始自動配置。 這些值來自 VideoScaleMode。

預設值為 VideoScaleMode.MAINTAIN_ASPECT_RATIO。

相關 API 元素

代表水平縮放的數字。

預設值為 1。

相關 API 元素

代表垂直縮放的數字。

預設值為 1。

相關 API 元素

可讓您直接存取 NetStream.soundTransform 屬性，以便公開更多聲音控制。 設定該屬性以變更設定；使用該屬性的 getter 存取子方法來擷取目前的設定。

相關 API 元素

字串，指定要進行串流處理之 FLV 檔的 URL，以及串流的方式。 這個 URL 可以是 FLV 檔的 HTTP URL、串流的 RTMP URL，或是 XML 檔的 HTTP URL。

如果透過「組件檢測器」或「屬性」檢測器來設定此屬性，FLV 檔會從下一個 enterFrame 事件開始載入和播放。 此一延遲可提供設定 isLive、autoPlay 和 cuePoints 等屬性的時間，這些屬性會影響載入作業。 另外，它也讓放置在第一個影格上的 ActionScript 在 FLVPlayback 組件開始播放前對其產生影響。

如果透過 ActionScript 設定此屬性，並且將 autoPlay 屬性設定為 false 時，它就會立即呼叫 VideoPlayer.load() 方法。 或者，它會在 autoPlay 屬性設定為 true 時呼叫 VideoPlayer.play() 方法。 由於 autoPlay、totalTime 和 isLive 屬性會影響新 FLV 檔的載入方式，所以若要設定這些屬性，您必須在設定 source 屬性之前，先設定這些屬性。

將 autoPlay 屬性設定為 false 可避免自動播放新的 FLV 檔。

相關 API 元素

字串，會指定組件的狀態。 這個屬性是由 load()、play()、stop()、pause() 和 seek() 方法所設定。

state 屬性的可能值為：buffering、connectionError、disconnected、loading、paused、playing、rewinding、seeking 和 stopped。 您可以使用 FLVPlayback 類別屬性來測試這些狀態。

相關 API 元素

Boolean 值，若是有反應的狀態則為 true。 如果是無回應的狀態，則會將呼叫 play()、load()、stop()、pause() 和 seek() 方法的作業排入佇列，等到變成有回應的狀態時再執行這些呼叫。 由於這些呼叫會排入佇列並在稍後處理，因此，通常不需要追蹤 stateResponsive 屬性的值。 有回應的狀態為：stopped、playing、paused 和 buffering。

相關 API 元素

數字，表示視訊的總播放時間，以秒為單位。

從 Flash Media Server (FMS) 處理串流並使用預設的 NCManager 時，伺服器端的應用程式設計介面 (API) 會自動指定這個值，並以該值覆寫透過此屬性設定或從中繼資料蒐集的任何值。 如果設定了 source 屬性之後已經達到 stopped 或 playing 狀態，即可讀取此屬性。 此屬性對於從 FMS 進行的即時串流而言是沒有意義的。

使用 HTTP 下載時，如果 FLV 檔含有內嵌的中繼資料，則會自動指定此值；否則請明確設定，不然這個值就會是 NaN。 如果明確設定它，便會忽略串流中的中繼資料值。

設定此屬性後，下次您設定 source 來載入 FLV 檔時，新的值就會生效。 在已經載入的 FLV 檔上則沒有任何作用。此外，在載入 FLV 檔之前，讀取這個屬性將無法傳回傳遞的新值。

若從不設定這個屬性 (以明確或自動的方式)，您仍然可以播放視訊，不過可能會導致搜尋控制項發生問題。

除非明確設定，否則在設定為中繼資料中的有效值之前，這個值都會是 NaN。

相關 API 元素

已載入之 FLV 檔的原始檔寬度。 如果資訊尚無法取得，此屬性會傳回 -1。

相關 API 元素

已載入之 FLV 檔的原始檔寬度。 如果資訊尚無法取得，此屬性會傳回 -1。

相關 API 元素

Boolean 值，如果為 true，則顯示 VideoPlayer 實體。 如果為 false，則隱藏該實體。

預設值為 true。

數字，會指出音量控制項設定，允許的範圍為 0 到 1。

預設值為 1。

相關 API 元素

數字，用以指定「舞台」上 VideoPlayer 實體的寬度。

注意：flash.media.Video.width 屬性很類似 fl.video.VideoPlayer.videoWidth 屬性。

相關 API 元素

數字，用以指定視訊播放程式的水平位置，以像素為單位。

設定 x 屬性時也會影響 registrationX 屬性。 設定 x 或 registrationX 屬性時，後者會變更以維持它與前者的偏移值。 例如，如果 x = 10 而且 registrationX = 20，則設定 x = 110 時也會設定 registrationX = 120。

相關 API 元素

數字，用以指定視訊播放程式的垂直位置，以像素為單位。

設定 y 屬性時也會影響 registrationY 屬性。 設定 y 或 registrationY 屬性時，後者會變更以維持它與前者的偏移值。 例如，如果 y = 10 而且 registrationY = 20，則設定 y = 110 時也會設定 registrationY = 120。

相關 API 元素

會建立具有指定寬度和高度的 VideoPlayer 物件。

相關 API 元素

強制關閉視訊串流和 Flash Media Server 連線。 此方法會觸發 close 事件。 您通常不需要直接呼叫此方法，因為閒置逾時功能會負責關閉串流。

相關 API 元素

與 play() 方法很類似，不過它會載入 FLV 檔但不播放。 適時自動調整大小，並顯示 FLV 檔的第一個影格。 在初始載入和自動配置之後，狀態會是 VideoState.PAUSED。

此方法需要與 play() 方法相同的參數，但是不使用 URL 就無法呼叫 load() 方法。 如果您這麼做，將會擲回錯誤。 如果視訊播放程式處於無反應狀態，load() 方法便會將要求排入佇列中。

參數

相關 API 元素

在呼叫 INCManager.connectToURL() 方法後而導致連線完成或失敗之後，由 INCManager 呼叫。 如果連接失敗，請在呼叫前先將 INCManager.netConnection 屬性設定為 null 或 undefined。

相關 API 元素

呼叫 INCManager.reconnect() 方法之後，重新連線完成或失敗時，由 INCManager 呼叫。 如果連接失敗，請在呼叫前先將 INCManager.netconnection 屬性設定為 null。

相關 API 元素

暫停視訊播放。 如果視訊暫停或停止，就沒有任何作用。 若要再次開始播放，請呼叫 play()。 不使用任何參數。

如果播放程式處於無回應狀態，pause() 方法就會將要求排入佇列。

如果在沒有連接任何串流時呼叫，就會擲回例外。 您可以使用 stateChange 事件和 connected 屬性，判斷可安全呼叫此方法的時機。

如果播放程式處於停止狀態，則呼叫 pause() 方法不會產生任何影響，而且播放程式也會維持停止狀態。

相關 API 元素

播放視訊。 可以在視訊暫停或停止，或是已經在播放視訊時呼叫。 不使用任何引數呼叫這個方法以播放已經載入的資訊，或傳入 URL 以載入新的串流。

如果播放程式處於無回應狀態，就會將要求排入佇列。

如果在沒有連接任何串流時不使用任何引數呼叫，就會擲回例外。 您可以使用 stateChange 事件和 connected 屬性，判斷可安全呼叫此方法的時機。

參數

相關 API 元素

在充分下載 FLV 檔之後加以播放。 如果 FLV 檔已經下載或是從 Flash Media Server (FMS) 進行串流處理，則呼叫 playWhenEnoughDownloaded() 方法即等同於呼叫 play() 方法而且不搭配任何參數。 呼叫此方法不會暫停播放，因此在許多情況下，您可能需要先呼叫 pause() 方法，再呼叫此方法。

會搜尋檔案中的指定時間點，以秒數為單位指定，取至三位小數位數 (毫秒)。 如果視訊正在播放，則視訊會從該點繼續播放。 如果視訊已暫停，則視訊會搜尋至該點並維持暫停狀態。 如果視訊已停止，此視訊就會搜尋至該點並進入暫停狀態。 對即時串流沒有任何作用。

在您呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 就漸進式下載而言，您只能搜尋關鍵影格，因此將會搜尋到指定時間之後的第一個關鍵影格的時間。

注意：在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此。

搜尋作業是非同步的，所以如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。

如果在沒有連接任何串流時呼叫，就會擲回例外。 您可以使用 stateChange 事件和 connected 屬性，判斷可安全呼叫此方法的時機。

參數

相關 API 元素

會同時設定 scaleX 和 scaleY 屬性。 設定 scaleX 或 scaleY 會個別觸發兩個 autolayout 事件，而呼叫 setScale() 方法則只會觸發一個 autolayout 事件。

如果 scaleMode 屬性為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，呼叫此方法便會立即觸發 autolayout 事件。

參數

相關 API 元素

會同時設定 width 和 height 屬性。 設定 width 或 height 會個別觸發兩個 autolayout 事件，而呼叫 setSize() 方法則只會觸發一個 autolayout 事件。

如果 scaleMode 屬性為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，則呼叫此方法時會立即觸發 autolayout 事件。

參數

相關 API 元素

停止視訊播放。 如果 autoRewind 設定為 true，則倒帶到第一個影格。 如果視訊已經停止，就沒有任何作用。 若要再次開始播放，請呼叫 play()。 不使用任何參數。

如果播放程式處於無回應狀態，就會將要求排入佇列。

如果在沒有連接任何串流時呼叫，就會擲回例外。 您可以使用 stateChange 事件和 connected 屬性，判斷可安全呼叫此方法的時機。

相關 API 元素

當播放磁頭移到視訊播放程式的開頭 (因為 autoRewind 屬性設定為 true) 時傳送。

autoRewound 事件的類型為 VideoEvent，而且具有常數 VideoEvent.AUTO_REWOUND。

這個事件具有下列屬性：

相關 API 元素

當 NetConnection 關閉 (無論是因為逾時或透過呼叫 close() 方法)，或者您呼叫 load() 或 play() 方法或設定 source 屬性因而造成 RTMP 連線關閉時，VideoPlayer 實體都會傳送此事件。 只有從 Flash Media Server (FMS) 或其他「Flash 視訊串流服務」(FVSS) 進行串流處理時，FLVPlayback 實體才會傳送這個事件。

close 事件的類型為 VideoEvent 而且具有常數 VideoEvent.CLOSE。

這個事件具有下列屬性：

相關 API 元素

當播放作業因為播放程式到達 FLV 檔的結尾而完成時傳送。 若您呼叫 stop() 或 pause() 方法，或者按一下對應的控制項，則組件不會傳送這個事件。

在應用程式使用漸進式下載時，不會明確地設定 totalTime 屬性，並且會下載內含中繼資料持續時間的 FLV 檔案。 視訊播放程式會在傳送此事件前，將 totalTime 屬性設定為近似的總值。

視訊播放程式也會傳送 stateChange 和 stopped 事件。

complete 事件的類型為 VideoEvent 而且具有常數 VideoEvent.COMPLETE。

這個事件具有下列屬性：

相關 API 元素

到達提示點時傳送。事件物件具有 info 屬性，其中包含由 FLV 檔提示點的 NetStream.onCuePoint 回呼所接收到的 info 物件。 若為 ActionScript 提示點，它就會包含傳入 ActionScript 提示點方法或屬性的物件。

cuePoint 事件的類型為 MetadataEvent 而且具有常數 MetadataEvent.CUE_POINT。

這個事件具有下列屬性：

相關 API 元素

drmAuthenticate 事件

drmError 事件

drmError 事件

在視訊播放程式調整大小或配置時傳送。 以下是兩種配置案例：

• 如果配置視訊播放程式的方式是使用 autoLayout 事件、呼叫 setScale() 或 setSize() 方法，或變更 width、height、scaleX 和 scaleY 屬性。
• 如果有兩個不同大小的視訊播放程式，而且 visibleVideoPlayerIndex 屬性從其中一個視訊播放程式切換至另一個播放程式。

layout 事件的類型為 LayoutEvent，而且具有常數 LayoutEvent.LAYOUT。

這個事件具有下列屬性：

相關 API 元素

在初次到達 FLV 檔的中繼資料時傳送。 事件物件具有 info 屬性，其中包含由 NetStream.onMetaData 回呼所接收到的 info 物件。

metadataReceived 事件的類型為 MetadataEvent 而且具有常數 MetadataEvent.METADATA_RECEIVED。

這個事件具有下列屬性：

相關 API 元素

在 FLV 檔案按照 playheadUpdateInterval 屬性指定的頻率播放，或者開始倒帶時傳送。 除非出現搜尋的動作，否則當視訊播放程式暫停或停止時，組件不會傳送這個事件。

playheadUpdate 事件的類型為 VideoEvent 而且具有常數 VideoEvent.PLAYHEAD_UPDATE。

這個事件具有下列屬性：

相關 API 元素

指出已下載完成的進度，以位元組數目表示。 事件；依 progressInterval 屬性指定的頻率傳送，從載入開始，到所有位元組都已載入或出現網路錯誤時結束。 預設值為每隔 0.25 秒一次；從呼叫 load 開始，直到所有位元組都已載入或出現網路錯誤時結束。 您可以使用這個事件，檢查載入之位元組或緩衝區中的位元組數目。

只會針對漸進式 HTTP 下載傳送。 指出下載的進度，以位元組數目表示。 事件物件具有 bytesLoaded 和 bytesTotal 屬性，這些屬性與 FLVPlayback 屬性的名稱相同。

progress 事件的類型為 VideoProgressEvent 而且具有常數 VideoProgressEvent.PROGRESS。

這個事件具有下列屬性：

相關 API 元素

在 FLV 檔載入並可以顯示時傳送的事件。 它會在您使用 play() 或 load() 方法時載入新的 FLV 檔案後，於第一次進入回應狀態時啟動。 它只會為每個載入的 FLV 檔啟動一次。

ready 事件的類型為 VideoEvent 而且具有常數 VideoEvent.READY。

這個事件具有下列屬性：

相關 API 元素

播放狀態變更時傳送。當 autoRewind 呼叫完成時，會傳送內含 rewinding 狀態的 stateChange 事件。 stateChange 事件會在自動倒帶完成之後開始。

這個事件可用來追蹤播放進入或離開無回應狀態 (例如，在連線、調整大小或倒帶中途) 的時間。 play()、pause()、stop() 和 seek() 方法將會播放程式進入回應狀態時要執行的要求排入佇列。

stateChange 事件的類型為 VideoEvent 而且具有常數 VideoEvent.STATE_CHANGE。

這個事件具有下列屬性：

相關 API 元素

狀態變數，指出組件的簡短版本號碼。 當您有 FLA 檔，並且需要知道組件版本時，版本號碼就會非常有用。 若要確定組件版本，請在 FLA 檔中輸入下列追蹤程式碼：

FLVPlayback.SHORT_VERSION

SHORT_VERSION 變數只包含主要和次要版本號碼，例如 2.0。VERSION 變數包含主要和次要版本號碼，以及修訂和組建編號，例如 2.0.0.11。

相關 API 元素

狀態變數，指出組件的完整版本號碼。 當您有 FLA 檔，並且需要知道組件版本時，版本號碼就會非常有用。 若要確定組件版本，請在 FLA 檔中輸入下列追蹤程式碼：

FLVPlayback.VERSION

VERSION 變數包含主要和次要版本號碼，以及修訂和組建編號，例如 2.0.0.11。SHORT_VERSION 變數只包含主要和次要版本號碼，例如 2.0。

相關 API 元素

若要執行範例，請遵循下列步驟：

1. 將 FLVPlayback 組件加入元件庫。
2. 以 FLV 檔的絕對或相對路徑取代 testVideoPath。
3. 將此程式碼另存為 VideoPlayerExample.as，與 FLA 檔放在同一個目錄中。
4. 將 FLA 檔中的 Document 類別設定為 VideoPlayerExample。

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);            
        }
    }
}