VideoPlayer  - AS3 Flash

ビデオを registrationX、registrationY、registrationWidth および registrationHeight プロパティに応じてどのように表示するかを指定します。align プロパティは、scaleMode プロパティに VideoScaleMode.MAINTAIN_ASPECT_RATIO または VideoScaleMode.NO_SCALE が設定されているときに、この自動レイアウトを行います。FLV ファイルのロード後にこのプロパティを変更すると、直後に自動レイアウトが開始されます。値は、VideoAlign クラスから取得されます。

デフォルト値： VideoAlign.CENTER。

関連する API エレメント

ブール値です。true の場合は、プレーヤーでストリームの最後に到達するか、または stop() メソッドが呼び出されて再生が停止したときに、FLV ファイルをフレーム 1 に巻き戻します。ライブストリームでは、このプロパティは無効です。

デフォルト値： false。

ビデオストリームの再生を開始するまでにメモリにバッファーする時間を秒単位で指定する数値です。RTMP を使用した FLV ファイルのストリーミングの場合は、ダウンロードを行わずにメモリ内にバッファリングされるだけなので、この設定をデフォルト値の 0.1 から増やすと大きな効果が得られる場合があります。HTTP 経由でプログレッシブダウンロードされる FLV ファイルの場合は、この値を増やしても利点はほとんどありません。ただし、処理速度の遅い古いコンピューターでは、高品質ビデオの再生が改善されることがあります。

ライブではなく事前にレコーディングされたビデオの場合は、bufferTime プロパティを 0 に設定せずに、デフォルトのバッファー時間を使用するかバッファー時間を増やしてください。

このプロパティでは、再生開始前にダウンロードする FLV ファイルの量を指定することはできません。

関連する API エレメント

HTTP ダウンロードの進捗状況を示す数値（バイト数）です。入力ストリームがない場合、Flash Media Server（FMS）からのストリームである場合、または情報がまだ利用できない場合、0 を返します。戻り値は HTTP ダウンロードの場合だけ有効です。

HTTP ダウンロードでダウンロードされた総バイト数を指定する数値です。入力ストリームがない場合、Flash Media Server（FMS）からのストリームである場合、または情報がまだ利用できない場合、-1 を返します。戻り値は HTTP ダウンロードの場合だけ有効です。

VideoPlayer インスタンスの高さ（ピクセル単位）を指定する数値です。

注意：flash.media.Video.height プロパティは、fl.video.VideoPlayer.videoHeight プロパティと似ていますので、混同しないようにしてください。

関連する API エレメント

再生が一時停止または停止してアイドル状態になった Flash Media Server などのビデオサーバーへの接続が、Flash によって切断されるまでの時間（ミリ秒精度）。このプロパティは、HTTP 経由の FLV ファイルのダウンロードには影響しません。

ビデオストリームが既にアイドル状態である場合に、このプロパティを設定すると、タイムアウト時間の測定をその新しい値で再開します。

すべての VideoPlayer オブジェクトで、カスタムクラスをデフォルトの INCManager 実装として使用するには、iNCManagerClass プロパティに、カスタムクラスのクラスオブジェクトかストリング名を設定します。カスタムクラスの定義を保持するのは、FLVPlayback クラスであり、ビデオプレーヤーではありません。

デフォルトの値はストリングとしての「fl.video.NCManager」です。

ブール値です。ビデオストリームがライブである場合に true になります。このプロパティは、Flash Media Server またはその他の Flash Video Streaming Service からのストリーミングである場合にのみ有効です。HTTP ダウンロードでは、このプロパティの値は無視されます。

事前にレコーディングされたビデオストリームをビデオプレーヤーに送信する場合は isLive プロパティを false に設定し、ライブブロードキャストなどのリアルタイムデータを送信する場合は true に設定します。パフォーマンスを向上させるために isLive プロパティを false に設定した場合は、bufferTime プロパティを 0 に設定しないでください。

関連する API エレメント

RTMP を使用して Flash Media Server（FMS）から FLV ファイルをストリーミングする場合に true になるブール値。他の FLV ソースファイルの場合、この値は false になります。

関連する API エレメント

メタデータ情報パケットであるオブジェクトです。NetSteam.onMetaData() コールバックメソッドの呼び出しで、利用できる場合に返されます。metadataReceived イベントが送出されると、準備が整います。

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

関連する API エレメント

INCManager を実装するクラスのインスタンスへのアクセスを可能にする INCManager オブジェクトです。これは NCManager クラスへのインターフェイスです。

このプロパティを使用して、カスタム初期化を必要とするカスタム INCManager を実装することができます。

関連する API エレメント

ビデオプレーヤーによって作成された NetConnection インスタンスへの直接アクセスを可能にします。

ビデオプレーヤーによって作成された NetStream インスタンスへの直接アクセスを可能にします。

NetStream のクライアントプロパティにカスタムクラスを登録します。デフォルトでは、fl.video.VideoPlayerClient が使用されます。このクラスは onMetaData() および onCuePoint() メッセージを処理します。onImageData() および onTextData() などの他のメッセージのカスタム処理を追加するには、独自のクラスを作成し、このプロパティをクラスに設定します。

クラスのコンストラクターは VideoPlayer インスタンスを唯一のパラメーターとして取り、Boolean の ready プロパティを持つ必要があります。このプロパティは、クライアントがファイルの先頭に必要なデータメッセージを待機している間は false であることが必要です。VideoPlayer が、これらのメッセージを受け取る前にサイズ調整と自動巻き戻しを行うと、メッセージを受け取れなくなる可能性があります。デフォルトでは、fl.video.VideoPlayerClient は、onMetaData() が呼び出されるとすぐに ready プロパティから true を返します。

このプロパティは、クラスオブジェクト自体に設定することも（下記の例）、クラスのストリング名に設定することもできます。

        import fl.video.
        VideoPlayer.netStreamClientClass = MyCustomClient;
        

クラスのストリング名に設定する場合、それだけではクラスを SWF にコンパイルできないことに注意してください。デフォルト値は、ストリング名ではなく、クラスオブジェクト fl.video.VideoPlayerClient です。

カスタム実装では fl.video.VideoPlayer をサブクラス化することを強くお勧めします。サブクラス化しない場合、VideoPlayer および FLVPlayback コンポーネントに組み込まれるメタデータとキューポイントの処理が機能しない可能性があります。

デフォルト値： fl.video.VideoPlayerClient。

現在の再生ヘッドの時間または位置を秒単位で示す数値です。小数をとる場合があります。このプロパティを設定すると、シークがトリガーされ、シークのすべての制限が適用されます。

再生ヘッド時間の変更（FLV ファイル再生中の 0.25 秒ごとのものも含む）で、playheadUpdate イベントが送出されます。

いくつかの理由により、seek メソッドを呼び出した直後、またはシークが発生するように playheadTime を設定した直後には、playheadTime プロパティに予期した値が反映されないことがあります。まず、プログレッシブダウンロードの場合はキーフレームへのシークしか実行できないので、シークすると、指定した時間以降にある最初のキーフレームの時間に移動します。一方、ストリーミングの場合のシークでは、ソース FLV ファイル内の目的の位置にキーフレームがない場合でも、正確な時間に移動します。また、シークは非同期なので、seek メソッドの呼び出しや playheadTime プロパティの設定を行っても、playheadTime はすぐには更新されません。シークの完了後に時間を取得するには、seek イベントを監視する必要があります。このイベントは、playheadTime プロパティが更新されるまで発生しません。

関連する API エレメント

各 playheadUpdate イベント間の時間をミリ秒単位で示す数値です。FLV ファイルの再生中にこのプロパティを設定すると、タイマーが再始動します。

ActionScript キューポイントは再生ヘッドの更新時に始動するので、playheadUpdateInterval プロパティの値を低くすると、ActionScript キューポイントの精度を上げることができます。

再生ヘッドの更新間隔は setInterval() グローバルメソッドの呼び出しによって設定されるので、この方法でどのような間隔を設定したとしても、SWF ファイルのフレームレートよりも短い間隔で更新を行うことはできません。そのため、例えばデフォルトのフレームレートが 1 秒あたり 12 フレームである場合、実質的に作成できる最小の間隔は約 83 ミリ秒です。これは、1 秒（1000 ミリ秒）を 12 で割った数値です。

デフォルト値： 250。

関連する API エレメント

各 progress イベント間の時間をミリ秒単位で示す数値です。ビデオストリーム再生中に、このプロパティを設定すると、タイマーが再始動します。

自動サイズ変更時に、ビデオコンテンツの整列に使用する高さ。registrationHeight プロパティを height プロパティと混同しないようにしてください。height プロパティは、ビデオコンテンツの実際の高さを反映します。

例 1：以下の設定を使用して、80×80 である FLV ファイルをロードします。

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

例 2：以下の設定を使用して、例 1 と同じシナリオをロードします。

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

例 3：以下の設定を使用して、例 2 と同じシナリオをロードします。

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

registrationHeight プロパティを設定することは、height プロパティを設定することと同じです。高さを変更する他のプロパティやメソッド（scaleX、setSize、setScale など）を設定したり呼び出したりしても、height と registrationHeight は同期されます。

関連する API エレメント

自動サイズ変更時に、ビデオコンテンツの整列に使用する幅。registrationWidth プロパティを width プロパティと混同しないようにしてください。width プロパティは、ビデオコンテンツの実際の幅を反映します。

例 1：以下の設定を使用して、80×80 である FLV ファイルをロードします。

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

例 2：以下の設定を使用して、例 1 と同じシナリオをロードします。

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

例 3：以下の設定を使用して、例 2 と同じシナリオをロードします。

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

registrationWidth プロパティを設定することは、width プロパティを設定することと同じです。幅を変更する他のプロパティやメソッド（scaleX、setSize、setScale など）を設定したり呼び出したりしても、width と registrationWidth は同期されます。

関連する API エレメント

自動サイズ変更時に、ビデオコンテンツの整列に使用する x 座標。ビデオコンテンツの実際の位置を反映する x プロパティと混同しないようにしてください。

例 1：以下の設定を使用して、80×80 である FLV ファイルをロードします。

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

例 2：以下の設定を使用して、例 1 と同じシナリオをロードします。

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

例 3：以下の設定を使用して、例 2 と同じシナリオをロードします。

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

x か registrationX プロパティのいずれかを設定すると、後者のプロパティは、前者からのオフセットを維持するために変更されます。例えば、x = 10、registrationX = 20 であるときに、x = 110 を設定すると registrationX = 120 が設定されます。

関連する API エレメント

自動サイズ変更時に、ビデオコンテンツの整列に使用する y 座標。ビデオコンテンツの実際の位置を反映する y プロパティと混同しないようにしてください。

例 1：以下の設定を使用して、80×80 である FLV ファイルをロードします。

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

例 2：以下の設定を使用して、例 1 と同じシナリオをロードします。

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

例 3：以下の設定を使用して、例 2 と同じシナリオをロードします。

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

y か registrationY プロパティのいずれかを設定すると、後者のプロパティは、前者からのオフセットを維持するために変更されます。例えば、y = 10、registrationY = 20 であるときに、y = 110 を設定すると registrationY = 120 が設定されます。

関連する API エレメント

ロード後にビデオのサイズをどのように変更するかを指定します。VideoScaleMode.MAINTAIN_ASPECT_RATIO に設定した場合、registrationX、registrationY、registrationWidth、および registrationHeight で定義されている矩形内で、ビデオの縦横比を維持します。VideoScaleMode.NO_SCALE に設定すると、ビデオは自動的にソース FLV ファイルのサイズになります。VideoScaleMode.EXACT_FIT に設定すると、ソース FLV ファイルのサイズを無視して、registrationX、registrationY、registrationWidth および registrationHeight で定義されている矩形に合わせてビデオを拡大 / 縮小します。これが設定されていると、FLV ファイルのロード直後に自動レイアウトが開始されます。値は、VideoScaleMode から来ます。

デフォルト値： VideoScaleMode.MAINTAIN_ASPECT_RATIO。

関連する API エレメント

水平方向の拡大 / 縮小を示す数値です。

デフォルト値： 1。

関連する API エレメント

垂直方向の拡大 / 縮小を示す数値です。

デフォルト値： 1。

関連する API エレメント

NetStream.soundTransform プロパティに直接アクセスして、サウンドコントロールをさらに公開できるようにします。設定を変更するには、このプロパティを設定します。現在の設定を取得するには、プロパティの getter アクセサメソッドを使用します。

関連する API エレメント

ストリーミングする FLV ファイルの URL とストリーミング方法を指定するストリングです。URL には、FLV ファイルの HTTP URL、ストリームの RTMP URL、または XML ファイルの HTTP URL を指定できます。

コンポーネントインスペクターまたはプロパティインスペクターを通じてこのプロパティを設定する場合、FLV ファイルは次の enterFrame イベントの発生時にロードと再生を開始します。このイベントまでの遅延は、特にロードに影響する isLive、autoPlay および cuePoints の各プロパティを設定する時間になります。また、最初のフレームにある ActionScript で、再生が始まる前に FLVPlayback コンポーネントに影響を与えることが可能になります。

ActionScript でこのプロパティを設定すると、VideoPlayer.load() メソッドをすぐに呼び出します（autoPlay プロパティが false に設定されている場合）。または、VideoPlayer.play() メソッドを呼び出します（autoPlay プロパティが true に設定されている場合）。新しい FLV ファイルのロード方法に影響する autoPlay、totalTime、および isLive の各プロパティの設定は、sourceプロパティを設定する前に行う必要があります。

新しい FLV ファイルが自動的に再生されないようにするには、autoPlay プロパティに false を設定します。

関連する API エレメント

コンポーネントの状態を指定するストリングです。このプロパティは、load()、play()、stop()、pause()、および seek() メソッドによって設定されます。

state プロパティに設定できる値は、buffering、connectionError、disconnected、loading、paused、playing、rewinding、seeking、および stopped です。FLVPlayback クラスプロパティを使用して、これらの状態をテストできます。

関連する API エレメント

ブール値です。応答状態である場合に true になります。無応答状態である場合に、play()、load()、stop()、pause()、および seek() の各メソッドを呼び出すと、その要求はキューに置かれ、いずれかの応答状態に移行したときに実行されます。これらの呼び出しはキューに置かれて後で実行されるので、通常は stateResponsive プロパティの値を追跡する必要はありません。応答状態とは、stopped、playing、paused、および buffering のことです。

関連する API エレメント

ビデオ再生時間の合計を表す数値（秒単位）です。

Flash Media Server（FMS）からのストリーミングでデフォルトの NCManager を使用している場合、この値はサーバーサイドアプリケーションプログラミングインターフェイス（API）で自動的に決まり、このプロパティで設定された値やメタデータから収集された値よりも優先されます。このプロパティを読み取る準備が整うのは、stopped や playing 状態が source プロパティの設定後に生じたときです。FMS からのライブストリームでは、このプロパティは無効です。

HTTP ダウンロードでは、FLV ファイルにメタデータが埋め込まれていると、この値は自動的に決定されます。埋め込まれていない場合、明示的に設定しなければ NaN になります。明示的に設定すると、ストリーム中のメタデータの値は無視されます。

このプロパティを設定した後、その値が影響するのは、source を設定してロードされた次の FLV ファイルからです。既にロードされている FLV ファイルには影響はありません。さらに、このプロパティは、FLV ファイルがロードされるまで、渡された新しい値を返しません。

このプロパティを（明示的にも自動的にも）設定しない場合でも再生できますが、シークコントロールで問題が発生する場合があります。

値を明示的に設定しない限り、メタデータからの有効な値に設定されるまで NaN になります。

関連する API エレメント

ロードされた FLV ファイルのソース幅です。まだ利用できる情報がない場合は、このプロパティは -1 を返します。

関連する API エレメント

ロードされた FLV ファイルのソース幅です。まだ利用できる情報がない場合は、このプロパティは -1 を返します。

関連する API エレメント

ブール値です。true の場合は、VideoPlayer インスタンスを可視にします。false の場合は、コンポーネントを非表示にします。

デフォルト値： true。

ボリュームコントロール設定値を示す 0 ～ 1 の間の数値です。

デフォルト値： 1。

関連する API エレメント

ステージ上の VideoPlayer インスタンスの幅を指定する数値です。

注意：flash.media.Video.width プロパティは fl.video.VideoPlayer.videoWidth プロパティと似ています。

関連する API エレメント

ビデオプレーヤーの水平方向の位置（ピクセル単位）を指定する数値です。

x プロパティを設定すると、registrationX プロパティにも影響します。x か registrationX プロパティのいずれかを設定すると、後者のプロパティは、前者からのオフセットを維持するために変更されます。例えば、x = 10、registrationX = 20 であるときに、x = 110 を設定すると registrationX = 120 が設定されます。

関連する API エレメント

ビデオプレーヤーの垂直方向の位置（ピクセル単位）を指定する数値です。

y プロパティを設定すると、registrationY プロパティにも影響します。y か registrationY プロパティのいずれかを設定すると、後者のプロパティは、前者からのオフセットを維持するために変更されます。例えば、y = 10、registrationY = 20 であるときに、y = 110 を設定すると registrationY = 120 が設定されます。

関連する API エレメント

指定された幅と高さで VideoPlayer オブジェクトを作成します。

関連する API エレメント

ビデオストリームおよび Flash Media Server 接続を強制的に閉じます。このメソッドは close イベントをトリガーします。アイドルタイムアウト機能がストリームを閉じる処理を行っているので、通常は直接このメソッドを呼び出す必要はありません。

関連する API エレメント

play() メソッドに似ていますが、これは再生せずに FLV ファイルをロードします。該当する場合は自動サイズ変更を行い、FLV ファイルの最初のフレームを表示します。最初のロードおよびレイアウトの後に、状態は VideoState.PAUSED になります。

このメソッドは、play() メソッドと同じパラメーターを取りますが、URL を指定せずに load() メソッドを呼び出すことはできません。これを行ってしまうと、エラーがスローされます。ビデオプレーヤーが無応答状態である場合は、load() メソッドはその要求をキューに置きます。

パラメーター

関連する API エレメント

INCManager.connectToURL() メソッドの呼び出し後に接続が完了または失敗した後で、INCManager によって呼び出されます。接続が失敗した場合は、呼び出す前に INCManager.netConnection プロパティを null または undefined に設定します。

関連する API エレメント

INCManager.reconnect() メソッドの呼び出し後に再接続が完了または失敗した後で、INCManager によって呼び出されます。接続が失敗する場合は、呼び出す前に INCManager.netconnection プロパティに null を設定します。

関連する API エレメント

ビデオ再生を一時停止します。ビデオを一時停止または停止した場合、効果はありません。再生を再開するには、play() を呼び出します。パラメーターを取りません。

プレーヤーが無応答状態である場合は、pause() メソッドはその要求をキューに置きます。

ストリームが接続されていない場合、例外がスローされます。stateChange イベントと connected プロパティを使用して、このメソッドを安全に呼び出せる時期を判断します。

プレーヤーが停止状態である場合は、pause() メソッドを呼び出しても効果はなく、プレーヤーは停止状態のままです。

関連する API エレメント

ビデオを再生します。ビデオが一時停止または停止しているとき、またはビデオが既に再生中であるときに呼び出すことができます。引数なしでこのメソッドを呼び出し、既にロードされているビデオを再生するか、URL を渡して新しいストリームをロードすることができます。

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

引数なしで呼び出したときにストリームが接続されていない場合は、例外がスローされます。stateChange イベントと connected プロパティを使用して、このメソッドを安全に呼び出せる時期を判断します。

パラメーター

関連する API エレメント

FLV ファイルを十分にダウンロードした後で再生します。FLV ファイルのダウンロードが完了している場合、または Flash Media Server（FMS）からストリーミングしている場合、playWhenEnoughDownloaded() メソッドを呼び出すことは、パラメーターを指定しない play() メソッドと同じです。このメソッドを呼び出しても再生は一時停止されないので、多くの場合、このメソッドを呼び出す前に pause() メソッドを呼び出す必要があります。

ファイル内の指定時間（秒単位）を小数点以下 3 桁までの精度（ミリ秒精度）でシークします。ビデオが再生中の場合は、そのポイントから再生が続行されます。ビデオが一時停止中の場合は、ビデオはそのポイントにシークしますが、一時停止のままです。ビデオが停止されている場合は、そのポイントをシークして一時停止状態に入ります。ライブストリームには影響しません。

playheadTime プロパティの値は、seek メソッドを呼び出した直後やシークを発生させるために playheadTime を設定した直後には、想定した値が反映されていないことがあります。プログレッシブダウンロードの場合はキーフレームへのシークしか実行できないため、シークすると、指定した時間以降にある最初のキーフレームの時間に移動します

注意：ストリーミングの場合のシークでは、ソース FLV ファイル内の目的の位置にキーフレームがない場合でも、ちょうどその指定した時間に移動します。

シークは非同期であるため、シークメソッドの呼び出しや playheadTime プロパティの設定を行っても、playheadTime はすぐには更新されません。シークの完了後に時間を取得するには、seek イベントを監視する必要があります。このイベントは、playheadTime プロパティが更新されるまで開始しません。

ストリームが接続されていない場合、例外がスローされます。stateChange イベントと connected プロパティを使用して、このメソッドを安全に呼び出せる時期を判断します。

パラメーター

関連する API エレメント

scaleX プロパティと scaleY プロパティを同時に設定します。scaleX または scaleY を設定すると、個々に 2 つの autolayout イベントがトリガーされますが、setScale() メソッドを呼び出すと、1 つの autolayout イベントしか発生しません。

scaleMode プロパティが VideoScaleMode.MAINTAIN_ASPECT_RATIO または VideoScaleMode.NO_SCALE である場合にこのメソッドを呼び出すと、直後に autolayout イベントが発生します。

パラメーター

関連する API エレメント

width プロパティと height プロパティを同時に設定します。width または height を設定すると、個々に 2 つの autolayout イベントがトリガーされますが、setSize() メソッドを呼び出すと、1 つの autolayout イベントしか発生しません。

scaleMode プロパティが VideoScaleMode.MAINTAIN_ASPECT_RATIO または VideoScaleMode.NO_SCALE である場合にこのメソッドを呼び出すと、直後に autolayout イベントがトリガーされます。

パラメーター

関連する API エレメント

ビデオ再生を停止します。autoRewind が true に設定されている場合、最初のフレームまで巻き戻しされます。ビデオが既に停止していた場合、効果はありません。再生を再開するには、play() を呼び出します。パラメーターを取りません。

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

ストリームが接続されていない場合、例外がスローされます。stateChange イベントと connected プロパティを使用して、このメソッドを安全に呼び出せる時期を判断します。

関連する API エレメント

autoRewind プロパティが true に設定されていて、再生ヘッドがビデオプレーヤーの先頭に移動したときに送出されるイベントです。

autoRewound イベントは VideoEvent タイプで、VideoEvent.AUTO_REWOUND 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

NetConnection を閉じるときに、タイムアウトまたは close() メソッドの呼び出しによって、VideoPlayer インスタンスから送出されます。あるいは、load() または play() メソッドを呼び出すか、source プロパティを設定し、その結果 RTMP 接続が閉じられるときに送出されます。FLVPlayback インスタンスは、Flash Media Server（FMS）またはその他の Flash Video Streaming Service（FVSS）からのストリーミングである場合にのみ、このイベントを送出します。

close イベントは VideoEvent タイプで、VideoEvent.CLOSE 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

プレーヤーが FLV ファイルの最後に到達して再生が完了したときに送出されます。stop() メソッドまたは pause() メソッドを呼び出した場合、または対応するコントロールをクリックした場合、イベントは送出されません。

アプリケーションでプログレッシブダウンロードを使用すると totalTime プロパティが明示的に設定されないため、メタデータで継続時間が指定されていない FLV ファイルがダウンロードされます。ビデオプレーヤーでこのイベントが送出される前に、totalTime プロパティがおよその合計値に設定されます。

ビデオプレーヤーでは stateChange イベントと stopped イベントも送出されます。

complete イベントは VideoEvent タイプで、VideoEvent.COMPLETE 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

キューポイントに到達したときに送出されます。イベントオブジェクトには info プロパティがあります。このプロパティには、FLV ファイルのキューポイントの NetStream.onCuePoint イベントコールバックによって受け取った info オブジェクトが含まれます。ActionScript キューポイントの場合は、ActionScript キューポイントのメソッドまたはプロパティに渡されたオブジェクトを含みます。

cuePoint イベントは MetadataEvent タイプで、MetadataEvent.CUE_POINT 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

drmAuthenticate イベント

drmError イベント

drmError イベント

ビデオプレーヤーがサイズ変更またはレイアウトされたときに送出されます。レイアウトには次の 2 つのシナリオがあります。

• autoLayout イベントを使用するか、setScale() メソッドまたは setSize() メソッドを呼び出すか、width、height、scaleX、scaleY プロパティを変更して、ビデオプレーヤーを配置した場合。
• サイズの異なる 2 つのビデオプレーヤーがあり、visibleVideoPlayerIndex プロパティを別のビデオプレーヤーに切り替えた場合。

layout イベントは LayoutEvent タイプで、LayoutEvent.LAYOUT 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

FLV ファイルのメタデータに初めて到達したときに送出されます。イベントオブジェクトには info プロパティがあります。このプロパティには、NetStream.onMetaData イベントコールバックによって受け取った info オブジェクトが含まれます。

metadataReceived イベントは MetadataEvent タイプで、MetadataEvent.METADATA_RECEIVED 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

playheadUpdateInterval プロパティに指定された間隔で FLV ファイルを再生中のとき、または巻き戻しの開始時に送出されます。シークが発生していない限り、ビデオプレーヤーが一時停止中または停止中である場合には、イベントは送出されません。

playheadUpdate イベントは VideoEvent タイプで、VideoEvent.PLAYHEAD_UPDATE 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

進捗状況はダウンロードしたバイト数で表されます。progressInterval プロパティによって指定された間隔で送出されます。ロードが開始したときに開始し、すべてのバイトがロードされるか、ネットワークエラーが発生したときに終了します。デフォルトは 0.25 秒です。load メソッドを呼び出してから、すべてのバイトがロードされて終了するまでの間、またはネットワークエラーが発生するまでの間、0.25 秒ごとに送出されます。このイベントを使用して、ロードされたバイトとバッファーのバイト数をチェックできます。

HTTP プログレッシブダウンロードの場合のみ送出されます。進捗状況はダウンロードされたバイト数単位で表されます。イベントオブジェクトには、bytesLoaded プロパティと bytesTotal プロパティがあります。これらのプロパティは、同じ名前の FLVPlayback プロパティと同じです。

progress イベントは VideoProgressEvent タイプで、VideoProgressEvent.PROGRESS 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

FLV ファイルがロードされて、表示準備ができたときに送出されるイベントです。play() メソッドまたは load() メソッドを使用して新しい FLV ファイルをロードした後で、初めて応答状態に移行したときに発生します。ロードされる FLV ファイルごとに 1 回のみ発生します。

ready イベントは VideoEvent タイプで、VideoEvent.READY 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

再生状態が変更されたときに送出されます。autoRewind の呼び出しが完了すると、stateChange イベントが巻き戻し状態で送出されます。stateChange イベントは、巻き戻しが完了するまで発生しません。

このイベントを使用すると、接続中、サイズ変更中、巻き戻し中など、再生が応答状態から無応答状態または無応答状態から応答状態に移行する状態をトレースできます。play()、pause()、stop()、seek() の各メソッドは要求をキューイングし、プレーヤーが応答状態に移行したときにそれらを実行します。

stateChange イベントは VideoEvent タイプで、VideoEvent.STATE_CHANGE 定数があります。

このイベントには、次のプロパティがあります。

関連する API エレメント

コンポーネントの短いバージョン番号を示す状態変数です。バージョン番号は、FLA ファイルのコンポーネントバージョンを確認する必要がある場合に役立ちます。コンポーネントバージョンを確認するには、FLA ファイルに次のコードを挿入します。

FLVPlayback.SHORT_VERSION

SHORT_VERSION 変数には、メジャーバージョン番号とマイナーバージョン番号のみが含まれています（例：2.0）。VERSION 変数には、メジャーバージョン番号とマイナーバージョン番号だけでなく、リビジョンやビルド番号が含まれています（例：2.0.0.11）。

関連する API エレメント

コンポーネントの長いバージョン番号を示す状態変数です。バージョン番号は、FLA ファイルのコンポーネントバージョンを確認する必要がある場合に役立ちます。コンポーネントバージョンを確認するには、FLA ファイルに次のコードを挿入します。

FLVPlayback.VERSION

VERSION 変数には、メジャーバージョン番号とマイナーバージョン番号だけでなく、リビジョンやビルド番号が含まれています（例：2.0.0.11）。SHORT_VERSION 変数には、メジャーバージョン番号とマイナーバージョン番号のみが含まれています（例：2.0）。

関連する API エレメント

例を実行するには、次の手順に従います。

1. FLVPlayback コンポーネントをライブラリに追加します。
2. testVideoPath を FLV ファイルへの絶対パスか相対パスで置き換えます。
3. このコードを、"VideoPlayerExample.as" として FLA ファイルがあるディレクトリに保存します。
4. FLA ファイルの Document クラスに VideoPlayerExample を設定します。

package
{
    import fl.video.VideoPlayer;
    import flash.display.Sprite;
    import flash.filters.BlurFilter;

    public class VideoPlayerExample extends Sprite 
    {
        private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv"
        private var player:VideoPlayer;
        private var blurryPlayer:VideoPlayer;
        
        public function VideoPlayerExample() {
            player = new VideoPlayer();
            player.play(videoPath);
            player.setScale(0.75, 0.75);
            addChild(player);
            
            blurryPlayer = new VideoPlayer();
            blurryPlayer.play(videoPath);
            blurryPlayer.setScale(0.75,0.75);
            blurryPlayer.filters = [ new BlurFilter(8, 8, 1) ];
            blurryPlayer.x = 250;
            addChild(blurryPlayer);            
        }
    }
}