| 套件 | flash.net |
| 類別 | public dynamic class NetStreamPlayOptions |
| 繼承 | NetStreamPlayOptions  EventDispatcher Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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 物件，以指定傳遞至 NetStream.play2() 方法的選項。 | NetStreamPlayOptions | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
|
會將事件傳送到事件流程。 | EventDispatcher | |
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | 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。
相關 API 元素
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 中的「在串流之間快速切換」。
相關 API 元素
oldStreamName | 屬性 |
public var oldStreamName:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
舊串流或從中轉場之串流的名稱。當 NetStream.play2() 只用於播放串流 (未執行轉場) 時，這個屬性的值應該是 null 或 undefined。否則，請指定要從中轉場的串流。
相關 API 元素
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 元素
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。
相關 API 元素
transition | 屬性 |
public var transition:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
播放或轉場到 streamName 的模式。可能值是來自 NetStreamPlayTransitions 類別的常數。根據是否呼叫 Netstream.play2() 以播放或轉場串流而定，轉場模式會產生不同的行為。如需有關各種轉場模式的詳細資訊，請參閱 NetStreamPlayTransitions 類別。
相關 API 元素
NetStreamPlayOptions | () | 建構函式 |
public function NetStreamPlayOptions()| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
建立 NetStreamPlayOptions 物件，以指定傳遞至 NetStream.play2() 方法的選項。
相關 API 元素
Tue Jun 12 2018, 03:47 PM Z