ProLoader  - AS3 Flash

load() メソッドまたは loadBytes() メソッドを使用して読み込まれた SWF ファイルまたはイメージ（JPG、PNG、または GIF）ファイルのルート表示オブジェクトが含まれます。

ロードされているオブジェクトに対応する ProLoaderInfo オブジェクトを返します。ProLoaderInfo オブジェクトは、ProLoader オブジェクトとロードされたコンテンツオブジェクト間で共有されます。ProLoaderInfo オブジェクトは、ロードの進行状況に関する情報と、ロードされたファイルに関する統計を提供します。

ロードに関連するイベントは、ProLoader オブジェクトの contentLoaderInfo プロパティで参照される ProLoaderInfo オブジェクトによって送出されます。contentLoaderInfo プロパティは、コンテンツのロードの前も、有効な ProLoaderInfo オブジェクトに設定されているので、ロードの前にイベントリスナーをオブジェクトに追加できます。

ロードされた SWF で発生する不明なエラーを検出するには、ProLoader.contentLoaderInfo.uncaughtErrorEvents プロパティではなく、ProLoader.uncaughtErrorEvents プロパティを使用します。

注意 contentLoaderInfo プロパティは ProLoaderInfo オブジェクトを返します。ProLoaderInfo は LoaderInfo のサブクラスではありません。このため、スーパークラスへの暗黙的な変換の利点は得られません。したがって、型宣言を LoaderInfo から ProLoaderInfo に必ず変更してください。

この ProLoader オブジェクトの SWF ファイルのコードで不明なエラーが発生したときに、uncaughtError イベントを送出するオブジェクトです。不明なエラーが発生するのは、いずれかの try..catch ブロックの外側でエラーがスローされたり、登録されたリスナーを持たない ErrorEvent オブジェクトが送出される場合です。

このプロパティが作成されるのは、このオブジェクトに関連付けられた SWF がロードを完了したときです。それまでは、uncaughtErrorEvents プロパティの値は null です。 ActionScript 専用のプロジェクトでは、SWF ファイルのメインクラスのコンストラクター関数の実行中または実行後にこのプロパティにアクセスできます。

サポートしていないプレーヤーでこの ProLoader プロパティにアクセスするとエラーが発生します。サポートしていないプレーヤーでのエラーの発生を防止するには、UncaughtErrorEvents オブジェクトの代わりに EventDispatcher オブジェクトを返します。

関連する API エレメント

SWF、JPEG、GIF、または PNG などのファイルのロードに使用できる ProLoader オブジェクトを作成します。アセットを ProLoader インスタンスの子としてロードするには、load() メソッドを呼び出します。その後、ProLoader オブジェクトを表示リストに追加できます。例えば、DisplayObjectContainer インスタンスの addChild() メソッドを使用して追加します。アセットは読み込まれるとステージに表示されます。

ProLoader インスタンスを「リスト外」で、つまり、表示リスト上の表示オブジェクトコンテナに追加しなくても使用できます。このモードの場合、Loader インスタンスを使用して、アプリケーションの追加モジュールを含む SWF ファイルを読み込むことができます。

SWF ファイルのロードが完了したことを検出するには、ProLoaderInfo オブジェクトの contentLoaderInfo プロパティに関連付けられた LoaderInfo オブジェクトのイベントを使用できます。その時点で、モジュール SWF ファイル内のコードを実行し、モジュールを初期化して、開始できます。リスト外モードでは、ProLoader インスタンスを使用して、コンポーネントまたはメディアアセットを含む SWF ファイルをロードすることもできます。この場合も、ProLoaderInfo オブジェクトのイベント通知を使用して、コンポーネントのロードが完了したことを検出できます。その時点で、アプリケーションは SWF ファイルのライブラリ内のコンポーネントとメディアアセットの使用を開始できます。これは、それらのコンポーネントとアセットを表す ActionScript 3.0 クラスをインスタンス化することによって行います。

ProLoader オブジェクトの状態を判別するには、ProLoader オブジェクトの contentLoaderInfo プロパティに関連付けられた ProLoaderInfo オブジェクトの次のイベントを監視します。

• open イベントは、読み込みが開始したときに送出されます。
• ioError または securityError イベントは、ファイルを読み込めない場合、あるいは読み込み中にエラーが発生した場合に送出されます。
• progress イベントは、ファイルが読み込まれている間、継続的に発生します。
• complete イベントは、ファイルのダウンロードが完了したときに送出されます。ただし、この時点では、ロードされたムービークリップのメソッドとプロパティはまだ使用できません。ロードされた SWF ファイルが RSL のプリロードを使用する場合、このイベントは RSL のプリロードの完了後に送出されます。この時点で、実際のコンテンツは content プロパティで使用できます。
• init イベントは、読み込まれた SWF ファイルのプロパティおよびメソッドにアクセスできるようになると、送出されます。そのため、読み込まれた SWF ファイルに対して各種の操作を開始できます。このイベントは、complete ハンドラーの前に送出されます。ストリーミング SWF ファイルの場合、init イベントは complete イベントよりもかなり前に発生することがあります。ほとんどの場合、init ハンドラーを使用します。ロードされた SWF ファイルが RSL のプリロードを使用する場合、このイベントは RSL のプリロードの完了後に送出されます。この時点で、実際のコンテンツは content プロパティで使用できます。

関連する API エレメント

ProLoader インスタンスに対して現在進行中の load() メソッドの処理をキャンセルします。

SWF、JPEG、プログレッシブ JPEG、非アニメーション GIF、または PNG ファイルを、この ProLoader オブジェクトの子であるオブジェクトにロードします。アニメーション GIF ファイルを読み込むと、先頭のフレームのみ表示されます。ProLoader オブジェクトには子を 1 つだけしか含めることができないため、後続の load() 要求を発行すると直前の要求（保留中であれば）を終了し、新たにロードを開始します。

注意：AIR 1.5 および Flash Player 10 では、読み込まれるイメージの最大サイズは幅または高さが 8,191 ピクセルです。ただし、総ピクセル数が 16,777,215 ピクセルを超えることはできません（したがって、読み込まれるイメージの幅が 8,191 ピクセルであった場合、高さは 2,048 ピクセルまでしか指定できません）。Flash Player 9 以前および AIR 1.1 以前では、高さの限界は 2,880 ピクセルで幅の限界は 2,880 ピクセルです。

ProLoader オブジェクトにロードした SWF ファイルまたはイメージは、その ProLoader オブジェクトの親の表示オブジェクトの位置、回転、および拡大 / 縮小の各プロパティを継承します。

このメソッドを使用して読み込まれたムービーまたはイメージを削除したり、進行中の読み込み処理をキャンセルするには、unload() メソッドを使用します。

SWF ファイルがこのメソッドを使用しないようにするには、SWF コンテンツを含んでいる HTML ページに allowNetworking パラメーター（object タグおよび embed タグのパラメーター）を設定します。

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

Flash Player 10 以降では、"multipart/form-data" などのマルチパート Content-Type にアップロードが含まれていると（アップロードが含まれているかどうかは POST ボディ内の "content-disposition" ヘッダーの "filename" パラメーターで示されます）、そのアップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

• POST 処理は、マウスのクリックやキーの押下などのユーザーが開始したアクションに応答して実行する必要があります。
• POST 処理がクロスドメインである（POST ターゲットが、POST 要求を送信中の SWF ファイルと同じサーバー上にない）場合は、クロスドメインアクセスを許可する URL ポリシーファイルをターゲットサーバーが提供する必要があります。

また、すべてのマルチパート Content-Type では、RFC2046 標準に準拠した有効なシンタックスを使用する必要があります。シンタックスが有効でない場合は、アップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：セキュリティを参照してください。

パラメーター

関連する API エレメント

ByteArray オブジェクトに保管されているバイナリデータからロードします。

loadBytes() メソッドは、非同期のメソッドです。読み込まれたオブジェクトのプロパティにアクセスする前に「init」イベントを待機する必要があります。

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

パラメーター

関連する API エレメント

promise パラメーターを介して IFilePromise インスタンスをロードします。promise パラメーターのタイプは、他のプレイヤーにおけるエラーを防ぐため、IFilePromise ではなく Object スーパークラスを使用します。

loadFilePromise メソッドは IFilePromise オブジェクトを使用し、バイナリデータを読み込みます。ビデオなど、データがプログレッシブストリームの場合、読み込まれたオブジェクトのプロパティにアクセスする前に、"init" または progress イベントを待ちます。それ以外の場合、データが完全に読み込まれたことを確認する complete イベントを待ちます。

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

パラメーター

関連する API エレメント

load() メソッドを使用してロードされた、この ProLoader オブジェクトの子を削除します。関連した ProLoaderInfo オブジェクトの property は null にリセットされます。他のオブジェクトが参照している可能性があるので、子は必ずしも破棄されるとは限りません。ただし、ProLoader オブジェクトの子ではなくなります。

子 SWF ファイルを解放する前に、LocalConnection、NetConnection、NetStream、Sound オブジェクトなど、子 SWF ファイルのオブジェクト内のストリームをすべて明示的に閉じておくことをお勧めします。そうしなかった場合は、子 SWF ファイルが解放された後も、子 SWF ファイルのオーディオの再生が続く場合があります。子 SWF ファイルのストリームを閉じるには、unload イベントを受け取る子にイベントリスナーを追加します。親が ProLoader.unload() を呼び出すと、unload イベントが子に対して送出されます。次のコードは、このような処理を行う例を示します。

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

関連する API エレメント