NetStreamPlayOptions

套件	flash.net
類別	public dynamic class NetStreamPlayOptions
繼承	NetStreamPlayOptions EventDispatcher Object

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

NetStreamPlayOptions 類別會指定可傳遞給 NetStream.play2() 方法的各種選項。您只要將 NetStreamPlayOptions 物件傳遞至 play2()，此類別的屬性就會指定各種選項。這個類別的主要使用案例是在串流間動態實作轉場，以便切換至不同位元速率與大小的串流或切換至播放清單中的不同內容。

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		len : Number streamName 中指定之串流的播放持續時間 (以秒為單位)。	NetStreamPlayOptions
		offset : Number 伺服器在不同位元傳輸速率串流之間切換，以便進行 Flash Media Server 動態串流處理的絕對串流時間點。	NetStreamPlayOptions
		oldStreamName : String 舊串流或從中轉場之串流的名稱。	NetStreamPlayOptions
		start : Number streamName 的開始時間，以秒為單位。	NetStreamPlayOptions
		streamName : String 要轉場到或播放的新串流名稱。	NetStreamPlayOptions
		transition : String 播放或轉場到 streamName 的模式。	NetStreamPlayOptions

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		NetStreamPlayOptions() 建立 NetStreamPlayOptions 物件，以指定傳遞至 NetStream.play2() 方法的選項。	NetStreamPlayOptions
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		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

屬性詳細資訊

len

屬性

public var len:Number

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

streamName 中指定之串流的播放持續時間 (以秒為單位)。預設值為 -1，這表示 Flash Player 會播放即時串流直到不再有即時串流，或播放已錄製串流直到此串流結束。如果您將 0 傳遞至 len，Flash Player 會播放從已錄製串流開頭算起第 start 秒的單一影格 (假設 start 等於或大於 0)。

如果您將正數傳遞至 len，Flash Player 會在即時串流可用時播放長達 len 秒，或播放已錄製串流長達 len 秒 (若此串流長度不到 len 秒，在串流結束時即結束播放)。

如果您將 -1 以外的負數傳遞至 len，Flash Player 會將此值解譯為 -1。

offset

屬性

public var offset:Number

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

伺服器在不同位元傳輸速率串流之間切換，以便進行 Flash Media Server 動態串流處理的絕對串流時間點。當結合 NetStreamPlayTransitions.SWITCH 轉場模式呼叫 NetStream.play2() 時，就會使用 offset 屬性。共有兩種切換模式：快速切換與標準切換。offset 的預設值為 -1，即為快速切換模式。請撰寫 ActionScript 邏輯，以決定何時使用快速切換及何時使用標準切換。

快速切換

在快速切換模式中，Flash Media Server 會直接切換到新串流，而不會等待播放緩衝區中的資料。過去 offset 從舊串流中緩衝的任何資料都會被清除。快速切換比標準切換快，因為從舊串流緩衝的資料不必結束。

offset 的預設值為 -1，即為快速切換模式。當 offset 為 -1 時，切換會發生在 netstream.time + 3 之後的第一個可用的關鍵影格，大約比播放點晚 3 秒鐘。您也可以將 offset 屬性設定為大於 netstream.time 的任何值。例如，若要在播放點後快速切換 5 秒，請將 offset 屬性設定為 netstream.time + 5。如果 offset 的值小於 netstream.time，則會傳送 NetStream.Play.Failed 狀態事件。

注意：offset 屬性是絶對串流時間，不是與播放點相差的偏移值。例如，若要自播放點切換 5 秒，請將 offset 屬性設定為 netstream.time + 5，而非 5。

標準切換

若要使用標準切換而非快速切換，請將 offset 設定為大於 netstream.time + netstream.bufferLength 的值。

當用戶端具有高緩衝區位元傳輸速率，並且由於頻寬中斷 (不是 CPU 問題或丟棄影格的因素) 而想要切換為較低的頻寬時，請使用標準切換。用戶端可以隨意結束較高的位元傳輸速率，並在緩衝結尾時切換到較低的位元傳輸速率 (就如同在標準切換般)。

如需詳細資訊，請參閱 Adobe Flash Media Server Developer's Guide 中的「在串流之間快速切換」。

oldStreamName

屬性

public var oldStreamName:String

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

舊串流或從中轉場之串流的名稱。當 NetStream.play2() 只用於播放串流 (未執行轉場) 時，這個屬性的值應該是 null 或 undefined。否則，請指定要從中轉場的串流。

start

屬性

public var start:Number

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

streamName 的開始時間，以秒為單位。有效值為 -2、-1 和 0。

start 的預設值為 -2，這表示 Flash Player 會先嘗試播放 streamName 中指定的即時串流。如果找不到該名稱的即時串流，Flash Player 就會播放 streamName 中指定的已錄製串流。如果找不到即時串流和已錄製串流，Flash Player 會開啟一個名為 streamName 的即時串流，即使其中沒有發佈內容。一旦有人開始在該串流上發佈，Flash Player 即開始加以播放。

如果您將 -1 傳遞至 start，Flash Player 只會播放 streamName 中指定的即時串流。若找不到該即時串流，而 len 設為 -1，Flash Player 將無限期等待；如果 len 設為其它的值，Flash Player 便會等待 len 秒，然後再開始播放於播放清單中的下一個項目。

如果您將 0 或正數傳遞至 start，Flash Player 只會播放名為 streamName 的已錄製串流，從串流開頭算起第 start 秒開始播放。若找不到已錄製串流，Flash Player 將立即開始播放於播放清單中的下一個項目。

如果您將 -1 或 -2 以外的負數傳遞至 start，Flash Player 會將此值解譯為 -2。

相關 API 元素

NetStream.play()
NetStream.play2()
len

streamName

屬性

public var streamName:String

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

要轉場到或播放的新串流名稱。當 oldStreamName 為 null 或 undefined 時，呼叫 NetStream.play2() 會直接開始播放 streamName。如果指定了 oldStreamName，呼叫 NetStream.play2() 就會使用 transition 屬性中指定的轉場模式，將 oldStreamName 轉場至 streamName。

transition

屬性

public var transition:String

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

播放或轉場到 streamName 的模式。可能值是來自 NetStreamPlayTransitions 類別的常數。根據是否呼叫 Netstream.play2() 以播放或轉場串流而定，轉場模式會產生不同的行為。如需有關各種轉場模式的詳細資訊，請參閱 NetStreamPlayTransitions 類別。

建構函式詳細資料

()

建構函式

public function NetStreamPlayOptions()

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5, Flash Lite 4

建立 NetStreamPlayOptions 物件，以指定傳遞至 NetStream.play2() 方法的選項。

相關 API 元素

NetStream.play2()

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

NetStreamPlayOptions - AS3

類別 x

len

offset

oldStreamName

start

streamName

transition

NetStreamPlayOptions