VideoDisplay  - AS3 Flex

組み込まれている自動帯域幅検出機能を VideoDisplay コントロールで使用するかどうかを指定します。 false の場合は、FMS との接続で Flash Media Server（FMS）2 の main.asc ファイルを要求しません。 true の場合は、main.asc を実装して FMS のディレクトリ構造に保存する必要があります。 main.asc ファイルは次の関数を定義する必要があります。

•       application.onConnect = function(p_client, p_autoSenseBW)
        {
          //Add security code here.     
          this.acceptConnection(p_client);      
          if (p_autoSenseBW)
            this.calculateClientBw(p_client);
          else
            p_client.call("onBWDone");
        }

•       application.calculateClientBw = function(p_client)
        {
          // Add code to set the clients BandWidth.
          // Use p_client.getStats() which returns bytes_in 
          // and bytes_Out and check your bandWidth using 
          // p_client.call("onBWCheck", result, p_client.payload).
          p_client.call("onBWDone");
        }
        

•       Client.prototype.getStreamLength = function(p_streamName)
        {
          return Stream.length(p_streamName);
        }

デフォルト値： false。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 autoBandWidthDetection イベントが送出されます。

source プロパティが設定されたときに、ビデオの再生をすぐに開始するかどうかを指定します。 true の場合、ただちにビデオファイルのバッファリングと再生が始まります。

autoPlay が false に設定されている場合でも、initialize() メソッドを呼び出した後でビデオのロードが始まります。 Flash Media Server の場合は、この操作によってストリームが作成され、表示する最初のフレームがロードされます（autoSize または aspectRatio が true の場合は、これ以降のフレームもロードされます）。 HTTP ダウンロードの場合は、ストリームのダウンロードが開始され、最初のフレームが表示されます。

デフォルト値： true。

stop() メソッドが呼び出された、またはストリームの最後に到達したために再生が停止したときに、FLV ファイルを最初のフレームまで巻き戻すかどうかを指定します。 このプロパティは、ライブストリーミングビデオには効果がありません。

デフォルト値： true。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 autoRewindChanged イベントが送出されます。

コントロールの境界線オブジェクトです。

left、top、right および bottom の 4 つのプロパティを持つ EdgeMetrics オブジェクトを返します。 各プロパティの値は、ピクセル単位で表した、コントロール各辺の境界の太さです。

ビデオファイルの再生を開始するまでにビデオをメモリにバッファーする秒数です。 RTMP 上での転送速度の遅いストリーミングの場合は、このプロパティをデフォルトより高い値に設定することが重要です。

デフォルト値： 0.1。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 bufferTimeChanged イベントが送出されます。

すでにロード済みで再生可能なバイト数です。この値は、HTTP を使用してメディアをロードした場合にのみ有効です。

入力ストリームがない場合、Flash Media Server から得たストリームである場合、または情報がまだ利用できない場合、この値は -1 です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 progress イベントが送出されます。

ロードするバイト数の合計です。この値は、HTTP を使用してメディアをロードした場合にのみ有効です。

入力ストリームがない場合、Flash Media Server から得たストリームである場合、または情報がまだ利用できない場合、この値は -1 です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 progress イベントが送出されます。

VideoPlayer コントロールに関連付けられた CuePointManager クラスのインスタンスです。 このオブジェクトを使用してキューポイントを制御できます。このオブジェクトを使用しない場合は、cuePoints プロパティを使用して制御します。

キューポイントを使用すると、ビデオの再生が指定の位置に達した時点で cuePoint イベントをトリガーできます。 キューポイントを設定するには、CuePointManager クラスのメソッドを使用します。

FLV に埋め込んだキューポイントは、cuePoints や cuePointManager では使用できません。 これらを取得するには、metadata プロパティまたは metadataReceived イベントにアクセスします。

関連する API エレメント

使用するキューポイントマネージャーです。 mx.controls.videoClasses.CuePointManager に設定すると、キューポイントの管理が有効になります。

関連する API エレメント

コントロールに関連付けられているキューポイントの配列です。 このプロパティを使用してキューポイントを制御できます。このプロパティを使用しない場合は、cuePointManager プロパティを使用して制御します。

キューポイントを使用すると、ビデオの再生が指定の位置に達した時点で cuePoint イベントをトリガーできます。 キューポイントを設定するには、cuePoints プロパティに配列を渡します。

FLV に埋め込んだキューポイントは、cuePoints や cuePointManager では使用できません。 これらを取得するには、metadata プロパティまたは metadataReceived イベントにアクセスします。

この配列では、エレメントごとに 2 つのフィールドを指定します。

• その 1 つは name フィールドで、キューポイントの任意の名前を指定します。
• もう 1 つは time フィールドで、キューポイントを関連付ける VideoDisplay コントロールの再生ヘッド位置を秒数で指定します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 cuePointsChanged イベントが送出されます。

Flash Media Server への接続が停止するまでのアイドル状態（再生一時停止または再生停止）の持続時間をミリ秒単位で指定します。 このプロパティは、HTTP による FLV ファイルのダウンロードには影響しません。ストリームがすでにアイドル状態である場合に、このプロパティを設定すると、アイドルのタイムアウト値に新しい値が再設定されます。

デフォルト値： 300000 (five minutes)。

コントロールがライブフィードをストリームするかどうかを指定します。 ストリーミングが Flash Media Server からのライブフィードの場合、このプロパティを true に設定します。

デフォルト値： false。

ビデオのサイズを変更するときに、コントロールで元の縦横比を維持するかどうかを指定します

デフォルト値： true。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 maintainAspectRatioChanged イベントが送出されます。

NetStream.onMetaData() コールバックメソッドが存在する場合に、その呼び出しで得られるメタデータ情報パケットを収めたオブジェクトです。metadataReceived イベントが送出されると、準備が整います。

Flash 8 エンコーダーを使用して FLV ファイルをエンコードした場合、metadata プロパティは次に示す情報を含みます。より古いバージョンでエンコードされた FLV ファイルの場合は、height、width、および duration の値のみを含みます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 metadataReceived イベントが送出されます。

ビデオの再生を開始してからの再生ヘッドの位置を秒数で示します。 多くの VideoPlay イベントのイベントオブジェクトには、イベントが発生したビデオファイル内の位置を特定できるように、再生ヘッド位置が含まれています。

このプロパティを秒単位の値に設定すると、シーク操作が実行されます。現在ビデオを再生中の場合は、新しい再生ヘッド位置から再生を継続します。ビデオが一時停止状態の場合は、新しい再生ヘッド位置をシークし、一時停止したままになります。ビデオが停止状態の場合は、新しい再生ヘッド位置をシークし、一時停止状態に移行します。このプロパティの設定によるライブビデオストリームへの影響はありません。

新しい再生ヘッド位置が 0 未満または NaN である場合、コントロールが例外をスローします。新しい再生ヘッド位置がビデオの末尾または現在ダウンロード済みのビデオファイル容量を超過している場合、コントロールはシークを継続します。

FLV ファイルの場合、playheadTime プロパティを設定すると、指定した位置に最も近いキーフレームをシークします。キーフレームは、エンコード時に FLV ファイルで指定します。 したがって、その位置にキーフレームを指定していない場合、指定した時間とは異なる位置でシークされることがあります。

プレーヤーが無応答状態である場合は、要求がキューに置かれます。

ストリームが接続されていないとき、このプロパティを設定すると、例外がスローされます。 stateChange イベントと connected プロパティを使用して、このプロパティを安全に設定できる時期を判断します。

デフォルト値： NaN。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 playheadUpdate イベントが送出されます。

playheadUpdate イベントの発生する間隔をミリ秒単位で指定します。

ビデオの再生中にこのプロパティを設定すると、タイマーが 0 から再開され、次回の playheadUpdate イベントは新しい期間が経過した後に発生します。

デフォルト値： 250。

true の場合、メディアは現在再生中です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 stateChange イベントが送出されます。

progress イベントの発生する間隔をミリ秒単位で指定します。 progress イベントは、ビデオファイルのダウンロードが完了するまで継続的に発生します。

ビデオのダウンロード中にこのプロパティを設定すると、タイマーが 0 から再開され、次回の progress イベントは新しい期間が経過した後に発生します。

デフォルト値： 250。

ストリーミングする FLV ファイルの相対パスとファイル名です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 sourceChanged イベントが送出されます。

VideoDisplay コントロールの現在の状態です。 load()、play()、stop() および pause() の各メソッドの呼び出し、および playHeadTime プロパティの設定によって、このプロパティを設定します。

このプロパティに設定できる値は、VideoEvent クラスで定義されている VideoEvent.BUFFERING、VideoEvent.CONNECTION_ERROR、VideoEvent.DISCONNECTED、VideoEvent.EXEC_QUEUED_CMD、VideoEvent.LOADING、VideoEvent.PAUSED、VideoEvent.PLAYING、VideoEvent.RESIZING、VideoEvent.REWINDING、VideoEvent.SEEKING および VideoEvent.STOPPED です。

デフォルト値： VideoEvent.DISCONNECTED。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 stateChange イベントが送出されます。

関連する API エレメント

VideoDisplay コントロールが応答可能状態（true）であるか、応答不可状態（false）であるかを指定します。 ビデオのロード中または巻き戻し中のコントロールは応答不可状態になります。

state プロパティが VideoEvent.CONNECTION_ERROR、VideoEvent.EXEC_QUEUED_CMD または VideoEvent.RESIZING である場合も、コントロールは応答可能状態になります。

コントロールが無応答状態である場合、play()、load()、stop() および pause() の各メソッドへの呼び出しはキューに置かれ、コントロールが応答可能な状態に変わったときに実行されます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 stateChange イベントが送出されます。

メディアの全体の長さを秒数で示します。FLV 1.0 ビデオファイルの場合は、このプロパティを手動で設定します。FLV 1.1 以降では、この値はコントロールで自動的に計算されます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 metadataReceived イベントが送出されます。

ロードされた FLV ファイルの画像高さです。FLV ファイルがまだロードされていない場合は -1 になります。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 resize イベントが送出されます。

ロードされた FLV ファイルの画像幅です。FLV ファイルがまだロードされていない場合は -1 になります。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 resize イベントが送出されます。

ボリュームレベルです。0 から 1 の範囲の値で指定します。

デフォルト値： 0.75。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 volumeChanged イベントが送出されます。

コンストラクターです。

カメラからビデオストリームの再生を行うことを指定します。ビデオは、アプリケーションウィンドウ内のコントロールの境界内に表示されます。カメラからストリームを表示する場合は、play() メソッドを呼び出さないでください。

パラメーター

入力ストリームと Flash Media Server への接続を強制的に閉じます。このメソッドを呼び出すと、close イベントが送出されます。アイドル時間が、idleTimeout プロパティで定義したタイムアウトに達すると接続が自動的に終了するので、通常はこのメソッドを直接呼び出す必要はありません。

このコンポーネントの境界線を作成します。境界線は通常 borderStyle スタイルと borderSkin スタイルによって決まります。border プロパティを境界線のインスタンスに設定する必要があります。

境界の位置とサイズを設定することで、サイズ変更に応答します。

VideoDisplay.layoutChrome() メソッドは、VideoDisplay の境界線の位置とサイズを設定します。VideoDisplay のすべてのサブクラスで、そのサブクラスの layoutChrome() メソッドから super.layoutChrome() メソッドを呼び出して、境界線が適切に配置されるようにする必要があります。

パラメーター

メディアファイルをロードしますが再生はしません。

このメソッドは、ファイルをロードしても再生しない点を除き、play() メソッドと同等です。自動サイズ変更の実行が適切な場合はそれを実行します。 ロードおよび自動サイズ変更の後、コントロールの状態は VideoEvent.PAUSED に設定されます。