FLVPlayback

套件	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

FLVPlayback 會擴充 Sprite 類別，並包覆 VideoPlayer 物件。 注意：本文件需搭配具輔助功能的 FLVPlayback 組件使用。

本文件更新了「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);

檢視範例

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		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 實體。	FLVPlayback
		addASCuePoint(timeOrCuePoint:*, name:String = null, parameters:Object = null):Object 新增 ActionScript 提示點，並且具有與使用「提示點」對話方塊新增 ActionScript 提示點相同的作用，不過只有在執行應用程式時 (而非開發應用程式期間) 才能發揮作用。	FLVPlayback
		addChild(child:DisplayObject):DisplayObject 將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。	DisplayObjectContainer
		assignTabIndexes(startTabIndex:int):int 依照位置，由左至右水平排序 FLVPlayback 控制項，以將 tabIndex 值指定給每一個控制項。	FLVPlayback
		bringVideoPlayerToFront(index:uint):void 將某個視訊播放程式置於數個視訊播放程式的前方。	FLVPlayback
		closeVideoPlayer(index:uint):void 關閉 NetStream 並刪除 index 參數所指定的視訊播放程式。	FLVPlayback
		contains(child:DisplayObject):Boolean 判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系，或為實體本身。	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		enterFullScreenDisplayState():void 將 FLVPlayback 視訊播放程式設定為全螢幕。	FLVPlayback
		findCuePoint(timeNameOrCuePoint:*, type:String):Object 尋找 type 參數所指定且透過參數指定您想要之時間、名稱或時間與名稱組合的提示點類型。	FLVPlayback
		findNearestCuePoint(timeNameOrCuePoint:*, type:String):Object 尋找符合或早於您所指定之時間的指定提示點類型。	FLVPlayback
		findNextCuePointWithName(cuePoint:Object):Object 在具有與 my_cuePoint.name 相同名稱的 my_cuePoint.array 中尋找下一個提示點。	FLVPlayback
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。	DisplayObject
		getChildAt(index:int):DisplayObject 傳回存在於指定索引位置的子顯示物件實體。	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 傳回具有指定名稱的子顯示物件。	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 傳回 child DisplayObject 實體的索引位置。	DisplayObjectContainer
		getObjectsUnderPoint(point:Point):Array 傳回位於指定點底下，且屬於此 DisplayObjectContainer 實體之子系 (或孫系，以下類推) 的物件陣列。	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 根據 targetCoordinateSpace 參數所定義的座標系統，並排除形狀上的任何筆畫，傳回可定義顯示物件邊界的矩形。	DisplayObject
		getVideoPlayer(index:Number):VideoPlayer 取得 index 參數所指定的視訊播放程式。	FLVPlayback
		globalToLocal(point:Point):Point 將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。	DisplayObject
		globalToLocal3D(point:Point):Vector3D 將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。	DisplayObject
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		hitTestObject(obj:DisplayObject):Boolean 評估顯示物件的範圍框，看它是否與 obj 顯示物件的範圍框重疊或相交。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 評估顯示物件，看它是否與 x 和 y 參數所指定的點重疊或相交。	DisplayObject
		isFLVCuePointEnabled(timeNameOrCuePoint:*):Boolean 若 FLV 檔內嵌提示點已停用，便傳回 false。	FLVPlayback
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		load(source:String, totalTime:Number = NaN, isLive:Boolean = false):void 會開始載入 FLV 檔並提供將 autoPlay 屬性設定為 false 的捷徑，以及設定 source、totalTime 和 isLive 屬性 (如果有指定的話) 的捷徑。	FLVPlayback
		local3DToGlobal(point3d:Vector3D):Point 將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。	DisplayObject
		localToGlobal(point:Point):Point 將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。	DisplayObject
		pause():void 會暫停播放視訊串流。	FLVPlayback
		play(source:String = null, totalTime:Number = NaN, isLive:Boolean = false):void 播放視訊串流。	FLVPlayback
		playWhenEnoughDownloaded():void 在充分下載 FLV 檔之後加以播放。	FLVPlayback
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		removeASCuePoint(timeNameOrCuePoint:*):Object 從目前載入的 FLV 檔中移除 ActionScript 提示點。	FLVPlayback
		removeChild(child:DisplayObject):DisplayObject 將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject 從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void 將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		requestSoftKeyboard():Boolean 升起顯示虛擬鍵盤。	InteractiveObject
		seek(time:Number):void 會搜尋檔案中的指定時間點，以秒數為單位指定，取至三位小數位數 (毫秒)。	FLVPlayback
		seekPercent(percent:Number):void 搜尋至檔案的百分比，並將播放磁頭置於該處。	FLVPlayback
		seekSeconds(time:Number):void 搜尋檔案中的指定時間點，以秒數為單位指定，取至三位小數位數 (毫秒)。	FLVPlayback
		seekToNavCuePoint(timeNameOrCuePoint:*):void 會搜尋至符合指定之時間、名稱或時間和名稱的瀏覽提示點。	FLVPlayback
		seekToNextNavCuePoint(time:Number = NaN):void 會依據目前的 playheadTime 屬性值，搜尋至下一個瀏覽提示點。	FLVPlayback
		seekToPrevNavCuePoint(time:Number = NaN):void 依據目前的 playheadTime 屬性值，搜尋至上一個瀏覽提示點。	FLVPlayback
		setChildIndex(child:DisplayObject, index:int):void 變更顯示物件容器中現有子系的位置。	DisplayObjectContainer
		setFLVCuePointEnabled(enabled:Boolean, timeNameOrCuePoint:*):Number 啟用或停用一或多個 FLV 檔提示點。	FLVPlayback
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		setScale(scaleX:Number, scaleY:Number):void 同時設定 scaleX 和 scaleY 屬性。	FLVPlayback
		setSize(width:Number, height:Number):void 同時設定 width 和 height。	FLVPlayback
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 讓使用者拖曳指定的 sprite。	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void 讓使用者將指定的 Sprite 拖曳至觸控裝置上。	Sprite
		stop():void 停止播放視訊串流。	FLVPlayback
		stopAllMovieClips():void 遞迴停止執行所有 MovieClips 的時間軸根源於此物件。	DisplayObjectContainer
		stopDrag():void 結束 startDrag() 方法。	Sprite
		stopTouchDrag(touchPointID:int):void 結束觸控裝置使用的 startTouchDrag() 方法。	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 替換兩個指定子物件的 z 順序 (深度階層，由前至後順序)。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 在子清單的兩個指定索引位置，替換子物件的 z 順序 (深度階層，由前至後順序)。	DisplayObjectContainer
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
added	當顯示物件加入顯示清單中時傳送。	DisplayObject
addedToStage	會在顯示物件加入舞台上的顯示清單時，以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。	DisplayObject
autoLayout	在視訊播放程式自動調整大小或配置時傳送。	FLVPlayback
autoRewound	當播放磁頭移到視訊播放程式的開頭 (因為 autoRewind 屬性設定為 true) 時傳送。	FLVPlayback
bufferingStateEntered	當 FLVPlayback 實體進入緩衝狀態時傳送。	FLVPlayback
clear	當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。	InteractiveObject
click	會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。	InteractiveObject
close	當事件物件關閉 NetConnection (無論是因為逾時或透過呼叫 closeVideoPlayer() 方法)，或者您呼叫 load() 或 play() 方法或設定 source 屬性因而造成 RTMP 連線關閉時，都會傳送此事件。	FLVPlayback
complete	當播放作業因為播放程式到達 FLV 檔的結尾而完成時傳送。	FLVPlayback
contextMenu	當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。	InteractiveObject
copy	當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。	InteractiveObject
cuePoint	到達提示點時傳送。	FLVPlayback
cut	當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。	InteractiveObject
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
doubleClick	在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下，當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。	InteractiveObject
enterFrame	[廣播事件] 當播放磁頭進入新影格時傳送。	DisplayObject
exitFrame	[廣播事件] 當播放磁頭結束目前影格時傳送。	DisplayObject
fastForward	當播放磁頭的位置因為呼叫 seek() 方法或按一下 ForwardButton 控制項而向前移動時傳送。	FLVPlayback
focusIn	當顯示物件取得焦點之後傳送。	InteractiveObject
focusOut	當顯示物件失去焦點時傳送。	InteractiveObject
frameConstructed	[廣播事件] 在影格顯示物件的建構函式執行之後，且影格指令碼執行之前傳送。	DisplayObject
gestureDirectionalTap	當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選)，某些裝置可能也會將此接觸解譯為數個觸控事件的組合。	InteractiveObject
gestureLongPress	當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方，以兩支手指按下後鬆開)。	InteractiveObject
gesturePan	當使用者在觸控裝置上，將接觸點移動到 InteractiveObject 實體上方後傳送 (例如，在行動電話或平板電腦觸控螢幕的顯示物件上，由左向右移動手指)。	InteractiveObject
gestureRotate	當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上旋轉)。	InteractiveObject
gestureSwipe	當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如，三指併在一起觸碰行動電話或平板電腦的觸控螢幕，然後在顯示物件上快速平行移動手指)。	InteractiveObject
gestureTap	當使用者與 InteractiveObject 實體建立接觸點，然後在觸控裝置上點一下後送出 (例如，將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單，然後其中一根手點一下，選取選單項目)。	InteractiveObject
gestureZoom	當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上快速張開)。	InteractiveObject
imeStartComposition	這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。	InteractiveObject
keyDown	會當使用者按下按鍵時傳送。	InteractiveObject
keyFocusChange	當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。	InteractiveObject
keyUp	會當使用者放開按鍵時傳送。	InteractiveObject
layout	在視訊播放程式調整大小或配置時傳送。	FLVPlayback
metadataReceived	在初次到達 FLV 檔的中繼資料時傳送。	FLVPlayback
middleClick	當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。	InteractiveObject
middleMouseDown	當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
middleMouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
mouseDown	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
mouseFocusChange	會當使用者嘗試使用指向裝置變更焦點時傳送。	InteractiveObject
mouseMove	會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。	InteractiveObject
mouseOut	會當使用者將指向裝置移開 InteractiveObject 實體時傳送。	InteractiveObject
mouseOver	會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。	InteractiveObject
mouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
mouseWheel	當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。	InteractiveObject
nativeDragComplete	當使用者釋放手勢時，由拖曳初始程式 InteractiveObject 傳送。	InteractiveObject
nativeDragDrop	已在目標 InteractiveObject 上放下拖曳的物件，而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時，由此目標 InteractiveObject 傳送。	InteractiveObject
nativeDragEnter	當手勢進入 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。	InteractiveObject
nativeDragExit	當手勢離開 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。	InteractiveObject
nativeDragOver	當拖曳手勢還留在 InteractiveObject 的邊界內，由此 InteractiveObject 持續傳送。	InteractiveObject
nativeDragStart	在呼叫 DragManager.doDrag() 進行拖曳作業初期，由指定做為拖曳初始程式的 InteractiveObject 傳送。	InteractiveObject
nativeDragUpdate	在呼叫 DragManager.doDrag() 進行拖曳作業期間，由指定做為拖曳初始程式的 InteractiveObject 傳送。	InteractiveObject
paste	當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。	InteractiveObject
pausedStateEntered	在播放程式進入暫停狀態時傳送。	FLVPlayback
playheadUpdate	當 FLV 檔以 playheadUpdateInterval 屬性指定的頻率播放或開始倒帶時傳送。	FLVPlayback
playingStateEntered	進入播放狀態時傳送。	FLVPlayback
progress	指出已下載完成的進度，以位元組數目表示。	FLVPlayback
proximityBegin	在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。	InteractiveObject
proximityEnd	在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。	InteractiveObject
proximityMove	在使用者將作用中觸控筆移到螢幕上方，而其餘仍在鄰近偵測邊框內時傳送。	InteractiveObject
proximityOut	在使用者將作用中觸控筆移出這個 InteractiveObject 之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityOver	在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityRollOut	在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityRollOver	在使用者透過這個 InteractiveObject，從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。	InteractiveObject
ready	當 FLV 檔已載入並可以顯示畫面時傳送。	FLVPlayback
releaseOutside	當使用者第一次按下 InteractiveObject 實體上方的按鈕，然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。	InteractiveObject
removed	會當顯示物件將要從顯示清單移除時傳送。	DisplayObject
removedFromStage	會在顯示物件即將從顯示清單移除時，以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。	DisplayObject
render	[廣播事件] 當顯示清單將要更新和顯示時傳送。	DisplayObject
rewind	當播放磁頭的位置因為呼叫 seek() 而向後移動或者當 autoRewind 呼叫完成時傳送。	FLVPlayback
rightClick	當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。	InteractiveObject
rightMouseDown	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
rightMouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
rollOut	會當使用者將指向裝置移開 InteractiveObject 實體時傳送。	InteractiveObject
rollOver	會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。	InteractiveObject
scrubFinish	在使用者停止使用搜尋列拖曳 FLV 檔時傳送。	FLVPlayback
scrubStart	在使用者開始使用搜尋列拖曳 FLV 檔時傳送。	FLVPlayback
seeked	當播放磁頭的位置因為呼叫 seek()、設定 playheadTime 屬性或使用 SeekBar 控制項而變更時傳送。	FLVPlayback
selectAll	當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。	InteractiveObject
skinError	載入外觀元素 SWF 檔發生錯誤時傳送。	FLVPlayback
skinLoaded	載入外觀元素 SWF 檔時傳送。	FLVPlayback
softKeyboardActivate	升起顯示軟體鍵盤之後立即傳送。	InteractiveObject
softKeyboardActivating	升起顯示軟體鍵盤前立即傳送。	InteractiveObject
softKeyboardDeactivate	降下隱藏軟體鍵盤之後立即傳送。	InteractiveObject
soundUpdate	當使用者移動 volumeBar 控制項的控制點，或設定 volume 或 soundTransform 屬性而導致聲音變更時傳送。	FLVPlayback
stateChange	播放狀態變更時傳送。	FLVPlayback
stoppedStateEntered	在進入停止狀態時傳送。	FLVPlayback
tabChildrenChange	在物件的 tabChildren 旗標值變更時傳送。	InteractiveObject
tabEnabledChange	在物件的 tabEnabled 旗標變更時傳送。	InteractiveObject
tabIndexChange	在物件的 tabIndex 屬性值變更時傳送。	InteractiveObject
textInput	當使用者輸入一或多文字的字元時送出。	InteractiveObject
touchBegin	當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。	InteractiveObject
touchEnd	當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。	InteractiveObject
touchMove	當使用者觸控裝置時傳送，並且連續不斷地傳送，直到接觸點移除為止。	InteractiveObject
touchOut	當使用者在觸控裝置中，將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件移至另一個顯示物件)。	InteractiveObject
touchOver	當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。	InteractiveObject
touchRollOut	當使用者在觸控裝置上，將接觸點從 InteractiveObject 實體移出後送出 (例如，在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件上方拖曳到顯示物件以外)。	InteractiveObject
touchRollOver	當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。	InteractiveObject
touchTap	當使用者在觸控裝置的同一個 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 元素

visibleVideoPlayerIndex

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

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

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):void

backButton

屬性

backButton:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

BackButton 播放控制項。按一下便會呼叫 seekToPrevNavCuePoint() 方法。

實作
public function get backButton():Sprite
public function set backButton(value:Sprite):void

相關 API 元素

seekToPrevNavCuePoint()

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):void

buffering

屬性

buffering:Boolean [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

Boolean 值，當視訊處於緩衝狀態時則為 true。

實作
public function get buffering():Boolean

bufferingBar

屬性

bufferingBar:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

緩衝列控制項。此控制項會在 FLV 檔處於載入或緩衝狀態時顯示。

實作
public function get bufferingBar():Sprite
public function set bufferingBar(value:Sprite):void

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):void

bufferTime

屬性

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 元素

VideoPlayer.bufferTime
isLive

bytesLoaded

屬性

bytesLoaded:uint [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

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

實作
public function get bytesLoaded():uint

bytesTotal

屬性

bytesTotal:uint [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

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

實作
public function get bytesTotal():uint

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

endTabIndex

屬性

endTabIndex:int [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

傳回 FLVPlayback 控制項後方的下一個可用 tabIndex 值。此值於呼叫 assignTabIndexes 方法後設定。

實作
public function get endTabIndex():int

相關 API 元素

assignTabIndexes()

forwardButton

屬性

forwardButton:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

「快轉」按鈕控制項。按一下便會呼叫 seekToNextNavCuePoint() 方法。

實作
public function get forwardButton():Sprite
public function set forwardButton(value:Sprite):void

相關 API 元素

seekToNextNavCuePoint()

fullScreenBackgroundColor

屬性

fullScreenBackgroundColor:uint

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

在全螢幕佔用模式中使用的背景顏色。如果視訊根據 scaleMode 屬性值，未佈滿整個螢幕，則可看見此顏色。

預設值為 0x000000。

實作
public function get fullScreenBackgroundColor():uint
public function set fullScreenBackgroundColor(value:uint):void

fullScreenButton

屬性

fullScreenButton:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

FullScreen 按鈕控制項。

實作
public function get fullScreenButton():Sprite
public function set fullScreenButton(value:Sprite):void

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):void

fullScreenTakeOver

屬性

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):void

height

屬性

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 元素

setSize()

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 元素

bufferTime
source
VideoPlayer.isLive

isRTMP

屬性

isRTMP:Boolean [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

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

實作
public function get isRTMP():Boolean

相關 API 元素

VideoPlayer.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。每個物件都有下列屬性： `type` -- 字串，用以將提示點類型指定為 "navigation" 或 "event"。 `name` -- 代表提示點名稱的字串。 `time` -- 數字，具有三位小數位數 (毫秒) 的提示點時間，以秒為單位。 `parameters` -- 具有使用者在建立提示點時所指定之名稱值配對的選擇性物件。
`audiocodecid`	指定所使用之音效轉碼器 (編碼/解碼技術) 的數字。
`audiodelay`	數字，代表 FLV 檔編碼來源檔案中的時間 `0`。視訊內容因為需要同步化音訊而短暫延遲一段時間。例如，如果 `audiodelay` 值為 `.038`，則在來源檔案中開始時間為 `0` 的視訊，在 FLV 檔中的開始時間便為 `.038`。請注意，FLVPlayback 和 VideoPlayer 類別會在其時間設定中補正這個延遲時間。這表示您可以繼續使用在來源檔案中使用的時間設定。
`audiodatarate`	每秒音訊 KB 數目。
`videocodecid`	用來編碼視訊的編碼器版本號碼。
`framerate`	數字，表示 FLV 檔的影格速率。
`videodatarate`	數字，表示 FLV 檔視訊資料速率。
`height`	數字，表示 FLV 檔的高度。
`width`	數字，表示 FLV 檔的寬度。
`duration`	數字，指定 FLV 檔的持續時間，以秒為單位。

實作
public function get metadata():Object

詳細資訊

使用提示點

相關 API 元素

VideoPlayer.metadata

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

muteButton

屬性

muteButton:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

「靜音」按鈕控制項。

實作
public function get muteButton():Sprite
public function set muteButton(value:Sprite):void

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 元素

VideoPlayer.ncMgr

pauseButton

屬性

pauseButton:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

「暫停」按鈕控制項。

實作
public function get pauseButton():Sprite
public function set pauseButton(value:Sprite):void

paused

屬性

paused:Boolean [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

Boolean 值，當 FLV 檔處於暫停狀態時則為 true。

實作
public function get paused():Boolean

playButton

屬性

playButton:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

「播放」按鈕控制項。

實作
public function get playButton():Sprite
public function set playButton(value:Sprite):void

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 元素

seek()
VideoPlayer.playheadTime

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 元素

VideoPlayer.playheadUpdateInterval

playing

屬性

playing:Boolean [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

Boolean 值，當 FLV 檔處於播放狀態時則為 true。

實作
public function get playing():Boolean

playPauseButton

屬性

playPauseButton:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

「播放/暫停」按鈕控制項。

實作
public function get playPauseButton():Sprite
public function set playPauseButton(value:Sprite):void

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 元素

scaleMode

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 元素

scaleMode

preview

屬性

preview:String [唯寫]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

僅適用於即時預覽。會讀入 PNG 檔案以供預覽。

實作
public function set preview(value:String):void

progressInterval

屬性

progressInterval:Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

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

預設值為 250。

實作
public function get progressInterval():Number
public function set progressInterval(value:Number):void

相關 API 元素

VideoPlayer.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 = 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 保持同步。

實作
public function get registrationHeight():Number
public function set registrationHeight(value:Number):void

registrationWidth

屬性

registrationWidth:Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

在自動調整大小時，用來對齊視訊內容的寬度。請勿將 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 保持同步。

實作
public function get registrationWidth():Number
public function set registrationWidth(value:Number):void

registrationX

屬性

registrationX:Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

在自動調整大小時，用來對齊視訊內容的 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。

實作
public function get registrationX():Number
public function set registrationX(value:Number):void

registrationY

屬性

registrationY:Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

在自動調整大小時，用來對齊視訊內容的 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。

實作
public function get registrationY():Number
public function set registrationY(value:Number):void

scaleMode

屬性

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

scaleX

屬性

scaleX:Number[覆寫]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

代表水平縮放的數字。標準縮放值為 1。

實作
override public function get scaleX():Number
override public function set scaleX(value:Number):void

相關 API 元素

setScale()

scaleY

屬性

scaleY:Number[覆寫]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

代表垂直縮放的數字。標準縮放值為 1。

實作
override public function get scaleY():Number
override public function set scaleY(value:Number):void

相關 API 元素

setScale()

scrubbing

屬性

scrubbing:Boolean [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

Boolean 值，當使用者使用 SeekBar 進行拖曳時為 true；否則為 false。

「拖曳」是指抓取 SeekBar 的控制點，並拖曳它來尋找 FLV 檔中的特定場景。

實作
public function get scrubbing():Boolean

seekBar

屬性

seekBar:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

SeekBar 控制項。

實作
public function get seekBar():Sprite
public function set seekBar(value:Sprite):void

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):void

seekBarScrubTolerance

屬性

seekBarScrubTolerance:Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

數字，會指定使用者在更新動作發生之前，可將 SeekBar 控制點移動多遠的距離。這個值是以百分比來表示，允許的範圍為 1 到 100。

預設值為 5。

實作
public function get seekBarScrubTolerance():Number
public function set seekBarScrubTolerance(value:Number):void

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):void

skin

屬性

skin:String

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

字串，會指定外觀元素 SWF 檔的 URL。這個字串可能包含檔名、相對路徑 (例如 Skins/MySkin.swf) 或絕對 URL (例如 http://www.%somedomain%.com/MySkin.swf)。

實作
public function get skin():String
public function set skin(value:String):void

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):void

skinBackgroundAlpha

屬性

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 元素

skin
skinBackgroundColor

skinBackgroundColor

屬性

skinBackgroundColor:uint

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

外觀元素的背景顏色 (0xRRGGBB)。 skinBackgroundColor 屬性只能用於 SWF 檔 (具有使用 skin 屬性載入的外觀元素)，以及用於支援設定顏色和 Alpha 的外觀元素。預設值是使用者選擇做為預設值的最後一個值。

實作
public function get skinBackgroundColor():uint
public function set skinBackgroundColor(value:uint):void

相關 API 元素

skin
skinBackgroundAlpha

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):void

skinScaleMaximum

屬性

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

範例 ( 如何使用本範例 )

下列範例將 skinScaleMaximum 屬性設為 2.5，使得當組件在有硬體加速的情況下進入全螢幕模式時，FLVPlayback 外觀元素的縮放比例僅限於 2.5 倍。若要了解 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 元素

volume
VideoPlayer.soundTransform

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

startTabIndex

屬性

startTabIndex:int [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

傳回 FLVPlayback 控制項的第一個 tabIndex 值。此值於呼叫 assignTabIndexes 方法後設定。

實作
public function get startTabIndex():int

相關 API 元素

assignTabIndexes()

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

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 元素

VideoPlayer.stateResponsive

stopButton

屬性

stopButton:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

「停止」按鈕控制項。

實作
public function get stopButton():Sprite
public function set stopButton(value:Sprite):void

stopped

屬性

stopped:Boolean [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

Boolean 值，當 FLVPlayback 實體的狀態為 stopped 時則為 true。

實作
public function get stopped():Boolean

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 元素

source

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

volume

屬性

volume:Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

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

預設值為 1。

實作
public function get volume():Number
public function set volume(value:Number):void

相關 API 元素

soundTransform

volumeBar

屬性

volumeBar:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

音量列控制項。

實作
public function get volumeBar():Sprite
public function set volumeBar(value:Sprite):void

volumeBarInterval

屬性

volumeBarInterval:Number

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

數字，會指定拖曳時檢查音量列控制點位置的頻率，以毫秒為單位。

預設值為 250。

實作
public function get volumeBarInterval():Number
public function set volumeBarInterval(value:Number):void

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):void

width

屬性

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 元素

setSize()

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):void

y

屬性

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):void

建構函式詳細資料

()

建構函式

public function FLVPlayback()

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會建立新的 FLVPlayback 實體。在建立 FLVPlayback 實體之後，請呼叫 addChild() 或 addChildAt() 方法，將實體放置在「舞台」上或其他顯示物件容器中。

相關 API 元素

DisplayObjectContainer.addChild()

方法詳細資訊

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 錯誤。 `time` 屬性會針對即將新增的提示點設定時間 (以秒為單位)，而且後面必須跟隨 `name` 參數。

	`name:String` (default = `null`) — 當您送出 `time` 參數而非 CuePoint 物件時，用以指定提示點名稱的字串。

	`parameters:Object` (default = `null`) — 若 `timeOrCuePoint` 參數是數字，則為提示點的選擇性參數。

傳回值

Object — 已新增的提示點物件。編輯此物件會影響 cuePoint 事件的傳送。

擲回值

VideoError — 參數都無效。

相關 API 元素

findCuePoint()
removeASCuePoint()

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 元素

endTabIndex
startTabIndex

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 — 數字，代表要移到前方之視訊播放程式的索引。

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 — 數字，代表要關閉之視訊播放程式的索引。

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 (這是預設值) 時，才支援全螢幕。

範例 ( 如何使用本範例 )

下列範例會從事件處理常式中呼叫 enterFullScreenDisplayState() 方法，此事件處理常式於使用者按一下標準 Flash 按鈕 (myButton) 時觸發。

// 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 屬性的物件。

如果此參數為字串，此方法會搜尋具有這個名稱的第一個提示點；如果找不到符合的提示點，則傳回 null。

如果這個參數是數字，此方法就會搜尋並傳回具有這個時間的第一個提示點。如果有多個提示點具有相同的時間 (只有 ActionScript 提示點才有可能)，就會按照英文字母順序傳回含有第一個名稱的提示點。如果找不到符合的項目便傳回 null。僅會使用 time 屬性的前三位小數位數，超過三位小數位數則四捨五入。

如果這個參數是物件，此方法就會搜尋包含指定之 time 和/或 name 屬性。如果只有指定時間或名稱，則此行為就等於使用數字或字串來進行呼叫。如果已定義 time 和 name 屬性，而且這兩種屬性都有提示點物件，則會傳回該提示點物件；否則會傳回 null。

如果 time 為 null、NaN 或小於 0，而 name 為 null 或 undefined，則會擲回 VideoError 物件。

type:String (default = NaN) — 字串，指定要搜尋的提示點類型。此參數可能的值為 "actionscript"、"all"、"event"、"flv" 或 "navigation"。您可以使用下列類別屬性來指定這些值：CuePointType.ACTIONSCRIPT、CuePointType.ALL、CuePointType.EVENT、CuePointType.FLV 和 CuePointType.NAVIGATION。如果未指定此參數，則會預設為 "all"，這表示此方法會搜尋所有的提示點類型。這是選擇性的。

傳回值

Object — 物件，已找到之提示點物件的副本，具有下列額外屬性：

array：搜尋到的提示點陣列。請將它當做是唯讀陣列來處理，因為在這個陣列內新增、移除或編輯物件將導致提示點無法正常運作。
index：傳回的提示點之陣列的索引。

如果找不到符合的項目便傳回 null。

擲回值

VideoError — 如果 time 屬性為 null、undefined 或小於 0，而 name 屬性為 null 或 undefined。

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 屬性的物件。

如果此參數為字串，此方法會搜尋具有這個名稱的第一個提示點；如果找不到符合的提示點，則傳回 null。

如果此參數為數字，則會傳回在剛好這個時間或以前的最接近提示點。如果在該時間或以前沒有提示點，則會傳回第一個提示點。如果有多個提示點具有相同的時間 (只有 ActionScript 提示點才有可能)，就會按照英文字母順序傳回含有第一個名稱的提示點。如果找不到符合的項目便傳回 null。僅會使用 time 屬性的前三位小數位數，超過三位小數位數則四捨五入。

如果這個參數是物件，此方法就會搜尋包含指定之 time 和/或 name 屬性。如果只有指定時間或名稱，則此行為就等於使用數字或字串來進行呼叫。如果已定義 time 和 name 屬性，而且這兩種屬性都有提示點物件，則會傳回該提示點物件；否則會傳回時間較早且名稱相同的最接近提示點。如果找不到早於該時間且具有該名稱的提示點，則會傳回 null。

如果 time 為 null、undefined 或小於 0，而 name 為 null 或 undefined，則會擲回 VideoError 物件。

傳回值

Object — 物件，已找到之提示點物件的副本，具有下列額外屬性：

array：搜尋到的提示點陣列。請將它當做是唯讀陣列來處理，因為在這個陣列內新增、移除或編輯物件將導致提示點無法正常運作。
index：傳回的提示點之陣列的索引。

如果找不到符合的項目便傳回 null。

擲回值

VideoError — 如果 time 為 null、undefined 或小於 0，而 name 為 null 或 undefined。

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；否則便傳回具有其他屬性的提示點物件副本。

array：搜尋到的提示點陣列。請將它當做是唯讀陣列來處理，因為在這個陣列內新增、移除或編輯物件將導致提示點無法正常運作。
index：傳回的提示點之陣列的索引。

擲回值

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。

如果此參數是數字，它就是要檢查的提示點時間。

如果這個參數是物件，就會傳回含有相符 name 和 time 屬性的物件。

傳回值

Boolean — 若 FLV 檔內嵌提示點已停用，便傳回 false。您可以透過「Flash 視訊提示點」對話方塊設定 cuePoints 屬性或呼叫 setFLVCuePointEnabled() 方法，來停用提示點。

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`) — Boolean 值，當視訊串流處於即時狀態則為 `true`。只有從 Flash Media Server (FMS) 或其他「Flash 視訊串流服務」(FVSS) 進行串流處理時，這個值才有效。如果是採用 HTTP 下載的方式，這個屬性值會被忽略。這是選擇性的。

相關 API 元素

autoPlay
source
isLive
totalTime

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`) — 字串，指定要進行串流處理之 FLV 檔的 URL，以及串流的方式。這個 URL 可以是本機路徑、FLV 檔的 HTTP URL、FLV 檔串流的 RTMP URL，或是 XML 檔的 HTTP URL。 `source` 屬性是選擇性的，但是若要設定，就必須透過「組件檢測器」或 ActionScript 來進行，否則這個方法就不會發揮作用。

	`totalTime:Number` (default = `NaN`) — 數字，表示視訊的總播放時間。這是選擇性的。

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

相關 API 元素

autoPlay
source
isLive
totalTime

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 元素

addASCuePoint()
findCuePoint()

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 元素

VideoPlayer.seek()

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 元素

seek()

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 元素

seek()

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 處開始搜尋。

名稱是要搜尋的提示點。此方法會搜尋至第一個具有此名稱的已啟用瀏覽提示點。

時間和名稱合起來就是在指定時間或之後、具有指定名稱的瀏覽提示點。

參數

timeNameOrCuePoint:* — 表示時間的數字、表示名稱的字串，或同時表示指定名稱和時間的字串和數字。

擲回值

VideoError — 找不到符合準則的提示點。

seekToNextNavCuePoint

()

方法

public function seekToNextNavCuePoint(time:Number = NaN):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會依據目前的 playheadTime 屬性值，搜尋至下一個瀏覽提示點。這個方法會略過已停用的瀏覽提示點，如果沒有其他提示點，便會移到 FLV 檔的結尾。

參數

time:Number (default = NaN) — 數字，指定要從哪一個時間點開始尋找下一個瀏覽提示點，以秒為單位。預設值為目前的 playheadTime 屬性。這是選擇性的。

seekToPrevNavCuePoint

()

方法

public function seekToPrevNavCuePoint(time:Number = NaN):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

依據目前的 playheadTime 屬性值，搜尋至上一個瀏覽提示點。如果沒有上一個提示點，則會移至開頭部分。此方法會略過已停用的瀏覽提示點。

參數

time:Number (default = NaN) — 數字，指定要從哪一個時間點開始尋找上一個瀏覽提示點，以秒為單位。預設值為目前 playheadTime 屬性的值。這是選擇性的。

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，因為組件無法決定要設定哪一個提示點 (如果有)。不過，當中繼資料到達時，組件便會適當地設定指定的提示點。

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 元素

scaleX
scaleY
VideoScaleMode

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 元素

width
height
VideoScaleMode

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 物件的索引。

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 物件的索引。

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 物件的索引。

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 物件的索引。

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 物件的索引。

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 物件的索引。

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 物件的索引。

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` 屬性值。

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 物件的索引。

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 物件的索引。

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 物件的索引。

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 元素

play()
stateChange event

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 物件的索引。

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 元素

load()
play()
VideoEvent.READY

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 物件的索引。

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 物件的索引。

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 物件的索引。

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 事件。

定義 seeked 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`state`	字串，用以識別 VideoState 類別中描述組件播放狀態的常數。
`playheadTime`	數字，表示目前的播放磁頭時間或位置。
`vp`	VideoPlayer 物件的索引。

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`	錯誤訊息。

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 物件的索引。

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。

定義 soundUpdate 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`soundTransform`	表示音量和左右相位的新值。

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 元素

VideoEvent.STATE_CHANGE

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 物件的索引。

常數詳細資訊

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 variable

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 元素

SHORT_VERSION variable

範例如何使用本範例

FLVPlaybackExample.as

此範例會以動態方式建立 FLVPlayback 實體。

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

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

法律聲明 | 線上隱私權政策

FLVPlayback - AS3 Flash

套件x

語言元素

附錄

套件 fl.video

activeVideoPlayerIndex

align

autoPlay

autoRewind

backButton

bitrate

buffering

bufferingBar

bufferingBarHidesAndDisablesOthers

bufferTime

bytesLoaded

bytesTotal

cuePoints

endTabIndex

forwardButton

fullScreenBackgroundColor

fullScreenButton

fullScreenSkinDelay

fullScreenTakeOver

height

idleTimeout

isLive

isRTMP

metadata

metadataLoaded

muteButton

ncMgr

pauseButton

paused

playButton

playheadPercentage

playheadTime

playheadUpdateInterval

playing

playPauseButton

preferredHeight

preferredWidth

preview

progressInterval

registrationHeight

registrationWidth

registrationX

registrationY

scaleMode

scaleX

scaleY

scrubbing

seekBar

seekBarInterval

seekBarScrubTolerance

seekToPrevOffset

skin

skinAutoHide

skinBackgroundAlpha

skinBackgroundColor

skinFadeTime

skinScaleMaximum

soundTransform

source

startTabIndex

state

stateResponsive

stopButton

stopped

totalTime

visibleVideoPlayerIndex

volume

volumeBar

volumeBarInterval

volumeBarScrubTolerance

width

x

y

FLVPlayback

addASCuePoint