| 套件 | fl.video |
| 類別 | public class FLVPlayback |
| 繼承 | FLVPlayback  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
本文件更新了「Adobe® Flash® Professional CS5 的 ActionScript® 3.0 參考」的 FLVPlayback 類別，以包含下列新增的屬性和方法，目的在於改進組件的鍵盤和螢幕朗讀程式輔助功能。
在您嘗試存取新的屬性或方法之前，務必確定專案中包含組件的「具輔助功能」版本。
FLVPlayback 類別可讓您在應用程式中加入視訊播放程式，以便播放透過 HTTP 以漸進方式下載的視訊 (FLV) 檔，或播放從 Flash Media Server (FMS) 或其他「Flash 視訊串流服務」(FVSS) 串流的 FLV 檔。
至於 Flash Player Update 3 (版本 9.0.115.0) 以及更新的版本，會更新 FLVPlayback 組件，以支援利用業界標準 H.264 編碼的高畫質 MPEG-4 視訊格式。如需 FLVPlayback 組件支援的視訊格式詳細資訊，請參閱使用 ActionScript 3 FLVPlayback 程式設計控制網路視訊。
與其他 ActionScript 3.0 組件不同的是，FLVPlayback 組件不會擴充 UIComponent。因此，它不支援該類別的方法和屬性。
若要存取 FLVPlayback 類別的屬性、方法和事件，您必須將該類別匯入應用程式中，方法是將 FLVPlayback 組件拖曳至 Flash 應用程式中的「舞台」，或在 ActionScript 內使用 import 陳述式。 下列陳述式會匯入 FLVPlayback 類別：
import fl.video.FLVPlayback;FLVPlayback 類別具有 VERSION 常數，這是一種類別屬性。 類別屬性只適用於類別本身。 VERSION 常數會傳回一個表示組件版本的字串。 下列程式碼會在「輸出」面板中顯示版本：
import fl.video.FLVPlayback;
trace(FLVPlayback.VERSION);相關 API 元素
FLVPlaybackCaptioning
MetadataEvent
NCManager
LayoutEvent
SoundEvent
VideoPlayer
VideoError
VideoEvent
VideoProgressEvent
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。 | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
此顯示物件的目前輔助功能選項。 | DisplayObject | |
| activeVideoPlayerIndex : uint
指定哪一個視訊播放程式實體會受到其他應用程式設計介面 (API) 影響的數字。 | FLVPlayback | ||
| align : String
當 scaleMode 屬性設定為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE 時，會指定視訊版面。 | FLVPlayback | ||
| alpha : Number
指出所指定物件的 Alpha 透明度值。 | DisplayObject | |
| autoPlay : Boolean
Boolean 值，如果此值設定為 true，就會在設定 source 屬性之後讓 FLV 檔自動開始播放。 | FLVPlayback | ||
| autoRewind : Boolean
Boolean 值，如果為 true，則會在播放停止時讓 FLV 檔倒帶到「影格 1」，這可能是因為播放程式到達串流的結尾或者呼叫了 stop() 方法所造成的。 | FLVPlayback | ||
| backButton : Sprite
BackButton 播放控制項。 | FLVPlayback | ||
| bitrate : Number
數字，用以指定傳輸 FLV 檔的每秒位元數。 | FLVPlayback | ||
| blendMode : String
來自 BlendMode 類別的值，會指定要使用何種混合模式。 | DisplayObject | |
| blendShader : Shader [唯寫]
設定用來混合前景和背景的著色器。 | DisplayObject | |
| buffering : Boolean [唯讀]
Boolean 值，當視訊處於緩衝狀態時則為 true。 | FLVPlayback | ||
| bufferingBar : Sprite
緩衝列控制項。 | FLVPlayback | ||
| bufferingBarHidesAndDisablesOthers : Boolean
如果設定為 true，則會隱藏 SeekBar 控制項，並在 FLV 檔處於緩衝狀態時停用 Play、Pause、PlayPause、BackButton 和 ForwardButton 控制項。 | FLVPlayback | ||
| bufferTime : Number
數字，用以指定視訊串流開始播放之前，記憶體中緩衝的秒數。 | FLVPlayback | ||
| buttonMode : Boolean
可指定此 sprite 的按鈕模式。 | Sprite | |
| bytesLoaded : uint [唯讀]
數字，會指出 HTTP 下載作業的完成度，以位元組數目表示。 | FLVPlayback | ||
| bytesTotal : uint [唯讀]
數字，會指定 HTTP 下載作業的已下載總位元組數。 | FLVPlayback | ||
| cacheAsBitmap : Boolean
如果設定為 true，Flash 執行階段會快取顯示物件的內部點陣圖表示法。 | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
如果為非 null，當 cacheAsBitmap 設定為 true 時，這個 Matrix 物件會定義顯示物件的顯示方法。 | DisplayObject | |
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| contextMenu : NativeMenu
指定與此物件有關聯的快顯選單。 | InteractiveObject | |
| cuePoints : Array [唯寫]
陣列，會描述 ActionScript 提示點以及停用的內嵌 FLV 檔提示點。 | FLVPlayback | ||
| doubleClickEnabled : Boolean
會指定物件是否會收到 doubleClick 事件。 | InteractiveObject | |
| dropTarget : DisplayObject [唯讀]
指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。 | Sprite | |
| endTabIndex : int [唯讀]
傳回 FLVPlayback 控制項後方的下一個可用 tabIndex 值。 | FLVPlayback | ||
| filters : Array
索引的陣列，其中包含目前和顯示物件相關的每個濾鏡物件。 | DisplayObject | |
| focusRect : Object
會指定這個物件是否會顯示焦點矩形。 | InteractiveObject | |
| forwardButton : Sprite
「快轉」按鈕控制項。 | FLVPlayback | ||
| fullScreenBackgroundColor : uint
在全螢幕佔用模式中使用的背景顏色。 | FLVPlayback | ||
| fullScreenButton : Sprite
FullScreen 按鈕控制項。 | FLVPlayback | ||
| fullScreenSkinDelay : int
會指定隱藏外觀元素的延遲時間，以毫秒為單位。 | FLVPlayback | ||
| fullScreenTakeOver : Boolean
當舞台進入全螢幕模式時，FLVPlayback 組件就會位於所有內容的最上方，而且佔用整個螢幕。 | FLVPlayback | ||
| graphics : Graphics [唯讀]
指定屬於此 sprite 物件的 Graphics 物件，其中可能會產生向量繪圖命令。 | Sprite | |
| height : Number [覆寫]
數字，會指定 FLVPlayback 實體的高度。 | FLVPlayback | ||
| hitArea : Sprite
指定用來當作 sprite 作用區域的另一個 sprite。 | Sprite | |
| idleTimeout : Number
Flash 因為播放暫停或停止而中斷 Flash Media Server (FMS) 閒置連線之前的時間長度，以毫秒為單位。 | FLVPlayback | ||
| isLive : Boolean
Boolean 值，當視訊串流處於即時狀態則為 true。 | FLVPlayback | ||
| isRTMP : Boolean [唯讀]
Boolean 值，使用 RTMP 從 Flash Media Server (FMS) 串流處理 FLV 檔時則為 true。 | FLVPlayback | ||
| loaderInfo : LoaderInfo [唯讀]
會傳回 LoaderInfo 物件，其中包含關於載入此顯示物件所屬之檔案的資訊。 | DisplayObject | |
| mask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。 | DisplayObject | |
| metadata : Object [唯讀]
物件，它是從 NetSteam.onMetaData() 回呼方法之呼叫接收的中繼資料資訊封包 (如果有的話)。 | FLVPlayback | ||
| metaData : Object
如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存，則會取得 DisplayObject 實體的中繼資料物件。 | DisplayObject | |
| metadataLoaded : Boolean [唯讀]
Boolean 值，如果已經找到並處理了中繼資料封包，或者 FLV 檔在沒有中繼資料封包的情況下編碼，則為 true。 | FLVPlayback | ||
| mouseChildren : Boolean
判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。 | DisplayObjectContainer | |
| mouseEnabled : Boolean
指定此物件是否接收滑鼠或其他使用者輸入及訊息。 | InteractiveObject | |
| mouseX : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 x 座標，以像素為單位。 | DisplayObject | |
| mouseY : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 y 座標，以像素為單位。 | DisplayObject | |
| muteButton : Sprite
「靜音」按鈕控制項。 | FLVPlayback | ||
| name : String
指出 DisplayObject 的實體名稱。 | DisplayObject | |
| ncMgr : INCManager [唯讀]
INCManager 物件，讓使用者能夠存取實作 INCManager 的類別實體，即 NCManager 類別的介面。 | FLVPlayback | ||
| needsSoftKeyboard : Boolean
指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。 | InteractiveObject | |
| numChildren : int [唯讀]
傳回此物件的子系數量。 | DisplayObjectContainer | |
| opaqueBackground : Object
會指定顯示物件是否不透明，並具有特定背景顏色。 | DisplayObject | |
| parent : DisplayObjectContainer [唯讀]
指出包含此顯示物件的 DisplayObjectContainer 物件。 | DisplayObject | |
| pauseButton : Sprite
「暫停」按鈕控制項。 | FLVPlayback | ||
| paused : Boolean [唯讀]
Boolean 值，當 FLV 檔處於暫停狀態時則為 true。 | FLVPlayback | ||
| playButton : Sprite
「播放」按鈕控制項。 | FLVPlayback | ||
| playheadPercentage : Number
數字，指定目前的 playheadTime 做為 totalTime 屬性的百分比。 | FLVPlayback | ||
| playheadTime : Number
數字，表示目前播放磁頭時間或位置，以秒為單位，可以是分數值。 | FLVPlayback | ||
| playheadUpdateInterval : Number
數字，表示每個 playheadUpdate 事件之間的時間長度，以毫秒為單位。 | FLVPlayback | ||
| playing : Boolean [唯讀]
Boolean 值，當 FLV 檔處於播放狀態時則為 true。 | FLVPlayback | ||
| playPauseButton : Sprite
「播放/暫停」按鈕控制項。 | FLVPlayback | ||
| preferredHeight : int [唯讀]
數字，會指定來源 FLV 檔的高度。 | FLVPlayback | ||
| preferredWidth : int [唯讀]
指定來源 FLV 檔的寬度。 | FLVPlayback | ||
| preview : String [唯寫]
僅適用於即時預覽。 | FLVPlayback | ||
| progressInterval : Number
數字，表示每個 progress 事件之間的時間長度，以毫秒為單位。 | FLVPlayback | ||
| registrationHeight : Number
在自動調整大小時，用來對齊視訊內容的高度。 | FLVPlayback | ||
| registrationWidth : Number
在自動調整大小時，用來對齊視訊內容的寬度。 | FLVPlayback | ||
| registrationX : Number
在自動調整大小時，用來對齊視訊內容的 x 座標。 | FLVPlayback | ||
| registrationY : Number
在自動調整大小時，用來對齊視訊內容的 y 座標。 | FLVPlayback | ||
| root : DisplayObject [唯讀]
對載入之 SWF 檔案的顯示物件而言，root 屬性就是該 SWF 檔案所呈現之顯示清單樹狀結構部分的最上層顯示物件。 | DisplayObject | |
| rotation : Number
指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。 | DisplayObject | |
| rotationX : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 x 軸旋轉 (以度數為單位)。 | DisplayObject | |
| rotationY : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 y 軸旋轉 (以度數為單位)。 | DisplayObject | |
| rotationZ : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 z 軸旋轉 (以度數為單位)。 | DisplayObject | |
| scale9Grid : Rectangle
目前產生效用的縮放格線。 | DisplayObject | |
| scaleMode : String
會指定載入視訊之後將如何調整大小。 | FLVPlayback | ||
| scaleX : Number [覆寫]
代表水平縮放的數字。 | FLVPlayback | ||
| scaleY : Number [覆寫]
代表垂直縮放的數字。 | FLVPlayback | ||
| scaleZ : Number
指出從物件註冊點套用的物件深度縮放 (百分比)。 | DisplayObject | |
| scrollRect : Rectangle
顯示物件的捲動矩形範圍。 | DisplayObject | |
| scrubbing : Boolean [唯讀]
Boolean 值，當使用者使用 SeekBar 進行拖曳時為 true；否則為 false。 | FLVPlayback | ||
| seekBar : Sprite
SeekBar 控制項。 | FLVPlayback | ||
| seekBarInterval : Number
數字，用以指定來回拖曳 SeekBar 控制點時，執行檢查的間隔時間，以毫秒為單位。 | FLVPlayback | ||
| seekBarScrubTolerance : Number
數字，會指定使用者在更新動作發生之前，可將 SeekBar 控制點移動多遠的距離。 | FLVPlayback | ||
| seekToPrevOffset : Number
秒數，seekToPrevNavCuePoint() 方法會用此屬性來比較它的時間與之前的提示點時間。 | FLVPlayback | ||
| skin : String
字串，會指定外觀元素 SWF 檔的 URL。 | FLVPlayback | ||
| skinAutoHide : Boolean
Boolean 值，如果為 true，則當滑鼠移到視訊以外的區域時，組件外觀元素會被隱藏起來。 | FLVPlayback | ||
| skinBackgroundAlpha : Number
外觀元素之背景的 Alpha。 | FLVPlayback | ||
| skinBackgroundColor : uint
外觀元素的背景顏色 (0xRRGGBB)。 | FLVPlayback | ||
| skinFadeTime : int
進行隱藏或顯示時，外觀元素淡入或淡出所花費的時間，以毫秒為單位。 | FLVPlayback | ||
| skinScaleMaximum : Number
這個屬性指定 FLVPlayback 將使用的最大倍數，在它使用支援硬體加速的 Flash Player 進入全螢幕模式時用來放大其外觀元素。 | FLVPlayback | ||
| softKeyboard : String
控制軟體鍵盤的外觀。 | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
定義顯示軟體鍵盤時，應保留於螢幕上的區域 (iOS 未提供)。 | InteractiveObject | |
| soundTransform : flash.media:SoundTransform [覆寫]
可讓您直接存取 VideoPlayer.soundTransform 屬性，以便公開更多聲音控制。 | FLVPlayback | ||
| source : String
字串，指定要進行串流處理之 FLV 檔的 URL，以及串流的方式。 | FLVPlayback | ||
| stage : Stage [唯讀]
顯示物件的「舞台」。 | DisplayObject | |
| startTabIndex : int [唯讀]
傳回 FLVPlayback 控制項的第一個 tabIndex 值。 | FLVPlayback | ||
| state : String [唯讀]
字串，會指定組件的狀態。 | FLVPlayback | ||
| stateResponsive : Boolean [唯讀]
Boolean 值，若是有反應的狀態則為 true。 | FLVPlayback | ||
| stopButton : Sprite
「停止」按鈕控制項。 | FLVPlayback | ||
| stopped : Boolean [唯讀]
Boolean 值，當 FLVPlayback 實體的狀態為 stopped 時則為 true。 | FLVPlayback | ||
| tabChildren : Boolean
判斷物件的子系是否支援啟用定位鍵。 | DisplayObjectContainer | |
| tabEnabled : Boolean
會指定這個物件是否在停駐點順序中。 | InteractiveObject | |
| tabIndex : int
會指定 SWF 檔中的物件停駐點順序。 | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [唯讀]
傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。 | DisplayObjectContainer | |
| totalTime : Number
數字，表示視訊的總播放時間，以秒為單位。 | FLVPlayback | ||
| transform : flash.geom:Transform
這是一個物件，具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。 | DisplayObject | |
| useHandCursor : Boolean
指示當指標滑入 Sprite，且其 buttonMode 屬性設為 true 時，是否要出現指示手掌 (手掌游標) 的 Boolean 值。 | Sprite | |
| visible : Boolean
不管是否看得見顯示物件。 | DisplayObject | |
| visibleVideoPlayerIndex : uint
數字，可用來管理多個 FLV 檔串流。 | FLVPlayback | ||
| volume : Number
數字，會指出音量控制項設定，允許的範圍為 0 到 1。 | FLVPlayback | ||
| volumeBar : Sprite
音量列控制項。 | FLVPlayback | ||
| volumeBarInterval : Number
數字，會指定拖曳時檢查音量列控制點位置的頻率，以毫秒為單位。 | FLVPlayback | ||
| volumeBarScrubTolerance : Number
數字，會指定使用者在更新動作發生之前，可將音量列控制點移動多遠的距離。 | FLVPlayback | ||
| width : Number [覆寫]
數字，會指定「舞台」上 FLVPlayback 實體的寬度。 | FLVPlayback | ||
| x : Number [覆寫]
數字，用以指定視訊播放程式的水平位置，以像素為單位。 | FLVPlayback | ||
| y : Number [覆寫]
數字，用以指定視訊播放程式的垂直位置，以像素為單位。 | FLVPlayback | ||
| z : Number
表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。 | DisplayObject | |
| 方法 | 定義自 | ||
|---|---|---|---|
會建立新的 FLVPlayback 實體。 | FLVPlayback | ||
新增 ActionScript 提示點，並且具有與使用「提示點」對話方塊新增 ActionScript 提示點相同的作用，不過只有在執行應用程式時 (而非開發應用程式期間) 才能發揮作用。 | FLVPlayback | ||
|
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | |
|
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
|
指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。 | DisplayObjectContainer | |
依照位置，由左至右水平排序 FLVPlayback 控制項，以將 tabIndex 值指定給每一個控制項。 | FLVPlayback | ||
將某個視訊播放程式置於數個視訊播放程式的前方。 | FLVPlayback | ||
關閉 NetStream 並刪除 index 參數所指定的視訊播放程式。 | FLVPlayback | ||
|
判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系，或為實體本身。 | DisplayObjectContainer | |
|
會將事件傳送到事件流程。 | EventDispatcher | |
將 FLVPlayback 視訊播放程式設定為全螢幕。 | FLVPlayback | ||
尋找 type 參數所指定且透過參數指定您想要之時間、名稱或時間與名稱組合的提示點類型。 | FLVPlayback | ||
尋找符合或早於您所指定之時間的指定提示點類型。 | FLVPlayback | ||
在具有與 my_cuePoint.name 相同名稱的 my_cuePoint.array 中尋找下一個提示點。 | FLVPlayback | ||
|
傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。 | DisplayObject | |
|
傳回存在於指定索引位置的子顯示物件實體。 | DisplayObjectContainer | |
|
傳回具有指定名稱的子顯示物件。 | DisplayObjectContainer | |
|
傳回 child DisplayObject 實體的索引位置。 | DisplayObjectContainer | |
|
傳回位於指定點底下，且屬於此 DisplayObjectContainer 實體之子系 (或孫系，以下類推) 的物件陣列。 | DisplayObjectContainer | |
|
根據 targetCoordinateSpace 參數所定義的座標系統，並排除形狀上的任何筆畫，傳回可定義顯示物件邊界的矩形。 | DisplayObject | |
取得 index 參數所指定的視訊播放程式。 | FLVPlayback | ||
|
將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。 | DisplayObject | |
|
將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。 | DisplayObject | |
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
評估顯示物件的範圍框，看它是否與 obj 顯示物件的範圍框重疊或相交。 | DisplayObject | |
|
評估顯示物件，看它是否與 x 和 y 參數所指定的點重疊或相交。 | DisplayObject | |
若 FLV 檔內嵌提示點已停用，便傳回 false。 | FLVPlayback | ||
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
會開始載入 FLV 檔並提供將 autoPlay 屬性設定為 false 的捷徑，以及設定 source、totalTime 和 isLive 屬性 (如果有指定的話) 的捷徑。 | FLVPlayback | ||
|
將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。 | DisplayObject | |
|
將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。 | DisplayObject | |
會暫停播放視訊串流。 | FLVPlayback | ||
播放視訊串流。 | FLVPlayback | ||
在充分下載 FLV 檔之後加以播放。 | FLVPlayback | ||
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
從目前載入的 FLV 檔中移除 ActionScript 提示點。 | FLVPlayback | ||
|
將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | |
|
從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。 | DisplayObjectContainer | |
|
將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | |
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
|
升起顯示虛擬鍵盤。 | InteractiveObject | |
會搜尋檔案中的指定時間點，以秒數為單位指定，取至三位小數位數 (毫秒)。 | FLVPlayback | ||
搜尋至檔案的百分比，並將播放磁頭置於該處。 | FLVPlayback | ||
搜尋檔案中的指定時間點，以秒數為單位指定，取至三位小數位數 (毫秒)。 | FLVPlayback | ||
會搜尋至符合指定之時間、名稱或時間和名稱的瀏覽提示點。 | FLVPlayback | ||
會依據目前的 playheadTime 屬性值，搜尋至下一個瀏覽提示點。 | FLVPlayback | ||
依據目前的 playheadTime 屬性值，搜尋至上一個瀏覽提示點。 | FLVPlayback | ||
|
變更顯示物件容器中現有子系的位置。 | DisplayObjectContainer | |
啟用或停用一或多個 FLV 檔提示點。 | FLVPlayback | ||
|
為迴圈作業設定動態屬性的可用性。 | Object | |
同時設定 scaleX 和 scaleY 屬性。 | FLVPlayback | ||
同時設定 width 和 height。 | FLVPlayback | ||
|
讓使用者拖曳指定的 sprite。 | Sprite | |
|
讓使用者將指定的 Sprite 拖曳至觸控裝置上。 | Sprite | |
停止播放視訊串流。 | FLVPlayback | ||
|
遞迴停止執行所有 MovieClips 的時間軸根源於此物件。 | DisplayObjectContainer | |
|
結束 startDrag() 方法。 | Sprite | |
|
結束觸控裝置使用的 startTouchDrag() 方法。 | Sprite | |
|
替換兩個指定子物件的 z 順序 (深度階層，由前至後順序)。 | DisplayObjectContainer | |
|
在子清單的兩個指定索引位置，替換子物件的 z 順序 (深度階層，由前至後順序)。 | DisplayObjectContainer | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
| 事件 | 摘要 | 定義自 | ||
|---|---|---|---|---|
| [廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。 | EventDispatcher | ||
| 當顯示物件加入顯示清單中時傳送。 | DisplayObject | ||
| 會在顯示物件加入舞台上的顯示清單時，以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。 | DisplayObject | ||
| 在視訊播放程式自動調整大小或配置時傳送。 | FLVPlayback | |||
| 當播放磁頭移到視訊播放程式的開頭 (因為 autoRewind 屬性設定為 true) 時傳送。 | FLVPlayback | |||
| 當 FLVPlayback 實體進入緩衝狀態時傳送。 | FLVPlayback | |||
| 當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。 | InteractiveObject | ||
| 會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。 | InteractiveObject | ||
| 當事件物件關閉 NetConnection (無論是因為逾時或透過呼叫 closeVideoPlayer() 方法)，或者您呼叫 load() 或 play() 方法或設定 source 屬性因而造成 RTMP 連線關閉時，都會傳送此事件。 | FLVPlayback | |||
| 當播放作業因為播放程式到達 FLV 檔的結尾而完成時傳送。 | FLVPlayback | |||
| 當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。 | InteractiveObject | ||
| 當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。 | InteractiveObject | ||
| 到達提示點時傳送。 | FLVPlayback | |||
| 當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。 | InteractiveObject | ||
| [廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。 | EventDispatcher | ||
| 在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下，當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。 | InteractiveObject | ||
| [廣播事件] 當播放磁頭進入新影格時傳送。 | DisplayObject | ||
| [廣播事件] 當播放磁頭結束目前影格時傳送。 | DisplayObject | ||
| 當播放磁頭的位置因為呼叫 seek() 方法或按一下 ForwardButton 控制項而向前移動時傳送。 | FLVPlayback | |||
| 當顯示物件取得焦點之後傳送。 | InteractiveObject | ||
| 當顯示物件失去焦點時傳送。 | InteractiveObject | ||
| [廣播事件] 在影格顯示物件的建構函式執行之後，且影格指令碼執行之前傳送。 | DisplayObject | ||
| 當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選)，某些裝置可能也會將此接觸解譯為數個觸控事件的組合。 | InteractiveObject | ||
| 當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方，以兩支手指按下後鬆開)。 | InteractiveObject | ||
| 當使用者在觸控裝置上，將接觸點移動到 InteractiveObject 實體上方後傳送 (例如，在行動電話或平板電腦觸控螢幕的顯示物件上，由左向右移動手指)。 | InteractiveObject | ||
| 當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上旋轉)。 | InteractiveObject | ||
| 當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如，三指併在一起觸碰行動電話或平板電腦的觸控螢幕，然後在顯示物件上快速平行移動手指)。 | InteractiveObject | ||
| 當使用者與 InteractiveObject 實體建立接觸點，然後在觸控裝置上點一下後送出 (例如，將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單，然後其中一根手點一下，選取選單項目)。 | InteractiveObject | ||
| 當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上快速張開)。 | InteractiveObject | ||
| 這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。 | InteractiveObject | ||
| 會當使用者按下按鍵時傳送。 | InteractiveObject | ||
| 當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。 | InteractiveObject | ||
| 會當使用者放開按鍵時傳送。 | InteractiveObject | ||
| 在視訊播放程式調整大小或配置時傳送。 | FLVPlayback | |||
| 在初次到達 FLV 檔的中繼資料時傳送。 | FLVPlayback | |||
| 當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
| 會當使用者嘗試使用指向裝置變更焦點時傳送。 | InteractiveObject | ||
| 會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。 | InteractiveObject | ||
| 會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 | InteractiveObject | ||
| 會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
| 當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。 | InteractiveObject | ||
| 當使用者釋放手勢時，由拖曳初始程式 InteractiveObject 傳送。 | InteractiveObject | ||
| 已在目標 InteractiveObject 上放下拖曳的物件，而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時，由此目標 InteractiveObject 傳送。 | InteractiveObject | ||
| 當手勢進入 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。 | InteractiveObject | ||
| 當手勢離開 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。 | InteractiveObject | ||
| 當拖曳手勢還留在 InteractiveObject 的邊界內，由此 InteractiveObject 持續傳送。 | InteractiveObject | ||
| 在呼叫 DragManager.doDrag() 進行拖曳作業初期，由指定做為拖曳初始程式的 InteractiveObject 傳送。 | InteractiveObject | ||
| 在呼叫 DragManager.doDrag() 進行拖曳作業期間，由指定做為拖曳初始程式的 InteractiveObject 傳送。 | InteractiveObject | ||
| 當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。 | InteractiveObject | ||
| 在播放程式進入暫停狀態時傳送。 | FLVPlayback | |||
| 當 FLV 檔以 playheadUpdateInterval 屬性指定的頻率播放或開始倒帶時傳送。 | FLVPlayback | |||
| 進入播放狀態時傳送。 | FLVPlayback | |||
| 指出已下載完成的進度，以位元組數目表示。 | FLVPlayback | |||
| 在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆移到螢幕上方，而其餘仍在鄰近偵測邊框內時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆移出這個 InteractiveObject 之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
| 在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方，而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
| 在使用者透過這個 InteractiveObject，從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。 | InteractiveObject | ||
| 當 FLV 檔已載入並可以顯示畫面時傳送。 | FLVPlayback | |||
| 當使用者第一次按下 InteractiveObject 實體上方的按鈕，然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。 | InteractiveObject | ||
| 會當顯示物件將要從顯示清單移除時傳送。 | DisplayObject | ||
| 會在顯示物件即將從顯示清單移除時，以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。 | DisplayObject | ||
| [廣播事件] 當顯示清單將要更新和顯示時傳送。 | DisplayObject | ||
| 當播放磁頭的位置因為呼叫 seek() 而向後移動或者當 autoRewind 呼叫完成時傳送。 | FLVPlayback | |||
| 當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
| 會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 | InteractiveObject | ||
| 會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 | InteractiveObject | ||
| 在使用者停止使用搜尋列拖曳 FLV 檔時傳送。 | FLVPlayback | |||
| 在使用者開始使用搜尋列拖曳 FLV 檔時傳送。 | FLVPlayback | |||
| 當播放磁頭的位置因為呼叫 seek()、設定 playheadTime 屬性或使用 SeekBar 控制項而變更時傳送。 | FLVPlayback | |||
| 當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。 | InteractiveObject | ||
| 載入外觀元素 SWF 檔發生錯誤時傳送。 | FLVPlayback | |||
| 載入外觀元素 SWF 檔時傳送。 | FLVPlayback | |||
| 升起顯示軟體鍵盤之後立即傳送。 | InteractiveObject | ||
| 升起顯示軟體鍵盤前立即傳送。 | InteractiveObject | ||
| 降下隱藏軟體鍵盤之後立即傳送。 | InteractiveObject | ||
| 當使用者移動 volumeBar 控制項的控制點，或設定 volume 或 soundTransform 屬性而導致聲音變更時傳送。 | FLVPlayback | |||
| 播放狀態變更時傳送。 | FLVPlayback | |||
| 在進入停止狀態時傳送。 | FLVPlayback | |||
| 在物件的 tabChildren 旗標值變更時傳送。 | InteractiveObject | ||
| 在物件的 tabEnabled 旗標變更時傳送。 | InteractiveObject | ||
| 在物件的 tabIndex 屬性值變更時傳送。 | InteractiveObject | ||
| 當使用者輸入一或多文字的字元時送出。 | InteractiveObject | ||
| 當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。 | InteractiveObject | ||
| 當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。 | InteractiveObject | ||
| 當使用者觸控裝置時傳送，並且連續不斷地傳送，直到接觸點移除為止。 | InteractiveObject | ||
| 當使用者在觸控裝置中，將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件移至另一個顯示物件)。 | InteractiveObject | ||
| 當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。 | InteractiveObject | ||
| 當使用者在觸控裝置上，將接觸點從 InteractiveObject 實體移出後送出 (例如，在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件上方拖曳到顯示物件以外)。 | InteractiveObject | ||
| 當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。 | InteractiveObject | ||
| 當使用者在觸控裝置的同一個 InteractiveObject 實體上，在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方，以手指按下某個點後又鬆開)。 | InteractiveObject | ||
| 常數 | 定義自 | ||
|---|---|---|---|
| SHORT_VERSION : String = "2.1" [靜態]
狀態變數，指出組件的簡短版本號碼。 | FLVPlayback | ||
| VERSION : String = "2.1.0.23" [靜態]
狀態變數，指出組件的完整版本號碼。 | FLVPlayback | ||
activeVideoPlayerIndex | 屬性 |
activeVideoPlayerIndex:uint| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
指定哪一個視訊播放程式實體會受到其他應用程式設計介面 (API) 影響的數字。您可以使用這個屬性，管理多個 FLV 檔串流；
此屬性不會讓視訊播放程式變成可見；請使用 visibleVideoPlayerIndex 屬性來達到上述目的。
當 activeVideoPlayerIndex 首次設定為某個數字時，會建立新的視訊播放程式。 當新的視訊播放程式建立時，其屬性會設定為預設視訊播放程式的值 (activeVideoPlayerIndex == 0)，例外的有 source、totalTime 和 isLive，這些屬性永遠都會設定為預設值 (分別為空字串、NaN 和 false)，以及 autoPlay 永遠都會是 false (只有預設視訊播放程式是預設為 true，亦即 0)。 cuePoints 屬性不會有任何作用，就像它對預設視訊播放程式的後續載入動作也沒有作用一樣。
控制音量、位置、尺寸、可見性和 UI 控制項的 API 永遠都是通用的，而且其行為「不會」因為 activeVideoPlayerIndex 的設定而受到影響。 特別是，設定 activeVideoPlayerIndex 屬性並不會影響下列屬性和方法：
activeVideoPlayerIndex 影響的屬性和方法
backButton | playPauseButton | skin | width |
bufferingBar | scaleX | stopButton | x |
bufferingBarHidesAndDisablesOthers | transform | y | setSize() |
forwardButton | scaleY | visible | setScale() |
height | seekBar | volume | fullScreenBackgroundColor |
muteButton | seekBarInterval | volumeBar | fullScreenButton |
pauseButton | seekBarScrubTolerance | volumeBarInterval | fullScreenSkinDelay |
playButton | seekToPrevOffset | volumeBarScrubTolerance | fullScreenTakeOver |
registrationX | registrationY | registrationWidth | registrationHeight |
skinBackgroundAlpha | skinBackgroundColor | skinFadeTime |
注意：visibleVideoPlayerIndex 屬性 (而非 activeVideoPlayerIndex 屬性) 會決定外觀元素控制哪一個視訊播放程式。 此外，控制尺寸的 API 還會和 visibleVideoPlayerIndex 屬性互動。
其餘的 API 則會視 activeVideoPlayerIndex 的設定，以特定的視訊播放程式做為目標。
若要在背景中載入第二個 FLV 檔，請將 activeVideoPlayerIndex 設定為 1，並且呼叫 load() 方法。 當您準備要顯示這一個 FLV 檔，並隱藏第一個 FLV 檔時，請將 visibleVideoPlayerIndex 設定為 1。
預設值為 0。
實作
public function get activeVideoPlayerIndex():uint public function set activeVideoPlayerIndex(value:uint):void相關 API 元素
align | 屬性 |
align:String| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當 scaleMode 屬性設定為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE 時，會指定視訊版面。 視訊尺寸是以 registrationX、registrationY、registrationWidth 和 registrationHeight 屬性為準。 當您設定 align 屬性時，這些值便會從 VideoAlign 類別產生。 預設值為 VideoAlign.CENTER。
實作
public function get align():String public function set align(value:String):void相關 API 元素
autoPlay | 屬性 |
autoPlay:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
Boolean 值，如果此值設定為 true，就會在設定 source 屬性之後讓 FLV 檔自動開始播放。 如果設定為 false，則 FLV 檔會載入，但是要等到呼叫 play() 或 playWhenEnoughDownloaded() 方法之後才會開始播放。
當您從 Flash Media Server (FMS) 進行 FLV 檔串流處理，並將 autoPlay 屬性設定為 true 時，就會立即開始播放。 不過，如果是以漸進式下載方式載入 FLV 檔，播放只有在 FLV 檔已下載足以讓 FLV 檔完整播放時才會開始。
若要在尚未充分下載 FLV 檔時就強制播放，請呼叫 play() 方法並且不搭配任何參數。 如果播放已經開始，而您想要回到等待充分下載後才自動開始播放的狀態，請呼叫 pause() 方法，然後呼叫 playWhenEnoughDownloaded() 方法。
如果您在新的 FLV 檔載入期間將屬性設定為 true，則此設定會直到設定 source 屬性時才生效。
將 autoPlay 屬性設定為 true，再將 source 屬性設定為 URL，效果就和呼叫 play() 方法並搭配該 URL 一樣。
呼叫 load() 方法並搭配 URL，效果如同將 source 屬性設定為該 URL，加上設定 autoPlay 屬性為 false。
預設值為 true。
實作
public function get autoPlay():Boolean public function set autoPlay(value:Boolean):void相關 API 元素
autoRewind | 屬性 |
autoRewind:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
Boolean 值，如果為 true，則會在播放停止時讓 FLV 檔倒帶到「影格 1」，這可能是因為播放程式到達串流的結尾或者呼叫了 stop() 方法所造成的。 這個屬性對於即時串流而言是沒有意義的。
預設值為 false。
實作
public function get autoRewind():Boolean public function set autoRewind(value:Boolean):voidbackButton | 屬性 |
bitrate | 屬性 |
bitrate:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，用以指定傳輸 FLV 檔的每秒位元數。
從支援原生頻寬偵測的「Flash 視訊串流服務」進行串流處理時，您可以提供描述如何根據頻寬在多種串流之間切換的 SMIL 檔案。 根據您的 FVSS 而定，可能會自動偵測頻寬，而且如果已設定這個值，就會加以忽略。
進行 HTTP 漸進式下載時，您可以使用相同的 SMIL 格式，但是必須設定位元傳輸速率，如同不進行自動偵測一樣。
實作
public function get bitrate():Number public function set bitrate(value:Number):voidbuffering | 屬性 |
bufferingBar | 屬性 |
bufferingBarHidesAndDisablesOthers | 屬性 |
bufferingBarHidesAndDisablesOthers:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
如果設定為 true，則會隱藏 SeekBar 控制項，並在 FLV 檔處於緩衝狀態時停用 Play、Pause、PlayPause、BackButton 和 ForwardButton 控制項。 這對於防止使用者使用這些控制項，嘗試在透過慢速連線下載或串流處理 FLV 檔時加快該 FLV 檔的播放速度，會很有用。
實作
public function get bufferingBarHidesAndDisablesOthers():Boolean public function set bufferingBarHidesAndDisablesOthers(value:Boolean):voidbufferTime | 屬性 |
bufferTime:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，用以指定視訊串流開始播放之前，記憶體中緩衝的秒數。 對於透過 RTMP 串流的 FLV 檔 (不會下載而只會存在於記憶體中的緩衝區)，將這項設定從預設值 0.1 增加是很重要的。對於透過 HTTP 進行漸進式下載的 FLV 檔，雖然增加這個預設值可能可以改善老舊、運作緩慢電腦上檢視高解析視訊的效能，但是助益不大。
對於預先錄製 (非即時) 的視訊，請勿將 bufferTime 屬性設定為 0：使用預設的緩衝時間或增加緩衝時間。
這個屬性不會指定開始播放之前要下載的 FLV 檔數量。
預設值為 0.1。
實作
public function get bufferTime():Number public function set bufferTime(value:Number):void相關 API 元素
bytesLoaded | 屬性 |
bytesTotal | 屬性 |
cuePoints | 屬性 |
cuePoints:Array [唯寫] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
陣列，會描述 ActionScript 提示點以及停用的內嵌 FLV 檔提示點。 此屬性是特別為了提供給「組件檢測器」和「屬性」檢測器使用而建立的。 若是以其他任何方式設定此屬性，則不會有作用。此屬性值只會影響第一個載入的 FLV 檔，而且您必須在「組件檢測器」或「屬性」檢測器中設定 source 屬性來載入這個 FLV 檔，才會發生效果。
注意：在 ActionScript 中無法存取此屬性。 若要存取 ActionScript 中的提示點資訊，請使用 metadata 屬性。
若要使用 ActionScript 來新增、移除、啟用或停用提示點，請使用 addASCuePoint()、removeASCuePoint() 或 setFLVCuePointEnabled() 方法。
實作
public function set cuePoints(value:Array):void相關 API 元素
endTabIndex | 屬性 |
forwardButton | 屬性 |
fullScreenBackgroundColor | 屬性 |
fullScreenButton | 屬性 |
fullScreenSkinDelay | 屬性 |
fullScreenSkinDelay:int| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會指定隱藏外觀元素的延遲時間，以毫秒為單位。 使用全螢幕佔用模式時，如果 skinAutoHide 屬性為 true，就會在使用者未移動滑鼠的時間超過 fullScreenSkinDelay 屬性指示的秒數時，觸發自動隱藏功能。 如果滑鼠就在外觀元素上，則不會觸發自動隱藏功能。
預設值為 3000 milliseconds (3 seconds)。
實作
public function get fullScreenSkinDelay():int public function set fullScreenSkinDelay(value:int):voidfullScreenTakeOver | 屬性 |
fullScreenTakeOver:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當舞台進入全螢幕模式時，FLVPlayback 組件就會位於所有內容的最上方，而且佔用整個螢幕。 當舞台結束全螢幕模式時，螢幕會回復到原先的樣子。
全螢幕佔用模式的建議設定為 scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO 和 align = VideoAlign.CENTER。
如果載入了具有 FLVPlayback 組件的 SWF 檔，但因為安全性限制而無法存取舞台，則全螢幕佔用模式就無法運作。 不會擲回任何錯誤。
預設值為 true。
實作
public function get fullScreenTakeOver():Boolean public function set fullScreenTakeOver(value:Boolean):voidheight | 屬性 |
height:Number[覆寫] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，會指定 FLVPlayback 實體的高度。 這個屬性只會影響 FLVPlayback 實體的高度，不會包含可能已載入之外觀元素 SWF 檔的高度。 設定 height 屬性時，也會將 registrationHeight 屬性設定為相同的值。
實作
override public function get height():Number override public function set height(value:Number):void相關 API 元素
idleTimeout | 屬性 |
idleTimeout:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
Flash 因為播放暫停或停止而中斷 Flash Media Server (FMS) 閒置連線之前的時間長度，以毫秒為單位。 如果是透過 HTTP 來下載 FLV 檔，這個屬性是沒有作用的。
如果在視訊串流已經閒置時設定這個屬性，它會使用新值來重新起始逾時期間。
預設值為 300,000 milliseconds (5 minutes)。
實作
public function get idleTimeout():Number public function set idleTimeout(value:Number):void相關 API 元素
isLive | 屬性 |
isLive:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
Boolean 值，當視訊串流處於即時狀態則為 true。 只有從 Flash Media Server (FMS) 或其他「Flash 視訊串流服務」(FVSS) 進行串流處理時，這個屬性才有效。如果是採用 HTTP 下載的方式，這個屬性值會被忽略。
如果您在新的 FLV 檔載入期間設定此屬性，它會直到設定新 FLV 檔的 source 屬性時才生效。
在將事先錄製的視訊串流傳送到視訊播放程式時，將 isLive 屬性設定為 false，而在傳送即時資料 (如即時廣播) 時，將此屬性設定為 true。 當您將 isLive 屬性設定為 false 時，為了獲得較佳的效能，請勿將 bufferTime 屬性設定為 0。
實作
public function get isLive():Boolean public function set isLive(value:Boolean):void相關 API 元素
isRTMP | 屬性 |
metadata | 屬性 |
metadata:Object [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
物件，它是從 NetSteam.onMetaData() 回呼方法之呼叫接收的中繼資料資訊封包 (如果有的話)。 當傳送 metadataReceived 事件後即可使用。
如果 FLV 檔是以 Flash 8 編碼器編碼，則 metadata 屬性會包含下列資訊。 舊版的 FLV 檔只會包含 height、width 和 duration 值。
| 參數 | 說明 |
|---|---|
canSeekToEnd | Boolean 值，當 FLV 檔是以最後一個影格上的關鍵影格編碼，以允許搜尋漸進式下載影片片段的結尾時，則為 true。 如果 FLV 檔不是以最後一個影格上的關鍵影格編碼，則為 false。 |
cuePoints | 物件的陣列，內嵌於 FLV 檔的其中一個提示點。 如果 FLV 檔沒有任何提示點，值即為 undefined。 每個物件都有下列屬性：
|
audiocodecid | 指定所使用之音效轉碼器 (編碼/解碼技術) 的數字。 |
audiodelay | 數字，代表 FLV 檔編碼來源檔案中的時間 0。
視訊內容因為需要同步化音訊而短暫延遲一段時間。 例如，如果 請注意，FLVPlayback 和 VideoPlayer 類別會在其時間設定中補正這個延遲時間。 這表示您可以繼續使用在來源檔案中使用的時間設定。 |
audiodatarate | 每秒音訊 KB 數目。 |
videocodecid | 用來編碼視訊的編碼器版本號碼。 |
framerate | 數字，表示 FLV 檔的影格速率。 |
videodatarate | 數字，表示 FLV 檔視訊資料速率。 |
height | 數字，表示 FLV 檔的高度。 |
width | 數字，表示 FLV 檔的寬度。 |
duration | 數字，指定 FLV 檔的持續時間，以秒為單位。 |
實作
public function get metadata():Object詳細資訊
相關 API 元素
metadataLoaded | 屬性 |
metadataLoaded:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
Boolean 值，如果已經找到並處理了中繼資料封包，或者 FLV 檔在沒有中繼資料封包的情況下編碼，則為 true。 換句話說，如果已接收到中繼資料，或者您未取得任何中繼資料，則值為 true。 因此，您會知道自己是否有中繼資料；如果沒有中繼資料，您也會知道不需要等待它。 如果您想要知道是否具有中繼資料，可以透過下方式檢查值：
FLVPlayback.metadata != null
使用此屬性來檢查是否可透過尋找及啟用或停用提示點等方法 (findCuePoint、findNearestCuePoint、findNextCuePointWithName、isFLVCuePointEnabled)，以擷取有用的資訊。
實作
public function get metadataLoaded():Boolean相關 API 元素
muteButton | 屬性 |
ncMgr | 屬性 |
ncMgr:INCManager [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
INCManager 物件，讓使用者能夠存取實作 INCManager 的類別實體，即 NCManager 類別的介面。
您可以使用這個屬性，實作需要自訂初始化的自訂 INCManager。
實作
public function get ncMgr():INCManager相關 API 元素
pauseButton | 屬性 |
paused | 屬性 |
playButton | 屬性 |
playheadPercentage | 屬性 |
playheadPercentage:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，指定目前的 playheadTime 做為 totalTime 屬性的百分比。 如果您存取這個屬性，它會包含已播放時間的百分比。 若您設定這個屬性，搜尋作業便會從代表 FLV 檔播放時間之百分比的時點開始進行。
這個屬性的值是相對於 totalTime 屬性的值。
實作
public function get playheadPercentage():Number public function set playheadPercentage(value:Number):void擲回值
VideoError — 如果您指定無效的百分比，或者 totalTime 屬性為 undefined、null 或小於等於零。
|
playheadTime | 屬性 |
playheadTime:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，表示目前播放磁頭時間或位置，以秒為單位，可以是分數值。 設定這個屬性會觸發搜尋的動作，必須遵守所有的搜尋限制條件。
當播放磁頭時間變更時 (在 FLV 檔播放期間每 0.25 秒變更一次)，組件會傳送 playheadUpdate 事件。
基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 第二，搜尋是非同步的，因此，如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。
實作
public function get playheadTime():Number public function set playheadTime(value:Number):void相關 API 元素
playheadUpdateInterval | 屬性 |
playheadUpdateInterval:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，表示每個 playheadUpdate 事件之間的時間長度，以毫秒為單位。 在 FLV 檔播放同時設定這個屬性，將會重新啟動計時器。
由於 ActionScript 提示點始於播放磁頭更新，因此，降低 playheadUpdateInterval 屬性的值，可能會增加 ActionScript 提示點的精確度。
播放磁頭更新間隔是藉由呼叫全域 setInterval() 方法所設定，所以無論設定了何種間隔，其觸發更新的次數不會比 SWF 檔影格速率多。 以每秒 12 個影格的預設影格速率為例，您能夠得到的最低有效間隔大約是 83 毫秒，或是除以 12 的 1 秒鐘 (1000 毫秒)。
預設值為 250。
實作
public function get playheadUpdateInterval():Number public function set playheadUpdateInterval(value:Number):void相關 API 元素
playing | 屬性 |
playPauseButton | 屬性 |
preferredHeight | 屬性 |
preferredHeight:int [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，會指定來源 FLV 檔的高度。 這項資訊不會在您呼叫 play() 或 load() 方法後隨即生效， 要等到 ready 事件啟動時，才會生效。 如果 scaleMode 屬性的值為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，則最佳的作法是在傳送 layout 事件之後讀取該值。 如果資訊尚無法取得，此屬性會傳回 -1。
實作
public function get preferredHeight():int相關 API 元素
preferredWidth | 屬性 |
preferredWidth:int [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
指定來源 FLV 檔的寬度。 這項資訊不會在您呼叫 play() 或 load() 方法後隨即生效，要等到傳送 ready 事件之後才能生效。 如果 scaleMode 屬性的值為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，則最佳的作法是在傳送 layout 事件之後讀取該值。 如果資訊尚無法取得，此屬性會傳回 -1。
實作
public function get preferredWidth():int相關 API 元素
preview | 屬性 |
progressInterval | 屬性 |
registrationHeight | 屬性 |
registrationHeight:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在自動調整大小時，用來對齊視訊內容的高度。 請勿將 registrationHeight 屬性和 height 屬性混淆。 height 屬性會反映視訊內容的實際高度。
範例 1，使用下列設定載入 80x80 的 FLV 檔：
registrationX= 100registrationY= 100registrationWidth= 60registrationHeight= 40align=VideoAlign.CENTERscaleMode=VideoScaleMode.NO_SCALE
x= 90y= 80width= 80height= 80
範例 2，載入與範例 1 相同的案例，但是使用下列設定：
scaleMode=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x= 110y= 100width= 40height= 80
範例 3，載入與範例 2 相同的案例，但是使用下列設定：
scaleMode=VideoScaleMode.EXACT_FIT
x= 100y= 100width= 60height= 40
設定 registrationHeight 屬性相當於 height 屬性，反之亦然。 設定其他任何會改變高度的屬性，或呼叫任何會改變高度的方法 (例如 scaleX、setSize 和 setScale) 時，也會使 height 和 registrationHeight 保持同步。
實作
public function get registrationHeight():Number public function set registrationHeight(value:Number):voidregistrationWidth | 屬性 |
registrationWidth:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在自動調整大小時，用來對齊視訊內容的寬度。 請勿將 registrationWidth 屬性和 width 屬性混淆。 width 屬性會反映視訊內容的實際寬度。
範例 1，使用下列設定載入 80x80 的 FLV 檔：
registrationX= 100registrationY= 100registrationWidth= 60registrationHeight= 40align=VideoAlign.CENTERscaleMode=VideoScaleMode.NO_SCALE
x= 90y= 80width= 80height= 80
範例 2，載入與範例 1 相同的案例，但是使用下列設定：
scaleMode=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x= 110y= 100width= 40height= 80
範例 3，載入與範例 2 相同的案例，但是使用下列設定：
scaleMode=VideoScaleMode.EXACT_FIT
x= 100y= 100width= 60height= 40
設定 registrationWidth 屬性相當於設定 width 屬性，反之亦然。 設定其他任何會改變寬度的屬性，或呼叫任何會改變寬度的方法 (例如 scaleX、setSize 和 setScale) 時，也會使 width 和 registrationWidth 保持同步。
實作
public function get registrationWidth():Number public function set registrationWidth(value:Number):voidregistrationX | 屬性 |
registrationX:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在自動調整大小時，用來對齊視訊內容的 x 座標。 請勿與 x 屬性搞混，這個屬性會反映視訊內容的實際位置。
範例 1，使用下列設定載入 80x80 的 FLV 檔：
registrationX= 100registrationY= 100registrationWidth= 60registrationHeight= 40align=VideoAlign.CENTERscaleMode=VideoScaleMode.NO_SCALE
x= 90y= 80width= 80height= 80
範例 2，載入與範例 1 相同的案例，但是使用下列設定：
scaleMode=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x= 110y= 100width= 40height= 80
範例 3，載入與範例 2 相同的案例，但是使用下列設定：
scaleMode=VideoScaleMode.EXACT_FIT
x= 100y= 100width= 60height= 40
設定 x 或 registrationX 屬性時，後者會變更以維持它與前者的偏移值。 例如，如果 x = 10 而且 registrationX = 20，則設定 x = 110 時也會設定 registrationX = 120。
實作
public function get registrationX():Number public function set registrationX(value:Number):voidregistrationY | 屬性 |
registrationY:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在自動調整大小時，用來對齊視訊內容的 y 座標。 請勿與 y 屬性搞混，這個屬性會反映視訊內容的實際位置。
範例 1，使用下列設定載入 80x80 的 FLV 檔：
registrationX= 100registrationY= 100registrationWidth= 60registrationHeight= 40align=VideoAlign.CENTERscaleMode=VideoScaleMode.NO_SCALE
x= 90y= 80width= 80height= 80
範例 2，載入與範例 1 相同的案例，但是使用下列設定：
scaleMode=VideoScaleMode.MAINTAIN_ASPECT_RATIO
x= 110y= 100width= 40height= 80
範例 3，載入與範例 2 相同的案例，但是使用下列設定：
scaleMode=VideoScaleMode.EXACT_FIT
x= 100y= 100width= 60height= 40
設定 y 或 registrationY 屬性時，後者會變更以維持它與前者的偏移值。 例如，如果 y = 10 而且 registrationY = 20，則設定 y = 110 時也會設定 registrationY = 120。
實作
public function get registrationY():Number public function set registrationY(value:Number):voidscaleMode | 屬性 |
scaleMode:String| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會指定載入視訊之後將如何調整大小。 如果設定為 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。
實作
public function get scaleMode():String public function set scaleMode(value:String):void相關 API 元素
scaleX | 屬性 |
scaleY | 屬性 |
scrubbing | 屬性 |
seekBar | 屬性 |
seekBarInterval | 屬性 |
seekBarInterval:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，用以指定來回拖曳 SeekBar 控制點時，執行檢查的間隔時間，以毫秒為單位。
由於這個間隔是藉由呼叫全域 setInterval() 方法所設定，因此啟動更新的次數不會比 SWF 檔影格速率多。 以每秒 12 個影格的預設影格速率為例，您能夠得到的最低有效間隔大約是 83 毫秒，或是除以 12 的 1 秒鐘 (1000 毫秒)。
預設值為 250。
實作
public function get seekBarInterval():Number public function set seekBarInterval(value:Number):voidseekBarScrubTolerance | 屬性 |
seekToPrevOffset | 屬性 |
seekToPrevOffset:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
秒數，seekToPrevNavCuePoint() 方法會用此屬性來比較它的時間與之前的提示點時間。 此方法會使用這個值來確認您是否處於提示點之前，您可略過它跳至之前的提示點，而無需反覆進入同一個提示點。
預設值為 1。
實作
public function get seekToPrevOffset():Number public function set seekToPrevOffset(value:Number):voidskin | 屬性 |
skinAutoHide | 屬性 |
skinAutoHide:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
Boolean 值，如果為 true，則當滑鼠移到視訊以外的區域時，會將組件外觀元素隱藏起來。 這個屬性只會影響透過設定 skin 屬性而載入的外觀元素，而不會影響從「FLVPlayback 自訂使用者介面」組件建立的外觀元素。
如果組件使用全螢幕佔用模式，而且外觀元素不會覆蓋視訊，則會自動開啟 skinAutoHide 模式。 在進入全螢幕模式後設定 skinAutoHide = false 即可覆寫此行為。 此外，當組件處於全螢幕佔用模式時，如果使用者未移動滑鼠的時間超過 fullScreenSkinDelay 指定的秒數，則除非滑鼠就在外觀元素上面，否則也會觸發自動隱藏功能。
預設值為 false。
實作
public function get skinAutoHide():Boolean public function set skinAutoHide(value:Boolean):voidskinBackgroundAlpha | 屬性 |
skinBackgroundAlpha:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
外觀元素之背景的 Alpha。 skinBackgroundAlpha 屬性只能用於 SWF 檔 (具有使用 skin 屬性載入的外觀元素)，以及用於支援設定顏色和 Alpha 的外觀元素。 您可以將 skinBackgroundAlpha 屬性設定為介於 0.0 和 1.0 之間的數字。預設值是使用者選擇做為預設值的最後一個值。
若要取得 ActionScript 2.0 FLVPlayback 組件提供的外觀元素顏色，請使用下列值做為 skinBackgroundAlpha 和 skinBackgroundColor 屬性的值：Arctic - 0.85, 0x47ABCB；Clear - 0.20, 0xFFFFFF；Mojave - 0.85, 0xBFBD9F；Steel - 0.85, 0x666666。 預設值為 0.85。
實作
public function get skinBackgroundAlpha():Number public function set skinBackgroundAlpha(value:Number):void相關 API 元素
skinBackgroundColor | 屬性 |
skinBackgroundColor:uint| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
外觀元素的背景顏色 (0xRRGGBB)。 skinBackgroundColor 屬性只能用於 SWF 檔 (具有使用 skin 屬性載入的外觀元素)，以及用於支援設定顏色和 Alpha 的外觀元素。 預設值是使用者選擇做為預設值的最後一個值。
若要取得 ActionScript 2.0 FLVPlayback 組件提供的外觀元素顏色，請使用下列值做為 skinBackgroundAlpha 和 skinBackgroundColor 屬性的值：Arctic - 0.85, 0x47ABCB；Clear - 0.20, 0xFFFFFF；Mojave - 0.85, 0xBFBD9F；Steel - 0.85, 0x666666。 預設值為 0x47ABCB。
實作
public function get skinBackgroundColor():uint public function set skinBackgroundColor(value:uint):void相關 API 元素
skinFadeTime | 屬性 |
skinFadeTime:int| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
進行隱藏或顯示時，外觀元素淡入或淡出所花費的時間，以毫秒為單位。 會發生隱藏或顯示的情形，因為 skinAutoHide 屬性設定為 true。 您可以將 skinFadeTime 屬性設定為 0，以消除淡入淡出效果。
預設值為 500 milliseconds (.5 seconds)。
實作
public function get skinFadeTime():int public function set skinFadeTime(value:int):voidskinScaleMaximum | 屬性 |
skinScaleMaximum:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.115.0, AIR 1.0 |
這個屬性指定 FLVPlayback 將使用的最大倍數，在它使用支援硬體加速的 Flash Player 進入全螢幕模式時用來放大其外觀元素。 有了硬體加速，視訊和外觀元素會以相同係數縮放。 根據預設，FLVPlayback 會以原尺寸顯示視訊，讓硬體加速負責其餘的縮放作業。 舉例而言，如果視訊的尺寸是 640 x 512，將它在解析度為 1280 x 1024 的監視器上放大成全螢幕大小，視訊和外觀元素將會放大兩倍。
這個屬性可讓您在使用硬體加速時，根據所縮放的特定內容，以及您對大型外觀元素在外觀上的審美觀，限制外觀元素的縮放比例。 為了將外觀元素的縮放比例限制在指定的倍數，FLVPlayback 會混合使用外觀元素的軟體和硬體縮放，但這樣可能對視訊播放的效能和 FLV 的外觀產生不良的影響。
舉例而言，如果這個屬性設定為 5.0 或更高，在解析度為 1600 x 1200 的監視器上將尺寸為 320 x 240 的視訊放大成全螢幕大小，就要將外觀元素放大 5 倍。 如果這個屬性設定為 2.5，播放程式會以原始大小的兩倍 640 x 480 顯示視訊 (不是外觀元素)，而且硬體加速會負責執行其餘的縮放作業 (640 x 2.5 = 1600 和 480 x 2.5 = 1200)。
進入全螢幕模式之後再設定這個屬性並沒有任何作用，要等到 FLVPlayback 下一次進入全螢幕模式時才有作用。
如果 FLV 很大 (例如，寬度 640 像素以上，高度 480 像素以上)，就不應該將這個屬性設定為較小的值，因為這樣可能導致在大型監視器上出現顯著的效能問題。
預設值為 4.0。
實作
public function get skinScaleMaximum():Number public function set skinScaleMaximum(value:Number):void相關 API 元素
範例 ( 如何使用本範例 )
skinScaleMaximum 屬性的效果，請在瀏覽器中播放 FLV，同時按一下 FLVPlayback 外觀元素上的全螢幕按鈕。
注意：在瀏覽器中測試這個範例。 在 Flash「發佈設定」對話方塊的「HTML」索引標籤上，選取「僅限 Flash - 允許全螢幕」範本。指定 Flash Player 9.0.115.0，並確定已在「格式」索引標籤上選取 Flash 和 HTML 格式。然後發佈產生的 HTML 檔，並在瀏覽器中開啟。
// Requires FLVPlayback component in library // Requires SkinOverPlayFullscreen.swf to be in the same folder as the .fla file. import fl.video.FLVPlayback; var myFLVPlybk:FLVPlayback = new FLVPlayback(); addChild(myFLVPlybk); myFLVPlybk.skin = "SkinOverPlayFullscreen.swf"; myFLVPlybk.skinScaleMaximum = 2.5; myFLVPlybk.source = "http://helpexamples.com/flash/video/water.flv";
soundTransform | 屬性 |
soundTransform:flash.media:SoundTransform[覆寫] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
可讓您直接存取 VideoPlayer.soundTransform 屬性，以便公開更多聲音控制。 您必須設定此屬性才能讓變更生效，或者您也可以取得這個屬性的值，以取得目前設定的副本。
實作
override public function get soundTransform():flash.media:SoundTransform override public function set soundTransform(value:flash.media:SoundTransform):void相關 API 元素
source | 屬性 |
source:String| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
字串，指定要進行串流處理之 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 檔。
實作
public function get source():String public function set source(value:String):void相關 API 元素
startTabIndex | 屬性 |
state | 屬性 |
state:String [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
字串，會指定組件的狀態。 這個屬性是由 load()、play()、stop()、pause() 和 seek() 方法所設定。
state 屬性的可能值為："buffering"、"connectionError"、"disconnected"、"loading"、"paused"、"playing"、"rewinding"、"seeking" 和 "stopped"。 您可以使用 FLVPlayback 類別屬性來測試這些狀態。
實作
public function get state():String相關 API 元素
stateResponsive | 屬性 |
stateResponsive:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
Boolean 值，若是有反應的狀態則為 true。 若是無回應的狀態，則會將呼叫 play()、load()、stop()、pause() 和 seek() 方法的作業排入佇列，等到變成有回應的狀態時再執行這些呼叫。 由於這些呼叫會排入佇列並在稍後處理，因此，通常不需要追蹤 stateResponsive 屬性的值。 有回應的狀態為：stopped、playing、paused 和 buffering。
實作
public function get stateResponsive():Boolean相關 API 元素
stopButton | 屬性 |
stopped | 屬性 |
totalTime | 屬性 |
totalTime:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，表示視訊的總播放時間，以秒為單位。
從 Flash Media Server (FMS) 處理串流並使用預設的 NCManager 時，伺服器端的 API 會自動指定這個值，並以該值覆寫透過此屬性設定或從中繼資料蒐集的任何值。 如果設定了 source 屬性之後已經達到 stopped 或 playing 狀態，即可讀取此屬性。 此屬性對於從 FMS 進行的即時串流而言是沒有意義的。
使用 HTTP 下載時，如果 FLV 檔含有內嵌的中繼資料，則會自動指定此值；否則，請明確設定它，不然就會是 NaN。 如果明確設定它，便會忽略串流中的中繼資料值。
設定這個屬性後，下次您設定 source 屬性來載入 FLV 檔時，新的值就會生效。 在已經載入的 FLV 檔上則沒有任何作用。此外，在載入 FLV 檔之前，讀取這個屬性將無法傳回傳遞的新值。
若從不設定這個屬性 (以明確或自動的方式)，您仍然可以播放視訊，不過可能會導致搜尋控制項發生問題。
除非明確設定，否則在設定為中繼資料中的有效值之前，這個值都會是 NaN。
實作
public function get totalTime():Number public function set totalTime(value:Number):void相關 API 元素
visibleVideoPlayerIndex | 屬性 |
visibleVideoPlayerIndex:uint| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，可用來管理多個 FLV 檔串流。 您可以用它來設定哪一個視訊播放程式實體是可看見、可以聽得到聲音，並且由外觀元素或播放控制項所控制，而其他的實體則處於隱藏及靜音狀態。它不會將視訊播放程式設定為多數 API 的目標；請使用 activeVideoPlayerIndex 屬性進行這項設定。
控制尺寸的方法和屬性會和這個屬性互動。 設定視訊播放程式尺寸的方法和屬性 (setScale()、setSize()、width、height、scaleX、scaleY) 可以用於所有的視訊播放程式。 不過，視這些視訊播放程式上的 scaleMode 屬性值而定，它們可能會有不同的尺寸。 利用 width、height、scaleX 和 scaleY 屬性來讀取尺寸只能提供您可見的視訊播放程式尺寸。 其他視訊播放程式可能有相同的尺寸，或許沒有。
若要在各種視訊播放程式隱藏時取得其尺寸，請偵聽 layout 事件並儲存其大小值。
這個屬性無法指出整體組件可見性，它只能指出當組件顯示時，哪一個視訊播放程式為可見狀態。 若要設定整個組件的可見性，請使用 visible 屬性。
預設值為 0。
實作
public function get visibleVideoPlayerIndex():uint public function set visibleVideoPlayerIndex(value:uint):void相關 API 元素
volume | 屬性 |
volumeBar | 屬性 |
volumeBarInterval | 屬性 |
volumeBarScrubTolerance | 屬性 |
volumeBarScrubTolerance:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，會指定使用者在更新動作發生之前，可將音量列控制點移動多遠的距離。 這個值是以百分比來表示，範圍從 1 至 100。 您可以設定為 0，表示不容許拖曳。 無論使用者移動控制點的幅度有多大，請記住務必針對 volumeBarInterval 屬性更新音量。
預設值為 0。
實作
public function get volumeBarScrubTolerance():Number public function set volumeBarScrubTolerance(value:Number):voidwidth | 屬性 |
width:Number[覆寫] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，會指定「舞台」上 FLVPlayback 實體的寬度。 這個屬性只會影響 FLVPlayback 實體的寬度，不會包含可能已載入之外觀元素 SWF 檔的寬度。 如果已載入外觀元素 SWF 檔，請使用 FLVPlayback width 屬性，而不要使用 DisplayObject.width 屬性，因為 width 屬性可能會提供不同的值。 設定 width 屬性時，也會將 registrationWidth 屬性設定為相同的值。
實作
override public function get width():Number override public function set width(value:Number):void相關 API 元素
x | 屬性 |
x:Number[覆寫] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，用以指定視訊播放程式的水平位置，以像素為單位。
設定 x 屬性時也會影響 registrationX 屬性。 設定 x 或 registrationX 屬性時，後者會變更以維持它與前者的偏移值。 例如，如果 x = 10 而且 registrationX = 20，則設定 x = 110 時也會設定 registrationX = 120。
實作
override public function get x():Number override public function set x(value:Number):voidy | 屬性 |
y:Number[覆寫] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
數字，用以指定視訊播放程式的垂直位置，以像素為單位。
設定 y 屬性時也會影響 registrationY 屬性。 設定 y 或 registrationY 屬性時，後者會變更以維持它與前者的偏移值。 例如，如果 y = 10 而且 registrationY = 20，則設定 y = 110 時也會設定 registrationY = 120。
實作
override public function get y():Number override public function set y(value:Number):voidFLVPlayback | () | 建構函式 |
public function FLVPlayback()| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會建立新的 FLVPlayback 實體。 在建立 FLVPlayback 實體之後，請呼叫 addChild() 或 addChildAt() 方法，將實體放置在「舞台」上或其他顯示物件容器中。
相關 API 元素
addASCuePoint | () | 方法 |
public function addASCuePoint(timeOrCuePoint:*, name:String = null, parameters:Object = null):Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
新增 ActionScript 提示點，並且具有與使用「提示點」對話方塊新增 ActionScript 提示點相同的作用，不過只有在執行應用程式時 (而非開發應用程式期間) 才能發揮作用。
設定 source 時，會清除提示點資訊。 若要為下一個要載入的 FLV 檔設定提示點資訊，請先設定 source 屬性。
新增多個具備相同名稱和時間的 ActionScript 提示點是有效的。 當您移除具有 removeASCuePoint() 方法的 ActionScript 提示點時，所有具有相同名稱和時間的提示點都會遭到移除。
參數
timeOrCuePoint:* — 具有 name 和 time 屬性的物件，這些屬性會描述提示點。 此物件可能也包含具有名稱/值配對的 parameters 屬性。 它可能會將為 type 屬性設定為 "actionscript"。 如果沒有 type 或設定為其他的值，它就會自動進行設定。如果此物件與這些慣例不符，此方法就會擲回 VideoError 錯誤。
| |
name:String (default = null)time 參數而非 CuePoint 物件時，用以指定提示點名稱的字串。
| |
parameters:Object (default = null)timeOrCuePoint 參數是數字，則為提示點的選擇性參數。
|
Object — 已新增的提示點物件。 編輯此物件會影響 cuePoint 事件的傳送。
|
擲回值
VideoError — 參數都無效。
|
相關 API 元素
assignTabIndexes | () | 方法 |
public function assignTabIndexes(startTabIndex:int):int| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
依照位置，由左至右水平排序 FLVPlayback 控制項，以將 tabIndex 值指定給每一個控制項。此方法會傳回下一個可用的 tabIndex 值。
如果您在呼叫 assignTabIndexes 時使用 NaN 做為 startTabbing 參數，而且 FLVPlayback 組件實體已經有指定的 tabIndex 值，則此方法會使用 FLVPlayback 組件實體的指定 tabIndex 做為 startTabIndex。
指定 FLVPlayback 外觀元素時，您應該在 FLVPlayback.SKIN_LOADED 事件後等候一個影格，然後再呼叫此方法，讓外觀元素控制項能夠初始化。
使用自訂控制項時，請在 FLVPlayback.READY 事件後等候一個影格，然後再呼叫此方法，讓自訂控制項能夠初始化。
參數
startTabIndex:int — FLVPlayback 控制項的開始 tabIndex。
|
int — FLVPlayback 控制項後方的下一個可用 tabIndex。
|
相關 API 元素
bringVideoPlayerToFront | () | 方法 |
public function bringVideoPlayerToFront(index:uint):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
將某個視訊播放程式置於數個視訊播放程式的前方。 可以用於視訊播放程式之間的自訂轉換效果。 預設的堆疊順序與 activeVideoPlayerIndex 屬性的順序相同：0 表示在最下面、1 在上面、2 在 1 的上面，依此類推。 不過，當您呼叫 bringVideoPlayerToFront() 方法時，此順序可能變更。 例如，2 可能會在最下面。
參數
index:uint — 數字，代表要移到前方之視訊播放程式的索引。
|
相關 API 元素
closeVideoPlayer | () | 方法 |
public function closeVideoPlayer(index:uint):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
關閉 NetStream 並刪除 index 參數所指定的視訊播放程式。 若關閉的視訊播放程式是作用中或可見的視訊播放程式，FLVPlayback 實體會將這個作用中和/或可見的視訊播放程式設定為預設的播放程式 (索引 0)。 您不能關閉預設的播放程式，如果嘗試這麼做，組件就會擲回錯誤。
參數
index:uint — 數字，代表要關閉之視訊播放程式的索引。
|
相關 API 元素
enterFullScreenDisplayState | () | 方法 |
public function enterFullScreenDisplayState():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | AIR 1.0, Flash Player 9.0.115.0 |
將 FLVPlayback 視訊播放程式設定為全螢幕。 呼叫這個方法的效果等同於按一下某些 FLVPlayback 外觀元素中內建的全螢幕切換按鈕，另外在「組件」面板的「Video」區段中的 FullScreenButton 也有同樣的作用。
這個方法支援 Flash Player 全螢幕視訊的硬體加速。 如果使用者的 Flash Player 版本不支援硬體加速，這個方法還是有效，而且全螢幕視訊的效果不變，運作方式會與沒有硬體加速支援時相同。
因為呼叫這個方法會將 Stage 類別的 displayState 屬性設為 StageDisplayState.FULL_SCREEN，所以它的限制與 displayState 屬性一樣。 如果不呼叫這個方法，反而直接將 stage.displayState 屬性設為 StageDisplayState.FULL_SCREEN 來實作全螢幕模式，就不會使用硬體加速。
只有當 fullScreenTakeOver 屬性設為 True (這是預設值) 時，才支援全螢幕。
相關 API 元素
範例 ( 如何使用本範例 )
enterFullScreenDisplayState() 方法，此事件處理常式於使用者按一下標準 Flash 按鈕 (myButton) 時觸發。
注意：在瀏覽器中測試這個範例。 在 Flash「發佈設定」對話方塊的「HTML」索引標籤上，選取「僅限 Flash - 允許全螢幕」範本。指定 Flash Player 9.0.115.0，並確定已在「格式」索引標籤上選取 Flash 和 HTML 格式。然後發佈產生的 HTML 檔，並在瀏覽器中開啟。
// Requires Button and FLVPlayback components in library.
import fl.video.FLVPlayback;
import fl.controls.Button;
var myButton:Button = new Button();
var myFLVPlybk:FLVPlayback = new FLVPlayback();
myButton.move(100, 240);
myButton.label = "Full Screen";
addChild(myButton);
addChild(myFLVPlybk);
myFLVPlybk.source = "http://helpexamples.com/flash/video/water.flv";
myButton.addEventListener(MouseEvent.CLICK, handleClick);
function handleClick(e:MouseEvent):void {
myFLVPlybk.enterFullScreenDisplayState();
}
findCuePoint | () | 方法 |
public function findCuePoint(timeNameOrCuePoint:*, type:String):Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
尋找 type 參數所指定且透過參數指定您想要之時間、名稱或時間與名稱組合的提示點類型。
如果您未提供提示點的 time 或 name 值，或者若 time 為 null 、undefined 或小於 0，而 name 為 null 或 undefined，則方法會擲回 VideoError 錯誤 1002。
此方法會在搜尋中包含停用的提示點。 您可以使用 isFLVCuePointEnabled() 方法，判斷是否已停用提示點。
參數
timeNameOrCuePoint:* — 這可以是指定時間的數字、指定名稱的字串，或是具有 time 和/或 name 屬性的物件。
如果此參數為字串，此方法會搜尋具有這個名稱的第一個提示點；如果找不到符合的提示點，則傳回 如果這個參數是數字，此方法就會搜尋並傳回具有這個時間的第一個提示點。 如果有多個提示點具有相同的時間 (只有 ActionScript 提示點才有可能)，就會按照英文字母順序傳回含有第一個名稱的提示點。 如果找不到符合的項目便傳回 如果這個參數是物件，此方法就會搜尋包含指定之 如果 time 為 | |
type:String (default = NaN)"actionscript"、"all"、"event"、"flv" 或 "navigation"。 您可以使用下列類別屬性來指定這些值：CuePointType.ACTIONSCRIPT、CuePointType.ALL、CuePointType.EVENT、CuePointType.FLV 和 CuePointType.NAVIGATION。 如果未指定此參數，則會預設為 "all"，這表示此方法會搜尋所有的提示點類型。 這是選擇性的。
|
Object — 物件，已找到之提示點物件的副本，具有下列額外屬性：
如果找不到符合的項目便傳回 |
擲回值
VideoError — 如果 time 屬性為 null、undefined 或小於 0，而 name 屬性為 null 或 undefined。
|
相關 API 元素
findNearestCuePoint | () | 方法 |
public function findNearestCuePoint(timeNameOrCuePoint:*, type:String):Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
尋找符合或早於您所指定之時間的指定提示點類型。 如果您同時指定時間和名稱，但是沒有較早的提示點符合該名稱，它就會尋找符合您所指定名稱的提示點。 否則，會傳回 null。 預設會搜尋所有提示點。
此方法會在搜尋中包含停用的提示點。 您可以使用 isFLVCuePointEnabled() 方法，判斷是否已停用提示點。
參數
timeNameOrCuePoint:* — 這可以是指定時間的數字、指定名稱的字串，或是具有 time 和/或 name 屬性的物件。
如果此參數為字串，此方法會搜尋具有這個名稱的第一個提示點；如果找不到符合的提示點，則傳回 如果此參數為數字，則會傳回在剛好這個時間或以前的最接近提示點。 如果在該時間或以前沒有提示點，則會傳回第一個提示點。 如果有多個提示點具有相同的時間 (只有 ActionScript 提示點才有可能)，就會按照英文字母順序傳回含有第一個名稱的提示點。 如果找不到符合的項目便傳回 如果這個參數是物件，此方法就會搜尋包含指定之 如果 time 為 | |
type:String (default = NaN)"actionscript"、"all"、"event"、"flv" 或 "navigation"。 您可以使用下列類別屬性來指定這些值：CuePointType.ACTIONSCRIPT、CuePointType.ALL、CuePointType.EVENT、CuePointType.FLV 和 CuePointType.NAVIGATION。 如果未指定此參數，則會預設為 "all"，這表示此方法會搜尋所有的提示點類型。 這是選擇性的。
|
Object — 物件，已找到之提示點物件的副本，具有下列額外屬性：
如果找不到符合的項目便傳回 |
擲回值
VideoError — 如果 time 為 null、undefined 或小於 0，而 name 為 null 或 undefined。
|
相關 API 元素
findNextCuePointWithName | () | 方法 |
public function findNextCuePointWithName(cuePoint:Object):Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在具有與 my_cuePoint.name 相同名稱的 my_cuePoint.array 中尋找下一個提示點。 my_cuePoint 物件必須是由 findCuePoint() 方法、findNearestCuePoint() 方法或上一個對這個方法的呼叫傳回的提示點物件。 此方法會使用這些方法加入至 CuePoint 物件的 array 參數。
此方法會在搜尋中包含停用的提示點。 您可以使用 isFLVCuePointEnabled() 方法，判斷是否已停用提示點。
參數
cuePoint:Object — 由 findCuePoint() 方法、findNearestCuePoint() 方法，或上一個對這個方法的呼叫傳回的提示點物件。
|
Object — 如果具有符合名稱的陣列內沒有其他提示點則為 null；否則便傳回具有其他屬性的提示點物件副本。
|
擲回值
VideoError — 當引數無效時。
|
getVideoPlayer | () | 方法 |
public function getVideoPlayer(index:Number):VideoPlayer| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
取得 index 參數指定的視訊播放程式。 可能的話，最好使用 FLVPlayback 方法和屬性來存取 VideoPlayer 方法和屬性。 每個 DisplayObject.name 屬性都是其轉換為字串的索引。
參數
index:Number — 數字，代表要取得之視訊播放程式的索引。
|
VideoPlayer — VideoPlayer 物件。
|
isFLVCuePointEnabled | () | 方法 |
public function isFLVCuePointEnabled(timeNameOrCuePoint:*):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
若 FLV 檔內嵌提示點已停用，便傳回 false。 您可以透過「Flash 視訊提示點」對話方塊設定 cuePoints 屬性或呼叫 setFLVCuePointEnabled() 方法，來停用提示點。
只有在 metadataLoaded 屬性為 true (或者metadata 屬性並非 null，或在 metadataReceived 事件之後) 時，這個函數的傳回值才有意義。 當 metadataLoaded 為 false時，此功能始終會傳回 true。
參數
timeNameOrCuePoint:* — 如果此參數是字串，則會傳回要檢查的提示點名稱；只有在所有具有此名稱的提示點已停用的情形下，才會傳回 false。
如果此參數是數字，它就是要檢查的提示點時間。 如果這個參數是物件，就會傳回含有相符 |
Boolean — 若 FLV 檔內嵌提示點已停用，便傳回 false。 您可以透過「Flash 視訊提示點」對話方塊設定 cuePoints 屬性或呼叫 setFLVCuePointEnabled() 方法，來停用提示點。
只有在 |
相關 API 元素
load | () | 方法 |
public function load(source:String, totalTime:Number = NaN, isLive:Boolean = false):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會開始載入 FLV 檔並提供將 autoPlay 屬性設定為 false 的捷徑，以及設定 source、totalTime 和 isLive 屬性 (如果有指定的話) 的捷徑。 如果 totalTime 和 isLive 屬性都是 undefined，就不會設定這些屬性。 如果 source 屬性為 undefined、null 或空字串，此方法就不會執行任何動作。
參數
source:String — 字串，指定要進行串流處理之 FLV 檔的 URL，以及串流的方式。 這個 URL 可以是本機路徑、FLV 檔的 HTTP URL、FLV 檔串流的 RTMP URL，或是 XML 檔的 HTTP URL。
| |
totalTime:Number (default = NaN) | |
isLive:Boolean (default = false)true。 只有從 Flash Media Server (FMS) 或其他「Flash 視訊串流服務」(FVSS) 進行串流處理時，這個值才有效。如果是採用 HTTP 下載的方式，這個屬性值會被忽略。 這是選擇性的。
|
相關 API 元素
pause | () | 方法 |
public function pause():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會暫停播放視訊串流。
如果播放已經開始，而您想要回到等待充分下載後才自動開始播放的狀態，請呼叫 pause() 方法，然後呼叫 playWhenEnoughDownloaded() 方法。
play | () | 方法 |
public function play(source:String = null, totalTime:Number = NaN, isLive:Boolean = false):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
播放視訊串流。 在沒有參數的情況下，此方法會將 FLV 檔從暫停或停止狀態轉換為播放狀態。
如果有使用參數，此方法的作用就會是將 autoPlay 屬性設定為 true 的捷徑，以及設定 isLive、totalTime 和 source 屬性的捷徑。 如果 totalTime 和 isLive 屬性都是 undefined，就不會設定這些屬性。
如果要等待漸進式下載的 FLV 充分載入才能自動開始播放，您可以呼叫 play() 方法並且不搭配任何參數，強制立即開始播放。
參數
source:String (default = null)source 屬性是選擇性的，但是若要設定，就必須透過「組件檢測器」或 ActionScript 來進行，否則這個方法就不會發揮作用。
| |
totalTime:Number (default = NaN) | |
isLive:Boolean (default = false)true。 只有從 Flash Media Server (FMS) 或其他「Flash 視訊串流服務」(FVSS) 進行串流處理時，這個值才有效。如果是採用 HTTP 下載的方式，這個屬性值會被忽略。 這是選擇性的。
|
相關 API 元素
playWhenEnoughDownloaded | () | 方法 |
public function playWhenEnoughDownloaded():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在充分下載 FLV 檔之後加以播放。 如果 FLV 檔已經下載或是從 Flash Media Server (FMS) 進行串流處理，則呼叫 playWhenEnoughDownloaded() 方法即等同於呼叫 play() 方法而且不搭配任何參數。 呼叫此方法不會暫停播放，因此在許多情況下，您可能需要先呼叫 pause() 方法，再呼叫此方法。
removeASCuePoint | () | 方法 |
public function removeASCuePoint(timeNameOrCuePoint:*):Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
從目前載入的 FLV 檔中移除 ActionScript 提示點。 只會使用 timeNameOrCuePoint 參數的 name 和 time 屬性來尋找要移除的提示點。
若同時有多個 ActionScript 提示點符合搜尋準則，只有一個提示點會遭移除。 若要移除所有提示點，您可以使用相同的參數在迴圈中重複呼叫這個函數，直到傳回null。
設定 source 屬性後，會清除提示點資訊，因此若要為下一個載入的 FLV 檔設定提示點資訊，請先設定 source 屬性。
參數
timeNameOrCuePoint:* — 要移除之提示點的提示點字串(包含 time 和 name 屬性)。 此方法會移除具有這個名稱的第一個提示點。 或者，如果這個參數是數字，此方法就會移除具有這個時間的第一個提示點。 如果這個參數是物件，此方法就會移除具有 time 和 name 屬性兩者的提示點。
|
Object — 已移除的提示點物件。 如果沒有相符的提示點，此方法會傳回 null。
|
相關 API 元素
seek | () | 方法 |
public function seek(time:Number):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會搜尋檔案中的指定時間點，以秒數為單位指定，取至三位小數位數 (毫秒)。
基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 第二，搜尋是非同步的，因此，如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。
參數
time:Number — 數字，指定放置播放磁頭的時間點，以秒為單位。
|
擲回值
VideoError — 如果 time < 0。
|
相關 API 元素
seekPercent | () | 方法 |
public function seekPercent(percent:Number):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
搜尋至檔案的百分比，並將播放磁頭置於該處。 百分比為介於 0 到 100 的數字。
基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 第二，搜尋是非同步的，因此，如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。
參數
percent:Number — 數字，指定要放置播放磁頭的 FLV 檔長度百分比。
|
擲回值
VideoError — 如果 percent 無效，或者 totalTime 為 undefined、null 或 <= 0。
|
相關 API 元素
seekSeconds | () | 方法 |
public function seekSeconds(time:Number):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
搜尋檔案中的指定時間點，以秒數為單位指定，取至三位小數位數 (毫秒)。 此方法執行的作業與 seek() 方法相同；它與 seekPercent() 方法是互相對應的。
基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 第二，搜尋是非同步的，因此，如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。
參數
time:Number — 數字，指定總播放時間中放置播放磁頭的時間點，以秒為單位。
|
相關 API 元素
seekToNavCuePoint | () | 方法 |
public function seekToNavCuePoint(timeNameOrCuePoint:*):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會搜尋至符合指定之時間、名稱或時間和名稱的瀏覽提示點。
此時間是以秒為單位的開始時間，用以指定要從哪一個時間點開始尋找下一個瀏覽提示點。 預設值為目前的 playheadTime 屬性。 如果指定時間，則此方法會搜尋符合該時間或以後時間的提示點。 如果時間為 undefined、null 或小於 0，則此方法會在時間為 0 處開始搜尋。
名稱是要搜尋的提示點。 此方法會搜尋至第一個具有此名稱的已啟用瀏覽提示點。
時間和名稱合起來就是在指定時間或之後、具有指定名稱的瀏覽提示點。
基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 第二，搜尋是非同步的，因此，如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。
參數
timeNameOrCuePoint:* — 表示時間的數字、表示名稱的字串，或同時表示指定名稱和時間的字串和數字。
|
擲回值
VideoError — 找不到符合準則的提示點。
|
相關 API 元素
seekToNextNavCuePoint | () | 方法 |
public function seekToNextNavCuePoint(time:Number = NaN):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會依據目前的 playheadTime 屬性值，搜尋至下一個瀏覽提示點。 這個方法會略過已停用的瀏覽提示點，如果沒有其他提示點，便會移到 FLV 檔的結尾。
基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 第二，搜尋是非同步的，因此，如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。
參數
time:Number (default = NaN)playheadTime 屬性。 這是選擇性的。
|
相關 API 元素
seekToPrevNavCuePoint | () | 方法 |
public function seekToPrevNavCuePoint(time:Number = NaN):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
依據目前的 playheadTime 屬性值，搜尋至上一個瀏覽提示點。 如果沒有上一個提示點，則會移至開頭部分。 此方法會略過已停用的瀏覽提示點。
基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 第二，搜尋是非同步的，因此，如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。
參數
time:Number (default = NaN)playheadTime 屬性的值。 這是選擇性的。
|
相關 API 元素
setFLVCuePointEnabled | () | 方法 |
public function setFLVCuePointEnabled(enabled:Boolean, timeNameOrCuePoint:*):Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
啟用或停用一或多個 FLV 檔提示點。 停用提示點的目的，是為了將這些提示點當做事件來傳送，以及為了使用 seekToPrevNavCuePoint()、seekToNextNavCuePoint() 和 seekToNavCuePoint() 方法。
當您將 source 屬性設定為不同的 FLV 檔時，就會刪除提示點資訊，所以請在設定下一個要載入的 FLV 檔的提示點資訊之前，先設定 source 屬性。
直到載入中繼資料之前，呼叫 isFLVCuePointEnabled() 方法都不會反映此方法所造成的變更。
參數
enabled:Boolean — Boolean 值，用以指定要啟用 (true) 或停用 (false) FLV 檔提示點。
| |
timeNameOrCuePoint:* — 如果此參數是字串，此方法就會啟用或停用含有這個名稱的提示點。 如果參數是數字，此方法就會啟用或停用含有這個 time 的提示點。 如果這個參數是物件，此方法就會啟用或停用同時具有 name 和 time 屬性的提示點。
|
Number — 若 metadataLoaded 為 true，此方法會傳回啟用狀態已變更的提示點個數。 如果 metadataLoaded 為 false，此方法會傳回 -1，因為組件無法決定要設定哪一個提示點 (如果有)。 不過，當中繼資料到達時，組件便會適當地設定指定的提示點。
|
相關 API 元素
setScale | () | 方法 |
public function setScale(scaleX:Number, scaleY:Number):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會同時設定 scaleX 和 scaleY 屬性。 因為個別設定其中一個屬性會觸發自動調整大小功能，所以同時設定 scaleX 和 scaleY 會比個別設定這兩個屬性來得有效率。
如果將 scaleMode 屬性設定為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，則呼叫此方法會立即引發 autolayout 事件。
參數
scaleX:Number — 代表水平縮放的數字。
| |
scaleY:Number — 代表垂直縮放的數字。
|
相關 API 元素
setSize | () | 方法 |
public function setSize(width:Number, height:Number):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
同時設定 width 和 height。 因為個別設定其中一個屬性會觸發自動調整大小功能，所以同時設定 width 和 height 屬性會比個別設定這兩個屬性來得有效率。
如果將 scaleMode 屬性設定為 VideoScaleMode.MAINTAIN_ASPECT_RATIO 或 VideoScaleMode.NO_SCALE，則呼叫此方法會立即引發 autolayout 事件。
參數
width:Number — 數字，指定視訊播放程式的寬度。
| |
height:Number — 數字，指定視訊播放程式的高度。
|
相關 API 元素
stop | () | 方法 |
public function stop():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
停止播放視訊串流。 如果 autoRewind 屬性為 true，FLV 檔會倒帶至開頭處。
autoLayout | 事件 |
fl.video.AutoLayoutEvent屬性 AutoLayoutEvent.type =
fl.video.AutoLayoutEvent.AUTO_LAYOUT| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在視訊播放程式自動調整大小或配置時傳送。 當載入新的 FLV 檔時，或者當 align 和 scaleMode 屬性中有一個變更時，便會根據這兩個屬性的值自動配置視訊播放程式。
autoLayout 事件的類型為 AutoLayoutEvent，而且具有常數 AutoLayoutEvent.AUTO_LAYOUT。
嘗試自動配置視訊播放程式之後，即使尺寸沒有變更，也會傳送事件物件。
LayoutEvent 事件也會在下列三種情形下傳送：
- 如果進行配置的視訊播放程式為可見。
- 如果有兩個不同大小或位置的視訊播放程式，而且
visibleVideoPlayerIndex屬性從其中一個視訊播放程式切換至另一個播放程式。 - 如果呼叫會變更視訊播放程式大小的方法或屬性，例如
setSize()、setScale()、width、height、scaleX、scaleY、registrationWidth和registrationHeight。
如果有多個視訊播放程式實體正在使用中，這個事件可能不會套用至可看見的視訊播放程式。
定義autoLayout 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
oldBounds | 在 autoLayout 事件發生之前，目標的 x、y、width 和 height 屬性值。 |
oldRegistrationBounds | 在 autoLayout 事件發生之前，目標的 registrationX、registrationY、registrationWidth 和 registrationHeight 屬性值。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
autoRewound | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.AUTO_REWOUND| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當播放磁頭移到視訊播放程式的開頭 (因為 autoRewind 屬性設定為 true) 時傳送。 在傳送 autoRewound 事件時，也會傳送 rewind 事件。
autoRewound 事件的類型為 VideoEvent，而且具有常數 VideoEvent.AUTO_REWOUND。
autoRewound 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
bufferingStateEntered | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.BUFFERING_STATE_ENTERED| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當 FLVPlayback 實體進入緩衝狀態時傳送。 FLVPlayback 實體進入播放狀態之前，通常會在呼叫 play() 方法之後，或者當使用者按一下 Play 控制項時，立即進入此狀態。
stateChange 事件也會一併傳送。
bufferingStateEntered 事件的類型為 VideoEvent 而且具有常數 VideoEvent.BUFFERING_STATE_ENTERED。
bufferingStateEntered 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
close | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.CLOSE| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當事件物件關閉 NetConnection (無論是因為逾時或透過呼叫 closeVideoPlayer() 方法)，或者您呼叫 load() 或 play() 方法或設定 source 屬性因而造成 RTMP 連線關閉時，都會傳送此事件。 只有從 Flash Media Server (FMS) 或其他「Flash 視訊串流服務」(FVSS) 進行串流處理時，FLVPlayback 實體才會傳送這個事件。
close 事件的類型為 VideoEvent 而且具有常數 VideoEvent.CLOSE。
close 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
complete | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.COMPLETE| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當播放作業因為播放程式到達 FLV 檔的結尾而完成時傳送。 若您呼叫 stop() 或 pause() 方法，或者按一下對應的控制項，則組件不會傳送這個事件。
在應用程式使用漸進式下載時，不會明確地設定 totalTime 屬性，並且會下載內含中繼資料持續時間的 FLV 檔案。 視訊播放程式會在傳送此事件前，將 totalTime 屬性設定為近似的總值。
視訊播放程式也會傳送 stateChange 和 stoppedStateEntered 事件。
complete 事件的類型為 VideoEvent 而且具有常數 VideoEvent.COMPLETE。
complete 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
cuePoint | 事件 |
fl.video.MetadataEvent屬性 MetadataEvent.type =
fl.video.MetadataEvent.CUE_POINT| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
到達提示點時傳送。事件物件具有 info 屬性，其中包含由 FLV 檔提示點的 NetStream.onCuePoint 回呼所接收到的 info 物件。 若為 ActionScript 提示點，它就會包含傳入 ActionScript 提示點方法或屬性的物件。
cuePoint 事件的類型為 MetadataEvent 而且具有常數 MetadataEvent.CUE_POINT。
cuePoint 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
info | 物件，其中含有描述提示點的屬性。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
fastForward | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.FAST_FORWARD| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當播放磁頭的位置因為呼叫 seek() 方法或按一下 ForwardButton 控制項而向前移動時傳送。
FLVPlayback 實體也會一併傳送 playheadUpdate 事件。
fastForward 事件的類型為 VideoEvent 而且具有常數 VideoEvent.FAST_FORWARD。
fastForward 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
layout | 事件 |
fl.video.LayoutEvent屬性 LayoutEvent.type =
fl.video.LayoutEvent.LAYOUT| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在視訊播放程式調整大小或配置時傳送。 以下是兩種配置案例：
- 如果配置視訊播放程式的方式是使用
autoLayout事件、呼叫setScale()或setSize()方法，或變更width、height、scaleX和scaleY屬性。 - 如果有兩個不同大小的視訊播放程式，而且
visibleVideoPlayerIndex屬性從其中一個視訊播放程式切換至另一個播放程式。
layout 事件的類型為 LayoutEvent，而且具有常數 LayoutEvent.LAYOUT。
layout 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
oldBounds | 在 layout 事件發生之前，目標的 x、y、width 和 height 屬性值。 |
oldRegistrationBounds | 在 layout 事件發生之前，目標的 registrationX、registrationY、registrationWidth 和 registrationHeight 屬性值。 |
相關 API 元素
metadataReceived | 事件 |
fl.video.MetadataEvent屬性 MetadataEvent.type =
fl.video.MetadataEvent.METADATA_RECEIVED| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在初次到達 FLV 檔的中繼資料時傳送。 事件物件具有 info 屬性，其中包含由 NetStream.onMetaData 回呼所接收到的 info 物件。
metadataReceived 事件的類型為 MetadataEvent 而且具有常數 MetadataEvent.METADATA_RECEIVED。
metadataReceived 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
info | 物件，其中含有描述 FLV 檔的屬性。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
pausedStateEntered | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.PAUSED_STATE_ENTERED| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在播放程式進入暫停狀態時傳送。 當您呼叫 pause() 方法或按一下對應的控制項時會發生這個事件；在某些情況下，若 autoPlay 屬性為 false，載入 FLV 檔時也會發生這個事件 (狀態可能會變成 stopped)。
stateChange 事件也會一併傳送。
pausedStateEntered 事件的類型為 VideoEvent 而且具有常數 VideoEvent.PAUSED_STATE_ENTERED。
pausedStateEntered 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
playheadUpdate | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.PLAYHEAD_UPDATE| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在 FLV 檔案按照 playheadUpdateInterval 屬性指定的頻率播放，或者開始倒帶時傳送。 除非出現搜尋的動作，否則當視訊播放程式暫停或停止時，組件不會傳送這個事件。
playheadUpdate 事件的類型為 VideoEvent 而且具有常數 VideoEvent.PLAYHEAD_UPDATE。
playheadUpdate 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
playingStateEntered | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.PLAYING_STATE_ENTERED| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
進入播放狀態時傳送。這個事件可能不會在您呼叫了 play() 方法或按一下對應的控制項後立即發生；通常會先進入緩衝狀態，然後才進入播放狀態。
FLVPlayback 實體也會傳送 stateChange 事件。
playingStateEntered 事件的類型為 VideoEvent 而且具有常數 VideoEvent.PLAYING_STATE_ENTERED。
playingStateEntered 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
progress | 事件 |
fl.video.VideoProgressEvent屬性 VideoProgressEvent.type =
fl.video.VideoProgressEvent.PROGRESS| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
指出已下載完成的進度，以位元組數目表示。 事件；依 progressInterval 屬性指定的頻率傳送，從載入開始，到所有位元組都已載入或出現網路錯誤時結束。 預設值為每隔 0.25 秒一次；從呼叫 load 開始，直到所有位元組都已載入或出現網路錯誤時結束。 您可以使用這個事件，檢查載入之位元組或緩衝區中的位元組數目。
只會針對漸進式 HTTP 下載傳送。 指出下載的進度，以位元組數目表示。 事件物件具有 bytesLoaded 和 bytesTotal 屬性，這些屬性與 FLVPlayback 屬性的名稱相同。
progress 事件的類型為 VideoProgressEvent 而且具有常數 VideoProgressEvent.PROGRESS。
progress 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
bytesLoaded | 在偵聽程式處理事件時，載入的項目或位元組數目。 |
bytesTotal | 如果載入程序成功，將載入的總項目數量或位元組數。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
ready | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.READY| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當 FLV 檔已載入並可以顯示畫面時傳送。 它會在您使用 play() 或 load() 方法時載入新的 FLV 檔案後，於第一次進入回應狀態時啟動。 它只會為每個載入的 FLV 檔啟動一次。
ready 事件的類型為 VideoEvent 而且具有常數 VideoEvent.READY。
ready 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
rewind | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.REWIND| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當播放磁頭的位置因為呼叫 seek() 而向後移動或者當 autoRewind 呼叫完成時傳送。 在完成 autoRewind 呼叫時，會先觸發 autoRewound 事件。
rewind 事件的類型為 VideoEvent 而且具有常數 VideoEvent.REWIND。
rewind 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
scrubFinish | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.SCRUB_FINISH| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在使用者停止使用搜尋列拖曳 FLV 檔時傳送。 「拖曳」是指抓取 SeekBar 的控制點，並拖曳它來尋找 FLV 檔中的特定場景。 當使用者放開搜尋列的控制點時，就會停止拖曳。
組件也會傳送內含 state 屬性 (可能是 playing、paused、stopped 或 buffering) 的 stateChange 事件。 state 屬性會進行搜尋，直到使用者完成拖曳為止。
scrubFinish 事件的類型為 VideoEvent 而且具有常數 VideoEvent.SCRUB_FINISH。
scrubFinish 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
scrubStart | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.SCRUB_START| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在使用者開始使用搜尋列拖曳 FLV 檔時傳送。 「拖曳」是指抓取 SeekBar 的控制點，並拖曳它來尋找 FLV 檔中的特定場景。 當使用者按一下 SeekBar 控制點時，會開始拖曳，而當使用者放開控制點時便會結束拖曳。
組件也會傳送內含 state 屬性 (與搜尋相同) 的 stateChange 事件。 在使用者停止拖曳之前，state 會維持為 seeking。
scrubStart 事件的類型為 VideoEvent 而且具有常數 VideoEvent.SCRUB_START。
scrubStart 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
seeked | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.SEEKED| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當播放磁頭的位置因為呼叫 seek()、設定 playheadTime 屬性或使用 SeekBar 控制項而變更時傳送。 playheadTime 屬性為目標時間。
seeked 事件的類型為 VideoEvent 而且具有常數 VideoEvent.SEEKED。
往後搜尋時，FLVPlayback 實體會傳送 rewind 事件，往前搜尋時，則會傳送 fastForward 事件。 它也會傳送 playheadUpdate 事件。
基於幾個原因，在呼叫其中一個搜尋方法或設定 playheadTime 以觸發搜尋之後，playheadTime 屬性可能無法立即取得預期的值。 第一，以漸進式下載而言，您只能搜尋關鍵影格，所以，將會搜尋到指定時間之後的第一個關鍵影格的時間 (在進行串流處理時，一定會搜尋到精確的指定時間，即使來源 FLV 檔沒有關鍵影格也是如此)。 第二，搜尋是非同步的，因此，如果您呼叫搜尋方法或設定 playheadTime 屬性，playheadTime 並不會立即更新。 若要取得搜尋完成後的時間，請偵聽 seek 事件，此事件會在 playheadTime 屬性更新之後發生。
seeked 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
skinError | 事件 |
fl.video.SkinErrorEvent屬性 SkinErrorEvent.type =
fl.video.SkinErrorEvent.SKIN_ERROR| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
載入外觀元素 SWF 檔發生錯誤時傳送。這個事件具有包含錯誤訊息的 message 屬性。 如果設定了外觀元素 SWF 檔，便會在 ready 事件和 skinLoaded (或 skinError ) 事件皆啟動時播放。
skinError 事件的類型為 SkinErrorEvent 而且具有常數 SkinErrorEvent.SKIN_ERROR。
skinError 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
text | 錯誤訊息。 |
相關 API 元素
skinLoaded | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.SKIN_LOADED| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
載入外觀元素 SWF 檔時傳送。在 ready 和 skinLoaded (或 skinError) 事件發生之前，組件不會開始播放 FLV 檔。
skinLoaded 事件的類型為 VideoEvent 而且具有常數 VideoEvent.SKIN_LOADED。
skinLoaded 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
soundUpdate | 事件 |
fl.video.SoundEvent屬性 SoundEvent.type =
fl.video.SoundEvent.SOUND_UPDATE| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當使用者移動 volumeBar 控制項的控制點，或設定 volume 或 soundTransform 屬性而導致聲音變更時傳送。
soundUpdate 事件的類型為 SoundEvent，而且具有常數 SoundEvent.SOUND_UPDATE。
type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
soundTransform | 表示音量和左右相位的新值。 |
相關 API 元素
stateChange | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.STATE_CHANGE| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
播放狀態變更時傳送。當 autoRewind 呼叫完成時，會傳送內含 rewinding 狀態的 stateChange 事件。 stateChange 事件會在自動倒帶完成之後開始。
這個事件可用來追蹤播放進入或離開無回應狀態 (例如，在連線、調整大小或倒帶中途) 的時間。 play()、pause()、stop() 和 seek() 方法將會播放程式進入回應狀態時要執行的要求排入佇列。
stateChange 事件的類型為 VideoEvent 而且具有常數 VideoEvent.STATE_CHANGE。
stateChange 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
stoppedStateEntered | 事件 |
fl.video.VideoEvent屬性 VideoEvent.type =
fl.video.VideoEvent.STOPPED_STATE_ENTERED| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
在進入停止狀態時傳送。 當您呼叫 stop() 方法或按一下 stopButton 控制項時會發生這個事件。 在某些情況下，若 autoPlay 屬性為 false，載入 FLV 檔時也會發生這個事件 (狀態可能會變成 paused)。 當播放磁頭停在 FLV 檔的結尾 (因為它已到達時間軸的結尾) 時，FLVPlayback 實體也會傳送這個事件。
FLVPlayback 實體也會傳送 stateChange 事件。
stoppedStateEntered 事件的類型為 VideoEvent 而且具有常數 VideoEvent.STOPPED_STATE_ENTERED。
stoppedStateEntered 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
state | 字串，用以識別 VideoState 類別中描述組件播放狀態的常數。 |
playheadTime | 數字，表示目前的播放磁頭時間或位置。 |
vp | VideoPlayer 物件的索引。 |
相關 API 元素
SHORT_VERSION | 常數 |
public static const SHORT_VERSION:String = "2.1"| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
狀態變數，指出組件的簡短版本號碼。 當您有 FLA 檔，並且需要知道組件版本時，版本號碼就會非常有用。 若要確定組件版本，請在 FLA 檔中輸入下列追蹤程式碼：
FLVPlayback.SHORT_VERSION
SHORT_VERSION 變數只包含主要和次要版本號碼，例如 2.0。VERSION 變數包含主要和次要版本號碼，以及修訂和組建編號，例如 2.0.0.11。
相關 API 元素
VERSION | 常數 |
public static const VERSION:String = "2.1.0.23"| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS3 |
| 執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
狀態變數，指出組件的完整版本號碼。 當您有 FLA 檔，並且需要知道組件版本時，版本號碼就會非常有用。 若要確定組件版本，請在 FLA 檔中輸入下列追蹤程式碼：
FLVPlayback.VERSION
VERSION 變數包含主要和次要版本號碼，以及修訂和組建編號，例如 2.0.0.11。SHORT_VERSION 變數只包含主要和次要版本號碼，例如 2.0。
相關 API 元素
若要執行範例，請遵循下列步驟：
- 將 FLVPlayback 組件放在「舞台」上 0,0 的位置，並提供實體名稱
player。 - 以 FLV 檔的絕對或相對路徑取代
videoPath。 - 將此程式碼另存為 FLVPlaybackExample.as，與 FLA 檔放在同一個目錄中。
- 將 FLA 檔中的 Document 類別設定為 FLVPlaybackExample。
package
{
import fl.video.FLVPlayback;
import flash.display.Sprite;
public class FLVPlaybackExample extends Sprite {
private var videoPath:String = "http://www.helpexamples.com/flash/video/caption_video.flv";
public function FLVPlaybackExample() {
player.source = videoPath;
player.skinBackgroundColor = 0x666666;
player.skinBackgroundAlpha = 0.5;
}
}
}
Tue Jun 12 2018, 03:47 PM Z