バッファにデータが格納されてからの経過秒数です。このプロパティを bufferTime プロパティと組み合わせることにより、バッファが満たされるまでの推定時間を見積もることができます。たとえば、バッファにデータがロードされるのを待つユーザーに対してフィードバック情報を提供することが可能になります。

関連項目

ストリームの表示を開始するまでにメッセージをどの程度の時間バッファリングしておくかを指定します。たとえば、ストリームの最初の 15 秒間を中断することなく再生するには、bufferTime を 15 に設定します。この場合、Flash Player はデータを 15 秒間バッファリングしてからストリームの再生を開始します。

デフォルト値は 0.1 (1/10 秒) です。バッファ内のデータの経過秒数を調べるには、bufferLength プロパティを使用します。

関連項目

既に Player にロードされているデータのバイト数です。このプロパティを bytesTotal プロパティと組み合わせることにより、バッファが満たされるまでの推定時間を見積もることができます。たとえば、バッファにデータがロードされるのを待つユーザーに対してフィードバック情報を提供することが可能になります。

関連項目

Player にロードされるファイルの総バイト数です。

関連項目

FLV ファイルのロードを開始する前に、Flash Player が、ロードされる FLV ファイルのサーバーからクロスドメインポリシーファイルをダウンロードしようとするかどうかを指定します。このプロパティは、プログレッシブビデオダウンロードに NetStream オブジェクト (スタンドアローン FLV ファイル) を使用する場合、または呼び出し元の SWF ファイルの専用ドメイン外にある FLV ファイルをロードする場合に適用します。このプロパティは、NetStream オブジェクトを使用して RTMP アセットを取得する場合には無視されます。

呼び出し元の SWF ファイルのドメイン外から FLV ファイルをロードし、BitmapData.draw() メソッドを使用して、ビデオにピクセルレベルでアクセスする必要がある場合は、このプロパティを true に設定します。ロード時に checkPolicyFile プロパティを true に設定しないで BitmapData.draw() を呼び出した場合、SecurityError 例外を受け取る場合があります。これは、必要なポリシーファイルがダウンロードされていないためです。

ロードするビデオへのピクセルレベルのアクセスが必要ない場合は、checkPolicyFile を true に設定しないでください。ポリシーファイルの確認はネットワーク帯域幅の浪費になり、ダウンロードの開始が遅れる場合があります。

checkPolicyFile を true に設定して NetStream.play() メソッドを呼び出す場合、Flash Player は、関連するクロスドメインポリシーファイルを正常にダウンロードするか、NetStream.play() の呼び出しで指定したオブジェクトのダウンロードを開始する前に、そのようなポリシーファイルが存在しないことを判別しておく必要があります。ポリシーファイルの存在を確認するため、Flash Player は次のアクションをこの順番で実行します。

1. Flash Player は、既にダウンロードされているポリシーファイルを考慮します。
2. Flash Player は、Security.loadPolicyFile() メソッドの呼び出しで指定した保留中ポリシーファイルをダウンロードしようとします。
3. Flash Player は NetStream.play() に渡された URL に対応するデフォルトの場所からポリシーファイルをダウンロードしようとします。これは、その URL と同じサーバー上の /crossdomain.xml です。

どのような場合も、Flash Player では、該当するポリシーファイルがビデオのサーバー上に存在しており、ポリシーファイルの場所に基づいて play() に渡された URL にあるオブジェクトへのアクセスを提供し、<allow-access-from> タグによって呼び出し元 SWF ファイルのドメインがビデオにアクセスできるようにする必要があります。

checkPolicyFile を true に設定した場合、Flash Player はビデオをダウンロードする前に、ポリシーファイルが検証されるまで待機します。NetStream オブジェクトから onMetaData イベントまたは NetStatus イベントを受け取るまで、BitmapData.draw() を呼び出すなどの、ビデオデータに対するピクセルレベルの操作は実行を待つ必要があります。

checkPolicyFile を true に設定し、関連するポリシーファイルが見つからない場合、ポリシーファイルを必要とする操作を実行するまでエラーは表示されません。その後、Flash Player は SecurityError 例外をスローします。

サーバーサイド HTTP リダイレクトを使用する URL から FLV ファイルをダウンロードする場合は、checkPolicyFile に注意してください。Flash Player は、NetStream.play() で指定する初期 URL に対応するポリシーファイルを取得しようとします。最終的な FLV ファイルが HTTP リダイレクトによって別の URL から取得される場合、最初にダウンロードされたポリシーファイルは FLV ファイルの最終的な URL に適用できないことがあります。この URL はセキュリティ判定において重要です。

ポリシーファイルの詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。

関連項目

コールバックメソッドを呼び出すオブジェクトを指定します。デフォルトのオブジェクトは、作成される NetStream オブジェクト this です。client プロパティを別のオブジェクトに設定する場合は、コールバックメソッドをその別のオブジェクトで呼び出すことができます。

1 秒あたりの表示フレーム数です。複数のシステム上で再生できるように FLV ファイルを書き出す場合、テスト中にこの値をチェックすることで、ファイルの書き出し時にどの程度の圧縮が必要かを見極めることができます。

ライブ (バッファリングされていない) モードでサブスクライブしているストリームバッファ内にあるデータの秒数です。このプロパティは、現在のネットワーク転送が遅延していることを示します (遅延時間)。

このプロパティは、主に Flash Media Server などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。

このプロパティの値を取得して、ストリームの転送品質を大まかに判断し、それをユーザーに伝えることができます。

この NetStream オブジェクトのエンコード (AMF バージョン) です。NetStream オブジェクトは、関連付けされた NetConnection オブジェクトからその objectEncoding 値を継承します。ActionScript 3.0 SWF ファイルで Flash Player 9 以前にリリースされたサーバーと通信する必要がある場合は、このプロパティを理解することが重要です。詳細については、NetConnection クラスの objectEncoding プロパティに関する説明を参照してください。

このプロパティの値は、ローカルストリームかリモートストリームかによって異なります。ローカルストリームでは、NetConnection.connect() メソッドに null が渡され、NetConnection.defaultObjectEncoding の値が返されます。リモートストリームでは、サーバーに接続されており、このサーバーとの接続のオブジェクトエンコーディングが返されます。

接続されていない場合にこのプロパティを読み取ろうとするか、このプロパティを変更しようとすると、Flash Player により例外がスローされます。

関連項目

この NetStream オブジェクトのサウンドを制御します。詳細については、SoundTransform クラスを参照してください。

関連項目

再生ヘッドの位置 (秒単位) です。

関連項目

指定された NetConnection オブジェクトを使用して、FLV ファイルを再生するためのストリームを生成します。

関連項目

ソースとして渡される Microphone オブジェクトから NetStream オブジェクトを介して送信されるオーディオストリームを指定します。このメソッドは、指定されたストリームの発行者だけが使用できます。

このメソッドは、主に Flash Media Server などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。

このメソッドは、publish() メソッドを呼び出す前または後に呼び出すことができ、実際に送信を開始します。オーディオを聞きたいサブスクライバは NetStream.play() メソッドを呼び出す必要があります。指定の Microphone オブジェクトの soundTransform プロパティを使用して、このオーディオストリームのサウンドプロパティを制御できます。

関連項目

指定のソースからビデオのキャプチャを開始します。または、theCamera が null に設定されると、キャプチャを停止します。このメソッドは、指定されたストリームの発行者だけが使用できます。

このメソッドは、主に Flash Media Server などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。

ビデオソースのアタッチ後に、NetStream.publish() を呼び出して転送を開始する必要があります。ビデオを表示したいサブスクライバは、NetStream.play() と Video.attachCamera() の各メソッドを呼び出して、ステージ上にビデオを表示する必要があります。

snapshotMilliseconds を使用して値 0 を指定すると、単一のスナップショットを送信できます。また、正の数を指定して、ビデオフィードに指定のミリ秒数のトレーラを追加すると、一連のスナップショット、つまり事実上のコマ落としビデオを送信することができます。トレーラは、ビデオメッセージの表示時間を拡張します。snapshotMilliseconds に正の値を指定し、attachCamera() を繰り返し呼び出すと、スナップショットとトレーラの交互のシーケンスにより、コマ落としビデオが作成されます。たとえば、毎日 1 フレームずつキャプチャして、ビデオファイルに追加することができます。サブスクライバがファイルを再生すると、各フレームが指定のミリ秒間画面上に表示され、その後、次のフレームが表示されます。

この snapshotMilliseconds パラメータの目的は、Camera.setMode() で設定できる fps パラメータとは異なります。snapshotMilliseconds を指定すると、記録した各フレーム間で経過時間を制御できます。Camera.setMode() を使用して fps を指定すると、記録時と再生時に経過時間を制御できます。

たとえば、5 分ごとにスナップショットを 1 枚撮り、合計で 100 枚のスナップショットを撮るとします。この操作を行うには、次の 2 つの方法があります。

• NetStream.attachCamera(myCamera, 500) コマンドを 5 分に 1 回、合計 100 回実行できます。この場合、記録に 500 分かかりますが、生成されるファイルは 50 秒 (100 フレーム、各フレーム間 500 ミリ秒) で再生されます。
• 1/300 (300 秒ごとに 1 回、つまり 5 分に 1 回) の fps 値を指定して Camera.setMode() コマンドを発行した後、NetStream.attachCamera(source) コマンドを発行して、カメラが 500 分間連続してキャプチャするように設定できます。生成されるファイルは、500 分、つまり記録に要した時間と同じ長さで再生され、各フレームは 5 分間表示されます。

どちらの手法でも、同じ 500 個のフレームがキャプチャされます。どちらのアプローチも有用ですが、使用するアプローチは、主に再生要件によって異なります。たとえば、後者の場合、始めから最後までオーディオを録音し続けることができます。また、どちらの場合もファイルサイズはほとんど同じです。

ストリーム上のすべてのデータの再生を停止し、time プロパティを 0 に設定して、他のユーザーがストリームにアクセスできるようにします。また、このコマンドは、HTTP を使用してダウンロードされた FLV ファイルのローカルコピーを削除します。Flash Player では、Flash Player で作成した FLV ファイルのローカルコピーを削除しますが、ビデオのコピーがブラウザのキャッシュディレクトリに残る場合があります。FLV ファイルをキャッシュやローカル記憶域に一切残さないようにする必要がある場合には、Flash Media Server 2 を使用してください。

関連項目

ビデオストリームの再生を一時停止します。ビデオが既に一時停止している場合は、このメソッドを呼び出しても何も実行されません。

関連項目

外部オーディオファイルまたはビデオファイル (FLV) の再生を開始します。ビデオデータを表示するには、VIdeo オブジェクトを作成して、Video.attachNetStream() メソッドを呼び出す必要があります。ビデオと一緒にストリームされるオーディオ、またはオーディオだけが含まれた FLV ファイルは自動的に再生されます。マイクロホンからオーディオをストリームするには、NetStream.attachAudio() メソッドを使用し、Microphone オブジェクトを使用して、オーディオのいくつかの特性を制御します。

FLV ファイルに関連付けられたオーディオを制御するには、DisplayObjectContainer.addChild() メソッドを使用して、表示リスト上のオブジェクトにオーディオをアタッチします。その後、Sound オブジェクトを作成することにより、オーディオのいくつかの特性を制御できます。詳細については、DisplayObjectContainer.addChild() メソッドを参照してください。

FLV ファイルが見つからなかった場合は、netStatus イベントが送出されます。再生中のストリームを停止するには、close() メソッドを使用します。

このメソッドを使用するときは、Flash Player セキュリティモデルを考慮してください。

• 呼び出し元 SWF ファイルが ローカルファイルシステムのサンドボックスにあり、リソースがリモートサンドボックスにある場合、NetStream.play() を呼び出すことはできません。
• 信頼できるローカルのサンドボックスまたはネットワーク接続したローカルのサンドボックスからネットワーク上のサンドボックスにアクセスするには、クロスドメインポリシーファイルを使用して Web サイトで許可する必要があります。

詳細については、次のトピックを参照してください。

• 『ActionScript 3.0 のプログラミング』のセキュリティの章と LiveDocs の最新コメント
• Flash Player 9 セキュリティに関するホワイトペーパー

関連項目

クライアントから Flash Media Server 2 などのサーバーへ、ストリーミングオーディオ、ビデオ、およびテキストメッセージを送信します。送信中にストリームを録音することもできます。このメソッドは、指定されたストリームの発行者だけが使用できます。

このメソッドは、主に Flash Media Server 2 などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。

既にパブリッシュされているか、記録されているストリームをクライアントに再生させる場合は、このメソッドを使用しないでください。代わりに、そのクライアントの NetStream インスタンスを作成し、play() を呼び出します。

  var subscribeNS:NetStream = new NetStream(myNetConnection);
  subscribeNS.play("streamToPlay");
  

Flash Media Server 2 でストリームを記録する場合、FLV ファイルが作成され、サーバー上のアプリケーションディレクトリのサブディレクトリに格納されます。各ストリームは、NetConnection.connect() メソッドの command パラメータに渡されたアプリケーションインスタンス名の値と一致する名前のディレクトリに格納されます。これらのディレクトリは自動的に作成されるため、インスタンス名ごとに作成する必要はありません。たとえば、次のコードでは、アプリケーションディレクトリ内の lectureSeries というディレクトリに格納されているアプリケーションの特定のインスタンスとの接続方法を示しています。lecture.flv という名前のファイルが /yourAppsFolder/lectureSeries/streams/Monday というサブディレクトリに格納されています。

  var myNC:NetConnection = new NetConnection();
  myNC.connect("rtmp://server.domain.com/lectureSeries/Monday");
  var myNS:NetStream = new NetStream(myNC);
  myNS.publish("lecture", "record");
  

次の例では、同じアプリケーションの別のインスタンスに接続し、同一の publish コマンドを発行する方法を示します。lecture.flv という名前のファイルが /yourAppsFolder/lectureSeries/streams/Tuesday というサブディレクトリに格納されています。

  var myNC:NetConnection = new NetConnection();
  myNC.connect("rtmp://server.domain.com/lectureSeries/Tuesday");
  var myNS:NetStream = new NetStream(my_nc);
  myNS.publish("lecture", "record");
  

インスタンス名の値を渡さない場合、name プロパティに渡された値に一致するファイルが /yourAppsFolder/appName/streams/_definst_ ("デフォルトのインスタンス" の場合) というサブディレクトリに格納されます。インスタンス名の使用については、NetConnection.connect() メソッドを参照してください。FLV ファイルの再生については、 NetStream.play() メソッドを参照してください。

このメソッドは、各種情報オブジェクトで netStatus イベントを送出することができます。たとえば、誰かが既に指定した名前でストリームをパブリッシュしている場合、netStatus イベントは NetStream.Publish.BadName のコードプロパティで送出されます。詳細については、netStatus イベントを参照してください。

関連項目

ストリーム上で着信オーディオが再生されるかどうかを示します。このメソッドは、指定されたストリームにサブスクライブされたクライアントでのみ使用できます。ストリームの発行者は使用できません。

このメソッドは、主に Flash Media Server などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。

このメソッドは、NetStream.play() メソッドを呼び出す前または呼び出した後に呼び出すことができ、実際にストリームの受信を開始します。たとえば、着信オーディオストリームをミュートおよびミュート解除する場合、ユーザーがクリックするボタンにこれらのメソッドをアタッチできます。

指定のストリームにオーディオデータのみが含まれる場合、このメソッドに false の値を渡すと NetStream.time はこれ以上増加しなくなります。

ストリーム上で着信ビデオが再生されるかどうかを示します。このメソッドは、指定されたストリームにサブスクライブされたクライアントでのみ使用できます。ストリームの発行者は使用できません。

このメソッドは、主に Flash Media Server 2 などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。

このメソッドは、NetStream.play() メソッドを呼び出す前または呼び出した後に呼び出すことができ、実際にストリームの受信を開始します。たとえば、着信ビデオストリームを表示または非表示にする場合、ユーザーが押すボタンにこれらのメソッドをアタッチできます。

指定のストリームにビデオデータのみが含まれる場合、このメソッドに false の値を渡すと NetStream.time はこれ以上増加しなくなります。

再生を一時停止していたビデオストリームを再開します。ビデオが既に再生中である場合は、このメソッドを呼び出しても何も実行されません。

関連項目

指定の位置、すなわちストリームの先頭からのオフセット (秒単位) に最も近いキーフレームをシークします。この位置に到達したら、ストリームが再生を再開します。

関連項目

指定されたストリーム上で、サブスクライブしているすべてのクライアントにメッセージを送信します。このメソッドは、指定されたストリームの発行者だけが使用できます。

このメソッドは、主に Flash Media Server 2 などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。

メッセージを処理し、応答するには、myStream.HandlerName の形式でハンドラを作成します。

Flash Player はメソッドやそれらのデータ、オブジェクトプロトタイプ変数、または列挙不可能な変数を直列化しません。表示オブジェクトの場合、Flash Player はパスを直列化しますが、データは直列化しません。

関連項目

  import flash.net.NetConnection;
  import flash.net.NetStream;
  import flash.events.NetStatusEvent;
  import flash.media.Video;
  import flash.utils.setTimeout;
  
  var nc:NetConnection = new NetConnection();
  nc.objectEncoding = 0;
  nc.addEventListener("netStatus", onNCStatus);
  nc.connect("rtmp://www.example.com/MyApp/MyInstance");
  var ns1:NetStream;
  var vid:Video = new Video(300,300);
  addChild(vid);
  var obj:Object = new Object();
  obj.myFunction = function(event:String):void {
   trace(event);
  }
  
  function onNCStatus(event:NetStatusEvent):void {
   if(event.info.code == "NetConnection.Connect.Success") {
    ns1 = new NetStream(nc);
    ns1.play("MyVideo");
    vid.attachNetStream(ns1);
    ns1.client = obj;
    ns1.publish("dummy", "live");
    
    var ns2:NetStream = new NetStream(nc);
    ns2.play("dummy");
    ns2.client = obj;
    
    setTimeout(sendHello, 3000);
   }
  }
  
  function sendHello():void {
    ns1.send("myFunction", "hello");
  }
  

ストリームの再生を一時停止または再開します。このメソッドを呼び出すと最初は再生を一時停止し、次に呼び出したときには再生を再開します。このメソッドを使用して、ユーザーが 1 つのボタンを押すだけで再生を一時停止または再生できるようにすることができます。

関連項目

非同期形式で、つまりネイティブ非同期コードから例外がスローされると送出されます。このイベントは、サーバーが定義されていないメソッドをクライアント上で呼び出したときに送出されます。

AsyncErrorEvent.ASYNC_ERROR 定数は、asyncError イベントオブジェクトの type プロパティ値を定義します。

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

関連項目

入出力エラーが発生してネットワーク処理が失敗したときに送出されます。

ioError イベントオブジェクトの type プロパティの値を定義します。

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

NetStream オブジェクトが、そのステータスまたはエラーの状態をレポートすると送出されます。netStatus イベントには、info プロパティが含まれます。このプロパティは、接続試行が成功したかどうかなど、イベントに関する特定の情報を含む情報オブジェクトです。

netStatus イベントオブジェクトの type プロパティの値を定義します。

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

関連項目

FLV ファイルの再生中に、埋め込みキューポイントに達すると呼び出されます。このハンドラを使用して、ビデオが特定のキューポイントに達したときにコード内のアクションをトリガすることができます。これにより、アプリケーションの他のアクションとビデオ再生イベントと同期させることができます。

このイベントは、主に Flash Media Server 2 などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。このイベントは Flash Player API の一部ではありませんが、便宜上、リファレンスガイドで取り上げています。addEventListener() メソッドまたはその他の EventDispatcher メソッドを使用して、このイベントを受け取ったり、処理したりすることはできません。代わりに、1 つのコールバック関数を定義して、以下のオブジェクトのいずれかを直接アタッチする必要があります。

• Netstream インスタンスの client プロパティで参照されるオブジェクトです。
• Netstream サブクラスのインスタンスです。Netstream は sealed クラスで、実行時に プロパティまたはメソッドを Netstream オブジェクトに追加できないことを意味します。ただし、Netstream のサブクラスを作成し、そのサブクラス内にイベントハンドラを定義することや、サブクラスをダイナミックにして、イベントハンドラ関数をサブクラスのインスタンスに追加することができます。

FLV ファイルに埋め込み可能なキューポイントには、次のタイプがあります。

• ナビゲーションキューポイントは FLV ファイル内のキーフレームと、その厳密に一致するキーフレームに対応するキューポイントの time プロパティを指定します。ナビゲーションキューポイントは、ユーザーをビデオファイルに移動させるブックマークやエントリポイントとしてよく使われます。
• イベントキューポイントは、時間で指定します。その時間が特定のキーフレームに対応しているかどうかは関係ありません。イベントキューポイントは、通常ビデオ内で何か処理が行われるときの時間を表し、他のアプリケーションイベントのトリガに使用できます。

onCuePoint イベントオブジェクトには、次のプロパティが含まれます。

最初に FLV ファイルをエンコードするとき、または Flash オーサリングツールでビデオの読み込みウィザードを使用してビデオクリップを読み込むときに、FLV ファイルにキューポイントを定義できます。

onMetaData イベントも、ビデオファイル内のキューポイントに関する情報を取得します。ただし、onMetaData イベントは、ビデオの再生が開始される前に、すべてのキューポイントに関する情報を取得します。onCuePoint イベントは、再生時にそのキューポイントに指定された時間に、1 つのキューポイントに関する情報を取得します。

一般に、コードで特定のキューポイントの発生時に応答するには、onCuePoint イベントを使用して、コード内の特定のアクションをトリガします。

onMetaData イベントに指定されたキューポイントのリストを使用すると、ビデオストリームの事前に定義されたポイントでユーザーにビデオの再生を開始させることができます。キューポイントの time プロパティの値を NetStream.seek() メソッドに渡して、そのキューポイントからビデオを再生します。

関連項目

再生中の FLV ファイルに埋め込まれている説明情報を Flash Player が受け取ったときに送出されます。

この特別なイベントは、主に Flash Media Server などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。この特別なイベントは厳密には Flash Player API の一部ではありませんが、便宜上、リファレンスガイドで取り上げています。addEventListener() メソッドまたはその他の EventDispatcher メソッドを使用して、このイベントを受け取ったり、処理したりすることはできません。代わりに、1 つのコールバック関数を定義して、以下のオブジェクトのいずれかを直接アタッチする必要があります。

• Netstream インスタンスの client プロパティで参照されるオブジェクトです。
• Netstream サブクラスのインスタンスです。Netstream は sealed クラスで、実行時に プロパティまたはメソッドを Netstream オブジェクトに追加できないことを意味します。ただし、Netstream のサブクラスを作成し、そのサブクラス内にイベントハンドラを定義することや、サブクラスをダイナミックにして、イベントハンドラ関数をサブクラスのインスタンスに追加することができます。

Flash Video Exporter ユーティリティ (バージョン 1.1 以降) は、ビデオの継続時間、作成日付、データレート、その他の情報をビデオファイルに埋め込みます。各ビデオエンコーダは、それぞれ異なるメタデータのセットを埋め込みます。

このイベントは、NetStream.play() メソッドの呼び出し後、ただしビデオ再生ヘッドが進むよりは前にトリガされます。

多くの場合、FLV メタデータに埋め込まれた継続期間の値は実際の継続時間に近似したものになりますが、正確な値ではありません。つまり、再生ヘッドがビデオストリームの末尾にある場合、FLV メタデータに埋め込まれた継続期間の値は NetStream.time プロパティの値と必ずしも一致するわけではありません。

関連項目

NetStream オブジェクトによるストリームの再生が終了したときに送出されます。このハンドラにより、情報オブジェクトが返され、netStatus イベントにより返される情報以外の情報も提供されます。このハンドラを使用すると、(情報オブジェクト NetStream.Play.Switch で示されているように) 再生リストで NetStream オブジェクトがストリームを切り替えたとき、または (情報オブジェクト NetStream.Play.Complete で示されているように) NetStream オブジェクトが終わりまで再生したときに、コード内のアクションをトリガできます。このイベントに応答するには、サーバーから送られる情報オブジェクトを処理する関数を作成する必要があります。

このイベントは、主に Flash Media Server などのサーバーで使用することを目的としています。詳細については、クラスの説明を参照してください。このイベントは Flash Player API の一部ではありませんが、便宜上、リファレンスガイドで取り上げています。addEventListener() メソッドまたはその他の EventDispatcher メソッドを使用して、このイベントを受け取ったり、処理したりすることはできません。代わりに、1 つのコールバック関数を定義して、以下のオブジェクトのいずれかを直接アタッチする必要があります。

• Netstream インスタンスの client プロパティで参照されるオブジェクトです。
• Netstream サブクラスのインスタンスです。Netstream は sealed クラスで、実行時に プロパティまたはメソッドを Netstream オブジェクトに追加できないことを意味します。ただし、Netstream のサブクラスを作成し、そのサブクラス内にイベントハンドラを定義することや、サブクラスをダイナミックにして、イベントハンドラ関数をサブクラスのインスタンスに追加することができます。

このイベントでは、次のプロパティが指定された情報オブジェクトを返すことができます。

関連項目

この例では、Video オブジェクトと NetStream オブジェクトを作成し、 Video.attachNetStream() メソッドと NetStream.play() メソッドを呼び出すコードが ハンドラ関数に配置されます。ハンドラは、 NetConnection オブジェクトとの接続が成功した場合にのみ呼び出されます。つまり、 netStatus イベントが、成功したことを示す code プロパティとともに info オブジェクトを返す 場合です。 接続に成功するまで待ってから、次のコードを呼び出すことをお勧めします。 NetStream.play().

package {
    import flash.display.Sprite;
    import flash.events.NetStatusEvent;
    import flash.events.SecurityErrorEvent;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.events.Event;

    public class NetConnectionExample extends Sprite {
        private var videoURL:String = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        public function NetConnectionExample() {
            connection = new NetConnection();
            connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Stream not found: " + videoURL);
                    break;
            }
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }
    }
}

class CustomClient {
    public function onMetaData(info:Object):void {
        trace("metadata: duration=" + info.duration + " width=" + info.width + " height=" + info.height + " framerate=" + info.framerate);
    }
    public function onCuePoint(info:Object):void {
        trace("cuepoint: time=" + info.time + " name=" + info.name + " type=" + info.type);
    }
}