パッケージ | 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 で、-1 を指定すると Flash Player は使用できなるまでライブストリームを再生するか、記録されているストリームの最後まで再生します。len
に 0 を指定すると、記録されているストリームの最初から start
秒の単一フレームを再生します(start
に 0 以上が設定されている場合)。
len
に正の値を設定すると、Flash Player はライブストリームが使用可能になった後、len
秒再生するか、記録されているストリームを len
秒再生します(ストリームがlen
秒より短い場合は、ストリームが終了した時点で再生は終了します)。
len
に -1 以外の負の数を指定すると、Flash Player は値に -1 が指定されたものと解釈します。
関連する API エレメント
offset | プロパティ |
public var offset:Number
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Flash Media Server 動的ストリーミング用に、サーバーが異なるビットレートのストリームを切り替える絶対ストリーム時間。offset
プロパティは、NetStream.play2()
呼び出しが、NetStreamPlayTransitions.SWITCH
移行モードで行われるときに使用されます。切り替えモードには、高速切り替えと標準切り替えの 2 つがあります。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
プロパティを 5
ではなく netstream.time + 5
に設定します。
標準切り替え
高速切り替えの代わりに標準切り替えを使用するには、offset
値を netstream.time + netstream.bufferLength
よりも大きな値に設定します。
クライアントがバッファーで高いビットレートを保持し、(CPU の問題やフレームの脱落ではなく)帯域幅の減少が原因で低い帯域幅に切り替える場合に、標準切り替えを使用してください。このクライアントでは、可能な限り長い時間、高いビットレートで再生し、バッファーの最後で(標準切り替えとなったときに)低いビットレートに切り替えられます。
詳しくは、『Adobe Flash Media Server デベロッパーズガイド』の「ストリーミング間の高速切り替え」を参照してください。
関連する API エレメント
oldStreamName | プロパティ |
public var oldStreamName:String
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5, Flash Lite 4 |
前のストリームの名前またはトランジション元のストリームの名前。トランジションは実行せずにストリームを再生するためだけに NetStream.play2()
を使用するときは、このプロパティの値は null または未定義にしておきます。トランジションを実行するときは、トランジション元のストリームを指定します。
関連する API エレメント
start | プロパティ |
public var start:Number
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5, Flash Lite 4 |
streamName
の開始時間(秒単位)。有効な値は -2、-1、および 0 です。
start
のデフォルト値は -2 で、-2 を指定すると Flash Player は streamName
で指定されているライブストリームを最初に再生しようとします。この名前のライブストリームが見つからない場合、Flash Player は streamName
で指定されている記録されたストリームを再生します。ライブストリームも記録されたストリームも見つからない場合、Flash Player は、だれもパブリッシュしていなくても streamName
という名前のライブストリームを開きます。だれかがそのストリームのパブリッシュを開始すると、Flash Player はそのストリームの再生を開始します。
start
に -1 を指定すると、Flash Player は streamName
で指定されているライブストリームだけを再生します。ライブストリームが見つからない場合で len
が -1 に設定されていると、Flash Player は待ち状態のままになります。len
が -1 以外に設定されていると、Flash Player は len
秒の間待った後、再生リストの次のアイテムの再生を開始します。
start
に 0 または正の値を設定すると、Flash Player は streamName
という名前の記録されたストリームだけを、ストリームの最初から start
秒の位置から再生を始めます。記録されたストリームが見つからない場合は、Flash Player は直ちに再生リストの次のアイテムの再生を開始します。
start
に -1 および -2 以外の負の数を設定すると、Flash Player は値に -2 が指定されたものと解釈します。
関連する API エレメント
streamName | プロパティ |
public var streamName:String
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | Flash Player 10, AIR 1.5, Flash Lite 4 |
トランジションまたは再生する新しいストリームの名前。oldStreamName
が null または未定義のときは、NetStream.play2()
を呼び出すだけで streamName
の再生が開始されます。oldStreamName
が指定されていると、NetStream.play2()
を呼び出すことで、oldStreamName
が streamName
にトランジションされます(transition
プロパティで指定されている移行モードを使用)。
関連する 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, 10:34 AM Z