VideoTexture - Adobe ActionScript® 3 (AS3 ) API 參考

套件	flash.display3D.textures
類別	public final class VideoTexture
繼承	VideoTexture TextureBase EventDispatcher Object

在 Flash Player 21 之前，若要在 Stage3D 使用視訊，必須使用 Video 物件 (非硬體加速)、將視訊影格複製到 BitmapData 物件，並將資料載入需要大量耗用 CPU 的 GPU。因此，引進了視訊紋理物件。此物件讓您可以在 Stage 3D 內容中使用硬體解碼的視訊。

Flash Player 22 新增了視訊紋理物件，以持續/類似 StageVideo 的方式支援 NetStream 和 Cameras。這類紋理可以在 stage3D 顯示管線當做來源紋理使用。紋理可以在以場景呈現時，當做矩形、RGB、非 MIP 映射紋理使用。著色器會將這些紋理當做 ARGB 紋理 (也就是說，AGAL 著色器不必理會 YUV->RGB 轉換)，因此，可以直接使用與靜態影像搭配使用的標準著色器，而不必變更。顯示管線所使用的影像，是使用這個紋理來呈現時的最新影格。視訊影格未出現斷面，但若您多次使用相同紋理，部分實體可能出自不同的時間戳記。

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		videoHeight : int [唯讀] 指定視訊串流高度的整數，以像素為單位。	VideoTexture
		videoWidth : int [唯讀] 指定視訊串流寬度的整數，以像素為單位。	VideoTexture

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		attachCamera(theCamera:Camera):void 指定來自攝影機的視訊串流，將顯示在 VideoTexture 物件的紋理內。	VideoTexture
		attachNetStream(netStream:NetStream):void 指定視訊串流，將顯示在 VideoTexture 物件的紋理內。	VideoTexture
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		dispose():void 釋放與這個紋理關聯的所有 GPU 資源。	TextureBase
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

事件

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

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
renderState		VideoTexture

屬性詳細資訊

videoHeight

屬性

videoHeight:int [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 17.0, Flash Player 18.0

指定視訊串流高度的整數，以像素為單位。

對於即時串流來說，這個值和 Camera 物件的 Camera.height 屬性相同，此 Camera 物件指的是正在捕捉視訊串流的 Camera 物件。針對錄製的視訊檔案，此值為視訊的高度。若是錄製的視訊，則當此值變更時就會傳送 NetStream.Video.DimensionChange 事件。

實作
public function get videoHeight():int

videoWidth

屬性

videoWidth:int [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 17.0, Flash Player 18.0

指定視訊串流寬度的整數，以像素為單位。

對於即時串流來說，這個值和 Camera 物件的 Camera.width 屬性相同，此 Camera 物件指的是正在捕捉視訊串流的 Camera 物件。針對錄製的視訊檔案，此值為視訊的寬度。若是錄製的視訊，則當此值變更時就會傳送 NetStream.Video.DimensionChange 事件。

實作
public function get videoWidth():int

方法詳細資訊

attachCamera

()

方法

public function attachCamera(theCamera:Camera):void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 17.0, Flash Player 18.0

指定來自攝影機的視訊串流，將顯示在 VideoTexture 物件的紋理內。

使用這個方法可將使用者捕捉的即時視訊附加至 VideoTexture 物件。若要丟棄 VideoTexture 物件的連線，請將 theCamera 參數的值設定為 null。

參數

theCamera:Camera

attachNetStream

()

方法

public function attachNetStream(netStream:NetStream):void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 17.0, Flash Player 18.0

指定視訊串流，將顯示在 VideoTexture 物件的紋理內。

視訊檔案可以儲存在本機檔案系統或 Flash Media Server 上。如果 netStream 引數的值是 null，則視訊不會在 VideoTexture 物件中播放。

參數

netStream:NetStream

事件詳細資訊

renderState

事件

事件物件類型: flash.events.TextureVideoEvent

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

VideoTexture - AS3

類別 x

videoHeight

videoWidth

attachCamera

attachNetStream

renderState