次に、赤い四角形の縦横比(幅を高さで割った比率)をフルスクリーンのステージの幅と高さの縦横比と比較し、矩形(fullScreenSourceRect)を拡大して画面の縦横比に一致するようにします。この結果、赤い四角形がモニタの高さいっぱいに表示され、両側に緑の背景が表示されます。縦横比を一致させなかった場合、緑の背景の代わりにステージの背景色(デフォルトは白)が両側に表示されます。メモ : ブラウザでこの例を試してみてください。パブリッシュし、生成される HTML ファイルをブラウザで開きます。可能な場合、拡大 / 縮小は、ユーザーのコンピュータ上でグラフィックカードやビデオカードを使用してハードウェアで行われます。通常、この方が、ソフトウェアで拡大 / 縮小するよりもすばやくコンテンツが表示されます。標準の "フルスクリーンモードを終了するには、Esc キーを押します" というメッセージに対応するため、矩形のサイズに最小限度が適用されます。このプロパティを設定できるのは、Flash Player がフルスクリーンモードでない場合のみです。このプロパティを正しく使用するには、コード例に示すように、このプロパティを最初に設定し、次に displayState プロパティをフルスクリーンモードに設定します。エンドユーザーが Flash Player の表示設定を使用して、ハードウェアの拡大 / 縮小をオフにすることもできます。この機能はデフォルトでは有効になっています。ハードウェアの拡大 / 縮小機能を活用するには、ステージ全体またはステージの一部をフルスクリーンモードに設定します。0 コードでは、ステージ全体をフルスクリーンモードに設定します。次の例では、ユーザーはステージをクリックすることで、ビデオ再生をフルスクリーンと通常のスクリーンで切り替えることができます。0 以降で実行する場合はハードウェアアクセラレータが使用され、フルスクリーンでの拡大表示時の性能が向上します。ハードウェアの拡大 / 縮小機能を利用してフルスクリーンモードを使用する場合は、次の条件を満たしていなければなりません。0 以降と、これらをサポートするオーサリングツールが必要です。フルスクリーンをサポートするように HTML テンプレートを修正する必要があります。アプリケーションが、FLV ビデオファイルに対するアクセス権を所有している必要があります。ユーザーが、フルスクリーンへのアクセスを許可する必要があります。264 ビデオおよび AAC オーディオのサポートについての説明」を参照してください。また、ビデオオブジェクトを作成し、このビデオオブジェクトに NetStream オブジェクトを追加します。このビデオオブジェクトは表示リストに追加され、ストリームを再生するように設定されます。FLV ビデオファイルにはメタデータまたはキューポイントの情報が含まれていないので、AsyncError イベントが送出されます。このイベントを処理するためにリスナーを設定する必要があります。ここではリスナーを設定しますが、このイベントは無視されます。
ストリームが見つからない場合は、エラーメッセージが表示されます (netStatusHandler() は、ストリームまたは接続に関する何種類もの状態の報告を処理するために使用される場合があることに注意してください)
このメソッドは、ステージ上でマウスがクリックされた場合にイベントを受け取るイベントリスナーを設定します。通常スクリーンの場合、ビデオオブジェクトのサイズは、ビデオストリームのサイズに設定されます。これにより、ソース矩形のビデオが、フルスクリーン領域いっぱいまで拡大されます。システム要件を満たす場合は、マシンのグラフィックハードウェアを使用してフルスクリーンでのビデオのレンダリングのパフォーマンスを向上させます。また、表示状態がフルスクリーンモードに設定されます。
フルスクリーンモードへの切り替え時に発生する可能性のあるセキュリティエラーをキャッチするために、try
通常スクリーンモードに切り替わる前に、ビデオオブジェクトの幅と高さは、保存されている元のビデオオブジェクトの幅と高さに戻ります。また、フルスクリーンモードでビデオオブジェクトに変更が加えられた場合は、それによって幅と高さが決定されます。
フルスクリーンサイズに移行したときに使用されるモニタの幅を返します (直ちに移行する場合)
ユーザーが複数のモニタを持っている場合、使用されるモニタは、そのときに最も多くのステージが表示されているモニタです。メモ : 値を取得してから、フルスクリーンサイズに移行するまでの間に、あるモニタから別のモニタにブラウザを移動する機会がある場合、値が不正になる可能性があります。
これはモニタのピクセル幅であり、Stage
この例では、ステージのサイズの緑の矩形を作成し、その上にボタンとしてアクティブ化する赤い四角形を配置します。次に、赤い四角形の縦横比(幅を高さで割った比率)をフルスクリーンのステージの幅と高さの縦横比と比較し、矩形(fullScreenSourceRect)を拡大して画面の縦横比に一致するようにします。この結果、赤い四角形がモニタの高さいっぱいに表示され、両側に緑の背景が表示されます。縦横比を一致させなかった場合、緑の背景の代わりにステージの背景色(デフォルトは白)が両側に表示されます。メモ : ブラウザでこの例を試してみてください。パブリッシュし、生成される HTML ファイルをブラウザで開きます。
表示オブジェクトの高さを示します (ピクセル単位)
この高さは、表示オブジェクトのコンテンツの境界に基づいて計算されます。次のコードに示すように、この height プロパティを設定すると、それに合わせて scaleY プロパティの値が調整されます。この場合のステージ所有者とはメイン SWF ファイルです。オブジェクトの子に対してマウスが有効かどうかを調べます。オブジェクトが使用可能なマウスの場合、マウスを使用して対話できます。子として追加する Sprite インスタンスは、親インスタンスをターゲットオブジェクトとすることを想定するときに、マウスイベントのターゲットオブジェクトとなる場合があるため、マウスイベントについて予期しない動作を引き起こす可能性があります。親インスタンスが確実にマウスイベントのターゲットオブジェクトになるようにするには、親インスタンスの mouseChildren プロパティを false に設定します。このプロパティを設定すると、イベントは送出されなくなります。この場合のステージ所有者とはメイン SWF ファイルです。window は、ネイティブのオペレーティングシステムのウィンドウを表します。Stage は、そのウィンドウに含まれるコンテンツを表します。このプロパティは、AIR で実行されているコンテンツでのみ有効です。このオブジェクトの子の数を返します。この場合のステージ所有者とはメイン SWF ファイルです。使用できる値は次のとおりです。グラフィックはアンチエイリアス処理されず、ビットマップはスムージングされません。グラフィックは 2 x 2 ピクセルグリッドを使用してアンチエイリアス処理されますが、ビットマップはスムージングされません。この設定は、テキストを含まないムービーに適しています。グラフィックは 4 x 4 ピクセルグリッドを使用してアンチエイリアス処理されます。ビットマップは、ムービーが静的なものである場合は、スムージングされます。グラフィックは 4 × 4 ピクセルグリッドを使用してアンチエイリアス処理され、ビットマップは常にスムージングされます。品質設定が高ければ高いほど、拡大 / 縮小されたビットマップのよりよいレンダリングが生成されます。ただし、品質設定が高くなればなるほど計算上のコストも高くなります。特に、拡大 / 縮小されたビデオをレンダリングするときには、より高い品質の設定を使用するほうがフレームレートを減らすことができます。
別の値に設定しても無視されます (プロパティは変更されません)
メモ : オペレーティングシステムはデバイスフォントを描画します。デバイスフォントは quality プロパティの影響を受けません。この場合のステージ所有者とはメイン SWF ファイルです。使用できる値は次のとおりです。EXACT_FIT — 指定された領域にちょうど収まるようにアプリケーション全体が表示され、元の縦横比は保たれません。歪みが発生し、アプリケーションが拡大または圧縮されて表示されることがあります。SHOW_ALL — 指定された領域内にアプリケーション全体が、アプリケーションの元の縦横比を維持したまま歪まずに表示されます。ただし、アプリケーションの両側に境界枠が表示されることがあります。NO_BORDER — 指定された領域いっぱいにアプリケーション全体が歪まずに表示されます。ただし、アプリケーションの元の縦横比を保つために、ある程度トリミングされることがあります。NO_SCALE — アプリケーションの全体のサイズが固定され、プレーヤーウィンドウのサイズが変更された場合でも、サイズが維持されます。Flash Player のウィンドウがコンテンツよりも小さい場合は、トリミングされることがあります。この場合のステージ所有者とはメイン SWF ファイルです。Flash Player のコンテキストメニューにデフォルトの項目を表示するかどうかを指定します。これがデフォルトです。この場合のステージ所有者とはメイン SWF ファイルです。オブジェクトがフォーカスを持つ場合に強調表示された境界線を表示するかどうかを指定します。この場合のステージ所有者とはメイン SWF ファイルです。現在のステージの高さ (ピクセル数) です。
ユーザーがウィンドウのサイズを変更するときに Stage
イベントリスナーでは、ユーザーがウィンドウのサイズを変更するときに画面コンテンツがどのように調整されるかを制御できます。この場合のステージ所有者とはメイン SWF ファイルです。ステージの現在の幅をピクセル単位で指定します。
ユーザーがウィンドウのサイズを変更するときに Stage
イベントリスナーでは、ユーザーがウィンドウのサイズを変更するときに画面コンテンツがどのように調整されるかを制御できます。この場合のステージ所有者とはメイン SWF ファイルです。オブジェクトの子に対してタブが有効かどうかを調べます。オブジェクトの子に対してタブを有効または無効にします。この場合のステージ所有者とはメイン SWF ファイルです。
表示オブジェクトの幅を示します (ピクセル単位)
この幅は、表示オブジェクトのコンテンツの境界に基づいて計算されます。次のコードに示すように、この width プロパティを設定すると、それに合わせて scaleX プロパティの値が調整されます。この場合のステージ所有者とはメイン SWF ファイルです。
メソッドの詳細
既に異なる表示オブジェクトコンテナを親に持つ子オブジェクトを追加する場合は、もう一方の表示オブジェクトコンテナの子リストからそのオブジェクトが削除されます。この場合のステージ所有者とはメイン SWF ファイルです。子インスタンスは、指定されたインデックス位置に追加されます。例えば、a、b、c というラベルの 3 個の表示オブジェクトをインデックス位置 0、2、1 にそれぞれ配置すると、以下のようになります。既に異なる表示オブジェクトコンテナを親に持つ子オブジェクトを追加する場合は、もう一方の表示オブジェクトコンテナの子リストからそのオブジェクトが削除されます。既にオブジェクトが置かれているインデックス位置を指定すると、その位置にあるオブジェクトとその上に位置するすべてのオブジェクトが、子リスト内で 1 つ上の位置に移動します。この場合のステージ所有者とはメイン SWF ファイルです。イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。イベントリスナーは、特定のタイプのイベント、段階、および優先度に関する表示リスト内のすべてのノードに登録できます。その後、同じリスナーを新しい優先度レベルで再度登録できます。たとえば、最初にリスナーを登録するときに useCapture を true に設定すると、そのリスナーはキャプチャ段階のみでリスニングします。1 つはキャプチャ段階でリスニングするリスナーで、もう 1 つはターゲット段階とバブリング段階でリスニングするリスナーです。ターゲット段階またはバブリング段階のみを対象とするイベントリスナーを登録することはできません。登録時にこれらの段階が組み合わされるのは、バブリングはターゲットノードの祖先にしか適用されないためです。削除しない場合、メモリの問題が発生する可能性があります。ガベージコレクターは参照を有するオブジェクトを削除しないため、登録されているイベントリスナーに関係したオブジェクトはメモリから自動的に除去されません。EventDispatcher インスタンスをコピーしても、それに関連付けられているイベントリスナーはコピーされません。新しく作成したノードにイベントリスナーが必要な場合は、ノードを作成した後に、リスナーを関連付ける必要があります。ただし、EventDispatcher インスタンスを移動した場合は、関連付けられているイベントリスナーも一緒に移動されます。イベントがノードで処理されるときに、イベントリスナーがそのノードに登録中であれば、イベントリスナーは現在の段階ではトリガされません。ただし、バブリング段階など、イベントフローの後の段階でトリガすることができます。イベントがノードで処理されているときにイベントリスナーがノードから削除された場合でも、イベントは現在のアクションによってトリガされます。削除された後は、その後の処理で再び登録されない限り、イベントリスナーは二度と呼び出されません。この関数は、次の例のように、Event オブジェクトを唯一のパラメータとして受け取り、何も返さないものである必要があります。関数の名前は任意に付けられます。useCapture を true に設定すると、リスナーはキャプチャ段階のみでイベントを処理し、ターゲット段階またはバブリング段階では処理しません。優先度は、符号付き 32 ビット整数で指定します。数値が大きくなるほど優先度が高くなります。優先度が n のすべてのリスナーは、優先度が n-1 のリスナーよりも前に処理されます。複数のリスナーに対して同じ優先度が設定されている場合、それらは追加された順番に処理されます。デフォルトの優先度は 0 です。デフォルトである強参照の場合は、リスナーのガベージコレクションが回避されます。弱参照では回避されません。クラスレベルメンバー関数はガベージコレクションの対象外であるため、クラスレベルメンバー関数の useWeakReference は、ガベージコレクションの制限とは無関係に true に設定できます。inner 関数に対する参照を作成(別の変数に保存)した場合、その関数はガベージコレクションされず、永続化された状態のままになります。この場合のステージ所有者とはメイン SWF ファイルです。キーボードフォーカスを objectToFocus で指定されたインタラクティブオブジェクトに設定します。フォーカス方向の概念は、アプリケーション (またはアプリケーションフレームワーク) で定義する必要があります。インタラクティブオブジェクト固有のフォーカス並べ替え設定が存在しません。ただし、並べ替え方針を確立するには、利用可能な他のプロパティを使用することもできます。例えば、インタラクティブオブジェクトをステージ内のその位置によってまたは表示リストで並べ替えることができます。focus プロパティを設定することと同じであり、さらに、フォーカスを設定する元の方向を示すという追加の機能もあります。BOTTOM である場合、読み取り順の最後にある HTML DOM 内のフォーカス可能なオブジェクトにフォーカスが設定されます。TOP である場合、読み取り順の最初にある HTML DOM 内のフォーカス可能なオブジェクトにフォーカスが設定されます。値が NONE である場合は、現在フォーカスがあるエレメントを変更せずに、HTMLLoader オブジェクトにフォーカスが設定されます。ステージ上の任意のエレメントからフォーカスをクリアする場合は null になります。
Error — フォーカスをターゲットに設定できない場合、または方向が有効なタイプではない場合
イベントをイベントフローに送出します。イベントが再度送出されると、イベントのクローンが自動的に作成されます。イベントが送出された後にそのイベントの target プロパティは変更できないため、再送出処理のためにはイベントの新しいコピーを作成する必要があります。この場合のステージ所有者とはメイン SWF ファイルです。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。これにより、EventDispatcher オブジェクトがイベントタイプの処理をイベントフロー階層のどこで変更したかを判断できます。特定のイベントタイプが実際にイベントリスナーをトリガするかどうかを判別するには、willTrigger() () を使用します。この場合のステージ所有者とはメイン SWF ファイルです。例えば、再生ヘッドを新しいフレームに進める場合などです。render イベントによって、実際に表示される直前に表示リストに変更を加えることができます。こうすることで、表示リストへの更新を最後まで遅らせることが可能です。この方法では、画面の更新を不必要に行わなくてよいため、パフォーマンスを向上させることができます。allowDomain() メソッドで許可が与えられているセキュリティドメインの表示オブジェクトに対してのみ、送出されます。focus プロパティがセキュリティ上の理由で null を返すかどうかを決定します。その子に対する参照が存在しない場合、そのオブジェクトはガベージコレクションによって収集されます。ガベージコレクターは、未使用のメモリスペースの再割り当てを行います。変数またはオブジェクトがアクティブに参照されなくなり、任意の場所に保存されていない場合、ガベージコレクターによってメモリ内が探索され、それらに対する参照が存在しなければメモリスペースを占有している変数またはオブジェクトが一掃されます。表示オブジェクトコンテナの既存の子の位置を変更します。これは、子オブジェクトのレイヤーに影響します。例えば、a、b、c というラベルの 3 個の表示オブジェクトをインデックス位置 0、1、2 にそれぞれ配置すると、以下のようになります。setChildIndex() を使用し、既に占有されているインデックス位置を指定した場合、表示オブジェクトの前の位置と新しい位置の間にある位置だけが変化します。その他は変化しません。現在のインデックスよりも小さいインデックスに子を移動すると、その間のすべての子が、それぞれのインデックス参照について 1 増加します。現在のインデックスよりも大きいインデックスに子を移動すると、その間のすべての子が、それぞれのインデックス参照について 1 減少します。たとえば、上記の例の表示オブジェクトコンテナの名前が container である場合、次に示すコードを呼び出すことによって、a および b というラベルが付けられた表示オブジェクトの位置を入れ替えることができます。このコードによって、次に示すようなオブジェクトの配置になります。この場合のステージ所有者とはメイン SWF ファイルです。子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。表示オブジェクトコンテナの他のすべての子オブジェクトは、同じインデックス位置に残されます。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。指定されたタイプのイベントがこの EventDispatcher オブジェクトまたはその子孫に送出されたときに、イベントリスナーがイベントフローの任意の段階でトリガされる場合、このメソッドは true を返します。この場合のステージ所有者とはメイン SWF ファイルです。
イベントの詳細
Stage オブジェクトが、フルスクリーンモードに設定または設定解除されると送出されます。フルスクリーンモードの変更は、ActionScript、ユーザーによるキーボードショートカットの呼び出し、または現在のフォーカスのフルスクリーンウィンドウからの移動によって開始できます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。マウスポインタがステージ領域から離れたときに、Stage オブジェクトによって送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
例 例の使用法
次の例では、StageExample クラスを使用して、ステージのアクティブ化またはサイズ変更に伴い、イベントを送出します。ここでは以下の手順を実行します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
ActionScript はスタックを使用して、スクリプト内で行われた各メソッド呼び出しに関する情報 (例えば、メソッドが使用するローカル変数) を保管します。使用できるスタックスペースの量は、システムによって異なります。その場合、関数に終了条件を追加する必要があります。また、再帰アルゴリズムには適切な終了条件があるものの、単にスタックを使い切ってしまったことを示している可能性もあります。この場合、代わりの方法として、アルゴリズムを反復的に表現するようにしてください。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] 特定のエラーメッセージに関連付けられた参照番号です。Error オブジェクトに関連付けられたメッセージです。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。message プロパティが定義されている場合は、その値を返します。指定されたオブジェクトのプリミティブな値を返します。
コンストラクタの詳細
例 例の使用法
ここでは以下の手順を実行します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
MouseEvent オブジェクトは、マウスイベントが発生するたびにイベントフローに送出されます。通常、マウスイベントは、マウスやトラックボールなど、ポインタを使用したユーザー入力デバイスによって生成されます。ネストされたノードが関係する場合、マウスイベントは、表示リストで確認できる最も深くネストされたノードをターゲットにします。このノードはターゲットノードと呼ばれます。
ターゲットノードの祖先がマウスイベントの通知を受け取るようにするには、祖先ノードで EventDispatcher
継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
[読み取り専用] イベントがバブリングイベントかどうかを示します。[読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。[読み取り専用] マウスダウンイベントがマルチクリックシーケンスの一部かどうかを示します。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ユーザーがマウスホイールを 1 目盛り回すごとにスクロールする行数を示します。[読み取り専用] イベントフローの現在の段階です。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。イベントに関連する表示リストオブジェクトへの参照です。[読み取り専用] グローバルステージ座標を基準とするイベント発生位置の水平座標です。[読み取り専用] グローバルステージ座標を基準とするイベント発生位置の垂直座標です。[読み取り専用] イベントターゲットです。[読み取り専用] イベントのタイプです。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
マウスイベントに関する情報を含む Event オブジェクトを作成します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。指定されたオブジェクトのプリミティブな値を返します。継承されるパブリック定数を隠す。
継承されるパブリック定数を表示
プロパティの詳細
マウスダウンイベントがマルチクリックシーケンスの一部かどうかを示します。シングルクリック、ダブルクリックまたは任意のマルチクリックシーケンスを監視するには、clickCount パラメータを使用します。
マウスが十分に移動した場合、または何らかの理由でマルチクリックシーケンスが妨げられた場合、次の MouseEvent
ユーザーがマウスホイールを 1 目盛り回すごとにスクロールする行数を示します。正の delta 値は上方向へのスクロールを表します。負の値は下方向へのスクロールを表します。一般的な値は 1 ~ 3 の範囲ですが、ホイールの回転が速くなると、delta の値は大きくなります。この設定は、デバイスやオペレーティングシステムによって異なります。通常はユーザーが構成できます。スプライトを基準とするイベント発生位置の水平座標です。このプロパティの使用方法については、MOUSE_MOVE 定数の例を参照してください。スプライトを基準とするイベント発生位置の垂直座標です。このプロパティの使用方法については、MOUSE_MOVE 定数の例を参照してください。イベントに関連する表示リストオブジェクトへの参照です。このプロパティの値は、関連オブジェクトがない場合、または関連オブジェクトはあるがアクセスできないセキュリティサンドボックスの中にある場合の 2 つの状況の場合に、null になる可能性があります。グローバルステージ座標を基準とするイベント発生位置の水平座標です。このプロパティは、localX プロパティが設定されている場合に計算されます。このプロパティの使用方法については、MOUSE_MOVE 定数の例を参照してください。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。このプロパティは、localY プロパティが設定されている場合に計算されます。このプロパティの使用方法については、MOUSE_MOVE 定数の例を参照してください。
コンストラクタの詳細
マウスイベントに関する情報を含む Event オブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメータとして渡されます。有効な値は次のとおりです。正の delta 値は上方向へのスクロールを表します。負の値は下方向へのスクロールを表します。一般的な値は 1 ~ 3 の範囲ですが、ホイールの回転が速くなると、delta の値は大きくなります。シングルクリック、ダブルクリックまたは任意のマルチクリックシーケンスを監視するには、clickCount パラメータを使用します。
メソッドの詳細
MouseEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。MouseEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。マウスのクリック回数です。イベントがマルチクリックシーケンスの一部かどうかを示します。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。マウスのクリック回数です。イベントがマルチクリックシーケンスの一部かどうかを示します。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。マウスのクリック回数です。イベントがマルチクリックシーケンスの一部かどうかを示します。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。マウスのクリック回数です。イベントがマルチクリックシーケンスの一部かどうかを示します。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。次に単純な描画プログラムの例を示します。ユーザーはメインの Sprite オブジェクトまたはそれより小さい矩形の Sprite オブジェクトの上に描画できます。
マウスポインタが移動すると、呼び出されたイベントリスナーメソッドがポインタに追随し、graphics
このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ポインティングデバイスが現在指している表示リストオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ポインティングデバイスが指していた表示リストオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。マウスのクリック回数です。イベントがマルチクリックシーケンスの一部かどうかを示します。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。マウスホイールを 1 目盛り回すごとにスクロールする行数を示します。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。マウスのクリック回数です。イベントがマルチクリックシーケンスの一部かどうかを示します。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。デフォルトの動作をキャンセルすることはできません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。マウスのクリック回数です。イベントがマルチクリックシーケンスの一部かどうかを示します。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ポインティングデバイスが現在指している表示リストオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ポインティングデバイスが指していた表示リストオブジェクトです。スプライトを基準とするイベント発生位置の水平座標です。スプライトを基準とするイベント発生位置の垂直座標です。グローバルステージ座標を基準とするイベント発生位置の水平座標です。グローバルステージ座標を基準とするイベント発生位置の垂直座標です。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。
例 例の使用法
この例では、次の処理を実行します。後で四角形の描画に使用するサイズ(100 × 100 ピクセル)と背景色(オレンジ色)のプロパティを宣言します。これによって、マウスの移動が処理されます。これによって Sprite オブジェクトのドラッグが可能になります。draw() メソッドによって、四角形のサイズとカラーを通常の状態に戻します。このメソッドは、暗い黄色の背景色で四角形を大きく再描画します。これによって、四角形の位置が固定されます。前述したイベントメソッドの中には、ローカル変数 sprite を宣言するものがあります。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
File オブジェクトは、ファイルまたはディレクトリへのパスを表します。既存のファイルまたはディレクトリを指定できます。また、存在しないファイルまたはディレクトリを指定することもできます。例えば、作成するファイルまたはディレクトリへのパスを表すことができます。File クラスには、ファイルシステムについての情報の取得と、操作の実行 (ファイルおよびディレクトリのコピーなど) のためのプロパティとメソッドが用意されています。File オブジェクトを FileStream クラスと組み合わせて使用すると、ファイルの読み取りと書き込みを行うことができます。File クラスには、共通的に使用されるディレクトリの場所を参照するための静的プロパティがあります。それらのプロパティを次に示します。
applicationDirectory - アプリケーションがインストールされている(インストールされるアセットがある場合はそれらも含まれる)読み取り専用ディレクトリ
これらのプロパティには、オペレーティングシステムに応じた意味のある値が設定されています。desktopDirectory プロパティは、プラットフォームに応じた正しいデスクトップディレクトリパスを示すようになっています。異なるプラットフォームでも正しく動作するアプリケーションを作成するために、アプリケーションで他のファイルを使用する際は、これらのプロパティを起点としてください。xml ファイルを参照しています。ファイル参照時にネイティブパスをリテラル表記すると、そのコードは 1 つのプラットフォームでしか動作しないものになります。アプリケーション記憶領域ディレクトリは特に有用性が高く、当該 AIR アプリケーション用に固有の記憶領域ディレクトリを示します。アプリケーションディレクトリは、当該 AIR アプリケーションがインストールされている場所なので、内容を追加したり削除したりしないでください。そのような変更を加えると、AIR アプリケーションが損傷し、アプリケーションの署名が無効になることがあります。AIR のデフォルト設定では、アプリケーションがそれ自体のアプリケーションディレクトリに書き込むことを認めていません。オペレーティングシステムとユーザーアカウントによっては、このディレクトリに対する書き込み許可がない場合があるためです。アプリケーション内部ファイルの書き込み場所としては、アプリケーション記憶領域ディレクトリを使用してください。また、当該アプリケーション以外でユーザーに使用されることを想定したファイル(たとえば、編集した画像やテキストファイルなど)の書き込み場所としては、ドキュメントディレクトリを使用してください。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
[静的] [読み取り専用] インストールされたアプリケーションファイルが格納されているフォルダです。[静的] [読み取り専用] アプリケーションのプライベート記憶領域ディレクトリです。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] ローカルディスク上に存在するファイルの作成日です。[静的] [読み取り専用] ユーザーのデスクトップディレクトリです。[静的] [読み取り専用] ユーザーのドキュメントディレクトリです。[読み取り専用] 参照先のファイルまたはディレクトリが存在するかどうかを示します。[読み取り専用] ファイル名拡張子です。[読み取り専用] ファイルに対して定義されたアイコンを格納している Icon オブジェクトです。[読み取り専用] 参照先がディレクトリであるかどうかを示します。[読み取り専用] 参照先のファイルまたはディレクトリが "非表示" かどうかを示します。値は、参照先のファイルまたはディレクトリが非表示の場合は true、それ以外の場合は false です。[読み取り専用] 参照先のディレクトリがパッケージであるかどうかを示します。[読み取り専用] 参照がシンボリックリンクであるかどうかを示します。[静的] [読み取り専用] ホストオペレーティングシステムで使用される行終了文字です。[読み取り専用] ローカルディスク上に存在するファイルの最終変更日です。[読み取り専用] ローカルディスク上に存在するファイルの名前です。ホストオペレーティングシステムの表現形式に従った完全パスです。[読み取り専用] この File オブジェクトによって参照されているファイルまたはディレクトリを格納しているディレクトリです。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[静的] [読み取り専用] ホストオペレーティングシステムのパスコンポーネントの区切り文字です。[読み取り専用] ローカルディスク上に存在するファイルのサイズ (バイト単位) です。[静的] [読み取り専用] ホストオペレーティングシステムで使用されるデフォルトのエンコーディングです。[読み取り専用] ファイル形式です。[静的] [読み取り専用] ユーザーのディレクトリです。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
File クラスのコンストラクタ関数です。イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。アップロードするファイルを選択できるファイル参照ダイアログボックスを表示します。ディレクトリ選択ダイアログボックスを表示して、ユーザーがディレクトリを選択できるようにします。ファイルを開くダイアログボックスを表示して、ユーザーが開くファイルを選択できるようにします。ファイルを開くダイアログボックスを表示して、ユーザーが開くファイルを 1 つ以上選択できるようにします。ファイルの保存ダイアログボックスを表示して、ユーザーがファイルの保存先を選択できるようにします。この File オブジェクトのコピーを返します。この File オブジェクトで指定された場所にあるファイルまたはディレクトリを、newLocation パラメータで指定された場所にコピーします。この File オブジェクトで指定された場所にあるファイルまたはディレクトリを、destination パラメータで指定された場所にコピーする処理を開始します。指定されたディレクトリおよび必要な親ディレクトリを作成します。[静的] 新しい一時ディレクトリへの参照を返します。[静的] 新しい一時ファイルへの参照を返します。ディレクトリを削除します。ディレクトリを非同期で削除します。ファイルを削除します。ファイルを非同期で削除します。イベントをイベントフローに送出します。リモートサーバーからファイルをダウンロードするためのダイアログボックスを開きます。この File オブジェクトによって表されるディレクトリ内のファイルおよびディレクトリに対応する File オブジェクトの配列を返します。この File オブジェクトによって表されるディレクトリの内容に対応する File オブジェクトの配列を非同期で取得します。[静的] ファイルシステムのルートディレクトリを列挙している File オブジェクトの配列を返します。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。ユーザーが選択したローカルファイルの読み込みを開始します。この File オブジェクトで指定された場所にあるファイルまたはディレクトリを、destination パラメータで指定された場所に移動します。この File オブジェクトで指定された場所にあるファイルまたはディレクトリを、newLocation パラメータで指定された場所に移動する処理を開始します。ファイルまたはディレクトリをごみ箱に移動します。ファイルまたはディレクトリを非同期でごみ箱に移動します。指定されたプロパティが存在し、列挙できるかどうかを示します。path パラメータ(ストリング)に基づいて、この File オブジェクトのパスを基準とした相対的なパスを持つ新しい File オブジェクトを作成します。ローカルファイルシステムにファイルを保存するためのダイアログボックスを開きます。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。ユーザーが選択したファイルをリモートサーバーにアップロードする処理を開始します。ファイルをエンコードせずに URL へのアップロードを開始します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。保留中の非同期処理がキャンセルされると、送出されます。非同期処理が完了すると、送出されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。アップロードに失敗し、HTTP ステータスコードを使用して失敗を記述することができない場合に送出されます。非同期ファイル処理中にエラーが発生すると、送出されます。アップロード処理またはダウンロード処理が開始するときに送出されます。ファイルのアップロード処理中またはダウンロード処理中に定期的に送出されます。操作がセキュリティ制約に違反していると、送出されます。ユーザーがファイルまたはディレクトリ参照ダイアログボックスからファイルまたはディレクトリを選択すると、送出されます。アップロードの正常終了後、サーバーからデータを受信したときに送出されます。
プロパティの詳細
インストールされたアプリケーションファイルが格納されているフォルダです。メモ : app URL スキームを使用するパスを持つファイルまたはディレクトリに書き込むことはできません。また、app URL スキームを使用するパスを持つファイルやフォルダの削除または作成を行うこともできません。セキュリティ上の理由から、アプリケーションディレクトリの内容は変更しないでください。
アプリケーション固有のデータを格納する必要がある場合は、アプリケーションの記憶領域ディレクトリ(File
アプリケーションの記憶領域ディレクトリ内のコンテンツがアプリケーション特権機能(AIR API)にアクセスできるようにする必要がある場合は、サンドボックスブリッジを使用してその機能を公開します。applicationDirectory プロパティを使用すると、異なるプラットフォームでも動作する方法でアプリケーションディレクトリを参照できます。アプリケーションディレクトリを参照するように File オブジェクトを設定する際、nativePath または url プロパティを直接に使用すると、そのパスが有効であるプラットフォーム上でしか動作しないコードになります。アプリケーションのプライベート記憶領域ディレクトリです。それぞれの AIR アプリケーションは、永続的な固有のアプリケーション記憶領域ディレクトリを持っています。このディレクトリは、アプリケーション固有のデータを格納するために利用されます。AIR アプリケーションをアンインストールする場合、アンインストーラではアプリケーション記憶領域ディレクトリに保存されたファイルは削除されません。アプリケーション記憶領域ディレクトリを参照するように File オブジェクトを設定する際、nativePath または url プロパティを直接に使用すると、そのパスが有効であるプラットフォーム上でしか動作しないコードになります。次の例では、アプリケーション記憶領域ディレクトリの "images" サブディレクトリを指している File オブジェクトを作成します。ユーザーのデスクトップディレクトリです。desktopDirectory プロパティを使用すると、異なるプラットフォームでも動作する方法でデスクトップディレクトリを参照できます。デスクトップディレクトリを参照するように File オブジェクトを設定する際、nativePath または url プロパティを直接に使用すると、そのパスが有効であるプラットフォーム上でしか動作しないコードになります。次のコードでは、ユーザーのデスクトップディレクトリに格納されているファイルおよびディレクトリの一覧を出力します。ユーザーのドキュメントディレクトリです。documentsDirectory プロパティを使用すると、異なるプラットフォームでも動作する方法でドキュメントディレクトリを参照できます。ドキュメントディレクトリを参照するように File オブジェクトを設定する際、nativePath または url プロパティを直接に使用すると、そのパスが有効であるプラットフォーム上でしか動作しないコードになります。参照先のファイルまたはディレクトリが存在するかどうかを示します。次のコードでは、一時ファイルを作成し、このファイルを削除します。exists プロパティを使用して、このファイルが存在するかどうかを確認します。ファイルに対して定義されたアイコンを格納している Icon オブジェクトです。次のコードは、icon 配列内で高さが最大のイメージを探し、Bitmap オブジェクトをそのイメージに設定する方法を示しています。参照先がディレクトリであるかどうかを示します。次のコードでは、ユーザーディレクトリ内のファイルおよびディレクトリを参照している File オブジェクトの配列を作成し、isDirectory プロパティを使用して、(ファイルではなく) ディレクトリを参照している File オブジェクトだけを列挙します。参照先のファイルまたはディレクトリが "非表示" かどうかを示します。値は、参照先のファイルまたはディレクトリが非表示の場合は true、それ以外の場合は false です。次のコードでは、ユーザーディレクトリ内のファイルおよびディレクトリを参照している File オブジェクトの配列を作成し、isHidden プロパティを使用して非表示のファイルおよびディレクトリを列挙します。参照先のディレクトリがパッケージであるかどうかを示します。値は、参照先のディレクトリがパッケージである場合は true、それ以外の場合は false です。File クラスでは、パッケージを直接作成することはできません。Macintosh では、ディレクトリをパッケージとして指定して、Finder にディレクトリではなく単一のファイルとして表示することができます。このプロパティは、参照先のディレクトリがパッケージである場合は true、そのファイルがディレクトリでない場合、存在しない場合、またはパッケージでない場合は false に設定されます。他のオペレーティングシステムでは、このプロパティは常に false に設定されます。参照がシンボリックリンクであるかどうかを示します。File クラスでは、シンボリックリンクを直接作成することはできません。シンボリックリンクを使用すると、ファイルが、ディスク上の別のファイルまたはディレクトリを参照できるようになります。エイリアスまたはショートカットは常に (ディレクトリではなく) ファイルとして報告され、エイリアスまたはショートカットの読み取りや書き込みを行っても、そのエイリアスまたはショートカットの参照先である元のファイルまたはディレクトリが影響を受けることはありません。これに対し、シンボリックリンクは、通常、参照先のファイルまたはディレクトリと同じように動作します。シンボリックリンクは、ファイルまたはディレクトリとして報告され、シンボリックリンクの読み取りや書き込みを行うと、シンボリックリンク自体ではなく、参照先のファイルまたはディレクトリが影響を受けます。ただし、シンボリックリンクを削除すると、リンクの対象ではなくリンクが削除されます。ホストオペレーティングシステムで使用される行終了文字です。
次のコードでは、ストリング(str)をテキストファイルに書き込み、File
lineEnding 静的プロパティを使用して、改行文字のすべてのインスタンス(コードでは正規表現 /\n/g で表現)を、ホストオペレーティングシステムで推奨される行終了文字に置き換えます。ホストオペレーティングシステムの表現形式に従った完全パスです。AIR では、スラッシュが適切な円記号 (¥) 文字に自動で変換されます。直接に nativePath プロパティを設定するコードを記述することは可能ですが、特定プラットフォーム上でしか動作しないコードになる可能性があることに注意してください。それよりも、共通的に使用されるディレクトリを次の静的プロパティで参照するほうがはるかに望ましく、どのプラットフォームでも有効なコードを作成できます。コメントは、Windows コンピュータでの結果の例を示しています。この File オブジェクトによって参照されているファイルまたはディレクトリを格納しているディレクトリです。
parent プロパティは、参照先のファイルまたはディレクトリが存在しない場合でも、それを格納しているディレクトリを指す File オブジェクトを返します (そのディレクトリが存在しなくても返します)
") の戻り値と同じです。ただしルートディレクトリの親は null です。次のコードでは、parent プロパティを使用して、一時ファイルを格納しているディレクトリを表示します。ホストオペレーティングシステムのパスコンポーネントの区切り文字です。ストリングリテラル内では、2 つの円記号によってストリング内の単一の円記号を表します。separator 静的プロパティを使用して、パス内のスラッシュ (/) 文字をオペレーティングシステムによって使用される区切り文字に置き換えます。File オブジェクトがシンボリックリンクを参照する場合、spaceAvailable はシンボリックリンクが参照する位置で使用可能な領域を示します。一般的に、ディレクトリまたはファイルで使用可能な領域は、ディレクトリまたはファイルを含むボリュームで使用可能な領域と同じです。ただし、使用可能な領域では、割り当ておよびディレクトリごとの制限が考慮される場合があります。一般に、ボリュームにファイルまたはディレクトリを追加すると、ファイルの実際のサイズまたはディレクトリの内容のサイズよりも大きな領域が必要になります。例えば、オペレーティングシステムでは、インデックス情報を保存するための追加領域が必要になる場合があります。また、必要なディスクセクタにより追加領域が使用される場合があります。さらに、使用可能な領域は動的に変化します。したがって、報告されたすべての領域がファイル記憶域のために割り当てられることを期待するのは不可能です。ホストオペレーティングシステムで使用されるデフォルトのエンコーディングです。完全な一覧については、「サポートする文字セット」を参照してください。
次のコードでは、ファイル(ユーザーのドキュメントディレクトリ内の AIR Test サブディレクトリにある test
この場合、AIR によってストリングが自動的にエンコードされます(例えば、スペースが "%20" に変換されます)
コメントは、Windows コンピュータでの結果の例を示しています。ユーザーのディレクトリです。userDirectory プロパティを使用すると、異なるプラットフォームでも動作する方法でユーザーディレクトリを参照できます。File オブジェクトの nativePath または url プロパティを直接に設定するコードは、そのパスが有効であるプラットフォーム上でしか動作しません。次のコードでは、ユーザーディレクトリのルートレベルに格納されているファイルおよびディレクトリの一覧を出力します。
コンストラクタの詳細
File クラスのコンストラクタ関数です。引数 path を渡してファイルパスを指定することは可能ですが、特定プラットフォーム上でしか動作しないコードになる可能性があることに注意してください。それよりも、共通的に使用されるディレクトリを次の静的プロパティで参照するほうがはるかに望ましく、どのプラットフォームでも有効なコードを作成できます。
例えば、次のコードでは、アプリケーション記憶領域ディレクトリ内の settings
xml ファイルを指すように File オブジェクトをセットアップしています。パスの指定には、URL を使用するか、またはネイティブの(プラットフォーム固有の)パス表記を使用します。URL 表記を使用する場合に有効な path パラメータの値を次に示します。こうすると、プラットフォームやユーザーに依存しない方法でデスクトップディレクトリにアクセスできます。ネイティブのパスを指定する場合、Windows では、円記号文字またはスラッシュ文字をパス区切り文字としてこの引数で使用できます。ネイティブのパス表記を使用する場合に有効な path パラメータの値を次に示します。これにより、プラットフォームやユーザーに依存しない方法でデスクトップディレクトリにアクセスできます。
メソッドの詳細
ディレクトリ選択ダイアログボックスを表示して、ユーザーがディレクトリを選択できるようにします。ユーザーがディレクトリを選択すると、select イベントが送出されます。select:Event — ユーザーがディレクトリを選択して、ディレクトリ選択ダイアログボックスを閉じると、送出されます。ディレクトリを選択すると、選択したディレクトリの内容が trace() の出力に列挙されます。ファイルを開くダイアログボックスを表示して、ユーザーが開くファイルを選択できるようにします。ユーザーがファイルを選択すると、select イベントが送出されます。このパラメータを省略すると、すべてのファイルが表示されます。select:Event — ユーザーがファイルを選択して、ファイルを開くダイアログボックスを閉じると、送出されます。ファイルを選択すると、ファイルのデータがストリングに読み込まれます。ファイルを開くダイアログボックスを表示して、ユーザーが開くファイルを 1 つ以上選択できるようにします。このパラメータを省略すると、すべてのファイルが表示されます。ファイルを選択すると、選択されたファイルのパスが出力されます。ファイルの保存ダイアログボックスを表示して、ユーザーがファイルの保存先を選択できるようにします。ユーザーがファイルを選択すると、select イベントが送出されます。select:Event — ユーザーがファイルを選択して、ファイルの保存ダイアログボックスを閉じると、送出されます。browseForSave() メソッドを使用して、ユーザーがファイルを保存するためのパスを選択できるようにしています。ファイルを選択すると、選択したファイルパスにデータが保存されます。保留中の非同期処理をキャンセルします。File オブジェクトが既存のファイルまたはディレクトリを表している場合は、標準化によって、実際のファイル名またはディレクトリ名と大文字小文字が一致するようにパスが調整されます。File オブジェクトがシンボリックリンクである場合は、標準化によって、参照先のファイルまたはディレクトリが存在するかどうかにかかわらず、リンクが指しているファイルまたはディレクトリに一致するようにパスが調整されます。Linux など大文字と小文字を区別するファイルシステムでは、大文字と小文字の区別のみが異なる複数のファイルが存在する場合、canonicalize() メソッドは、(ファイルシステムによって決められた順序で)最初に見つかったファイルに合わせてパスが調整します。また、Windows では、標準化によって、短いファイル名が長いファイル名に変換されます。次のコードは、canonicalize() メソッドを使用して、大文字小文字が区別された正しいディレクトリ名を確認する方法を示しています。この例を実行する前に、ローカルコンピュータのデスクトップ上に AIR Test という名前のディレクトリを作成してください。この例では、C: ドライブのルートに AIR Test という名前のディレクトリが存在し、このディレクトリに対してシステムが短い名前 AIR~1 を割り当てていることを前提としています。この File オブジェクトのコピーを返します。イベント登録はコピーされません。注意 : このメソッドでは、ファイル自体がコピーされるのではありません。この File オブジェクトで指定された場所にあるファイルまたはディレクトリを、newLocation パラメータで指定された場所にコピーします。コピー処理によって、可能な場合には必要な親ディレクトリが作成されます。この File オブジェクトは、結果として得られる(コピーされる)ファイルまたはディレクトリを表すものであり、それを格納しているディレクトリへのパスを表すものではありません。true の場合は、同じ名前のファイルまたはディレクトリが存在すると、このファイルまたはディレクトリが上書きされます。Windows では、開いているファイルや、開いているファイルが格納されているディレクトリをコピーすることはできません。次のコードは、copyTo() メソッドを使用してファイルをコピーする方法を示しています。
このコードを実行する前に、ローカルコンピュータのドキュメントディレクトリ内の AIR Test サブディレクトリに test1
txt というファイルを作成しておく必要があります。
結果として得られるコピーファイルには test2
txt という名前の既存のファイルがあった場合はこのファイルが上書きされます。次のコードは、copyTo() メソッドを使用してファイルをコピーする方法を示しています。
このコードを実行する前に、ローカルコンピュータのホームディレクトリ内の AIR Test サブディレクトリに test1
txt というファイルを作成しておく必要があります。
結果として得られるコピーファイルには、test2
txt という名前が付けられます。try ステートメントと catch ステートメントは、エラーへの対処方法を示しています。この File オブジェクトで指定された場所にあるファイルまたはディレクトリを、destination パラメータで指定された場所にコピーする処理を開始します。コピー処理によって、可能な場合には必要な親ディレクトリが作成されます。この File オブジェクトは、結果として得られる(コピーされる)ファイルまたはディレクトリを表すものであり、それを格納しているディレクトリへのパスを表すものではありません。true の場合は、同じ名前のファイルまたはディレクトリが存在すると、このファイルまたはディレクトリが上書きされます。Windows では、開いているファイルや、開いているファイルが格納されているディレクトリをコピーすることはできません。
このコードを実行する前に、ローカルコンピュータのドキュメントディレクトリ内の AIR Test サブディレクトリに test1
txt というファイルを作成しておく必要があります。
結果として得られるコピーファイルには test2
txt という名前の既存のファイルがあった場合はこのファイルが上書きされます。指定されたディレクトリおよび必要な親ディレクトリを作成します。ディレクトリがすでに存在する場合は、何も行われません。
次のコードでは、デスクトップ上の test
txt という名前のファイルをドキュメントディレクトリ内の AIR Test サブディレクトリに移動します。新しい一時ディレクトリへの参照を返します。これは、システムの一時ディレクトリパスに作成される新しいディレクトリです。このメソッドを使用すると、新しい一意のディレクトリを指定できます。システムに照会してディレクトリが新規かつ一意であることを確認する必要はありません。一時ディレクトリは自動では削除されないため、アプリケーションを閉じる前に削除することを検討してください。このコードを実行するたびに、新しい (一意の) ファイルが作成されます。新しい一時ファイルへの参照を返します。これは、システムの一時ディレクトリパスに作成される新しいファイルです。このメソッドを使用すると、新しい一意のファイルを指定できます。システムに照会してファイルが新規かつ一意であることを確認する必要はありません。一時ファイルは自動では削除されないため、アプリケーションを閉じる前に削除することを検討してください。このコードを実行するたびに、新しい (一意の) ファイルが作成されます。ディレクトリを削除します。このファイルが実際にディレクトリに対するシンボリックリンクの場合は、ディレクトリではなくこのリンクが削除されます。false の場合、ディレクトリにファイルまたはサブディレクトリが格納されていると、このメソッドの呼び出しで例外がスローされます。Windows では、開いているファイルのあるディレクトリを削除することはできません。ディレクトリを非同期で削除します。このファイルが実際にディレクトリに対するシンボリックリンクの場合は、ディレクトリではなくこのリンクが削除されます。false の場合、ディレクトリにファイルまたはサブディレクトリが格納されていると、ioError イベントが送出されます。Windows では、開いているファイルのあるディレクトリを削除することはできません。ファイルを削除します。このファイルが実際にシンボリックリンクの場合は、ターゲットファイルではなくこのリンクが削除されます。Windows では、現在開いているファイルを削除することはできません。次のコードでは、一時ファイルを作成し、次に deleteFile() メソッドを呼び出して一時ファイルを削除します。ファイルを非同期で削除します。このファイルが実際にシンボリックリンクの場合は、ターゲットファイルではなくこのリンクが削除されます。Windows では、現在開いているファイルを削除することはできません。この File オブジェクトによって表されるディレクトリ内のファイルおよびディレクトリに対応する File オブジェクトの配列を返します。このメソッドは、サブディレクトリの内容は調べません。この File オブジェクトによって表されるディレクトリの内容に対応する File オブジェクトの配列を非同期で取得します。相対パスは、2 つ目の (パラメータ) 参照を見つけるためにこの参照に追加 (解決) されるコンポーネントのリストです。相対パスは、区切り文字 "/" を使用して返されます。必要に応じて、相対パスに "" 参照を含めることができますが、そのようなパスが明確なボリューム境界を越えることはありません。" コンポーネントを使用できるかどうかを指定します。ファイルシステムのルートディレクトリを列挙している File オブジェクトの配列を返します。ディスクが挿入されていない CD または DVD ドライブなどの空のドライブは、この配列に含まれません。次のコードでは、ルートディレクトリの一覧を出力します。この File オブジェクトで指定された場所にあるファイルまたはディレクトリを、destination パラメータで指定された場所に移動します。ファイルの名前を変更するには、そのファイルのディレクトリにある別の名前のファイルへのパスを指すように destination パラメータを設定します。移動処理によって、可能な場合には必要な親ディレクトリが作成されます。このオブジェクトは、結果として得られる(移動される)ファイルまたはディレクトリを表すものであり、それを格納しているディレクトリへのパスを表すものではありません。true の場合は、同じ名前のファイルまたはディレクトリが存在すると、このファイルまたはディレクトリが上書きされます。Windows では、開いているファイルや、開いているファイルが格納されているディレクトリを移動することはできません。次のコードは、moveTo() メソッドを使用してファイルの名前を変更する方法を示しています。ソースと宛先の File オブジェクトはどちらも同じディレクトリ(ユーザーのドキュメントディレクトリ内の Apollo Test サブディレクトリ)を指しているため、この moveTo() メソッドでは、ファイルが新しいディレクトリに移動されのではなく、ファイルの名前が変更されます。
このコードを実行する前に、ローカルコンピュータのドキュメントディレクトリ内の AIR Test サブディレクトリに test1
txt というファイルを作成しておく必要があります。txt という名前の既存のファイルがあった場合はこのファイルが上書きされます。次のコードは、moveTo() メソッドを使用してファイルを移動する方法を示しています。
このコードを実行する前に、ローカルコンピュータのホームディレクトリ内の AIR Test サブディレクトリに test1
txt というファイルを作成しておく必要があります。try ステートメントと catch ステートメントは、エラーへの対処方法を示しています。この File オブジェクトで指定された場所にあるファイルまたはディレクトリを、newLocation パラメータで指定された場所に移動する処理を開始します。ファイルの名前を変更するには、そのファイルのディレクトリにある別の名前のファイルへのパスを指すように destination パラメータを設定します。移動処理によって、可能な場合には必要な親ディレクトリが作成されます。このオブジェクトは、結果として得られる(移動される)ファイルまたはディレクトリを表すものであり、それを格納しているディレクトリへのパスを表すものではありません。true の場合は、同じ名前のファイルまたはディレクトリが存在すると、このファイルまたはディレクトリが上書きされます。Windows では、開いているファイルや、開いているファイルが格納されているディレクトリを移動することはできません。次のコードは、moveToAsync() メソッドを使用してファイルの名前を変更する方法を示しています。ソースと宛先の File オブジェクトはどちらも同じディレクトリ(ユーザーのドキュメントディレクトリ内の Apollo Test サブディレクトリ)を指しているため、この moveToAsync() メソッドでは、ファイルが新しいディレクトリに移動されのではなく、ファイルの名前が変更されます。txt というファイルを作成しておく必要があります。txt という名前の既存のファイルがあった場合はこのファイルが上書きされます。ファイルまたはディレクトリをごみ箱に移動します。IOError — 操作がオペレーティングシステムによって許可されなかったか、ファイルまたはディレクトリが存在しません。Windows では、開いているファイルや、現在開いているファイルが格納されているディレクトリを移動することはできません。ファイルまたはディレクトリを非同期でごみ箱に移動します。Windows では、開いているファイルや、現在開いているファイルが格納されているディレクトリを移動することはできません。path パラメータ (ストリング) に基づいて、この File オブジェクトのパスを基準とした相対的なパスを持つ新しい File オブジェクトを作成します。path パラメータとして相対パスまたは絶対パスを使用できます。相対パスを指定した場合、指定した path は File オブジェクトのパスの末尾に「追加」されます。" をpath で使用すると、File オブジェクトの子ではないパスが結果として返されることがあります。結果として得られる参照は、実際のファイルシステムの場所を参照していなくても構いません。絶対ファイル参照を指定した場合、メソッドはそのパスを示す File オブジェクトを返します。絶対ファイル参照では、ユーザーのオペレーティングシステムの有効なネイティブパス構文(Windows の "C:\\test" など)を使用する必要があります。結果として得られたパスは、すべて次のように正規化されます。"エレメントは無視されます。"エレメントは、その親エントリを使用します。" 参照が、ファイルシステムのルートまたはアプリケーションの永続的な記憶領域のルートに到達するまでにそのノードを通過しない場合は、無視されます。パス区切り文字には常にスラッシュ(/)を使用してください。Windows では円記号(\)も使用できますが、これを使用すると、アプリケーションが他のプラットフォームで動作しなくなる可能性があります。Linux では、ファイル名およびディレクトリ名の大文字と小文字は区別されます。
イベントの詳細
保留中の非同期処理がキャンセルされると、送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。操作をキャンセルするオブジェクトへの参照です。非同期処理が完了すると、送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ロードが完了したネットワークオブジェクトです。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。ファイルまたはディレクトリを表す File オブジェクトの配列が見つかりました。非同期ファイル処理中にエラーが発生すると、送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
特定のエラーに関連付けられた参照番号です(AIR のみ)
入出力エラーが発生したネットワークオブジェクトです。エラーメッセージとして表示されるテキストです。操作がセキュリティ制約に違反していると、送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。セキュリティエラーを報告するネットワークオブジェクトです。エラーメッセージとして表示されるテキストです。ユーザーがファイルまたはディレクトリ参照ダイアログボックスからファイルまたはディレクトリを選択すると、送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。アイテムが選択されたオブジェクトです。false は、キャンセルするデフォルトの動作がないことを示します。ファイルを表す File オブジェクトの配列が選択されました。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
畳み込みでは、入力イメージ内のピクセルを、隣接するピクセルと組み合わせて、イメージを作成します。畳み込みを使用すると、ぼかし、エッジ検出、シャープ、エンボス、ベベルなど、幅広いイメージ効果を実現できます。フィルタの使用方法は、フィルタの適用先オブジェクトによって異なります。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルタを取り消すことができます。結果として得られるイメージが最大サイズを超える場合、フィルタは適用されません。例えば、フィルタが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルタがオフになります。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
代替カラーのアルファ透明度の値です。マトリックス変換の結果に加算するバイアス量です。イメージをクランプする必要があるかどうかを示します。ソースイメージの外にあるピクセルを置換する 16 進数のカラー値です。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。マトリックス変換中に使用する除数です。マトリックス変換に使用する値の配列です。マトリックスの x 次元 (マトリックスの列数) です。マトリックスの y 次元 (マトリックスの行数) です。アルファチャネルがフィルタ効果なしで維持されるかどうか、またはカラーチャネルだけではなくアルファチャネルにも畳み込みフィルタが適用されるかどうかを示します。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
代替カラーのアルファ透明度の値です。デフォルトは 0 です。25 を指定すると、透明度の値として 25% が設定されます。マトリックス変換の結果に加算するバイアス量です。バイアスにより各チャンネルのカラー値が増えるため、暗い色は明るくなります。デフォルト値は 0 です。イメージをクランプする必要があるかどうかを示します。true の場合、ソースイメージの外にあるピクセルに対して、入力イメージの各エッジのカラー値を複製するという方法で、必要に応じて境界に沿って入力イメージを拡張します。その幅と高さは largeBox の幅と高さに指定されているため、ソースビットマップは描画領域より小さくなります。ソースイメージの外にあるピクセルを置換する 16 進数のカラー値です。これはアルファ成分なしの RGB 値です。デフォルト値は 0 です。マトリックス変換中に使用する除数です。デフォルト値は 1 です。序数がすべてのマトリックス値の合計と等しい場合は、結果全体のカラー強度が均等化されます。値 0 は無視され、代わりにデフォルト値が使用されます。マトリックス変換に使用する値の配列です。マトリックスの畳み込みは、n x m マトリックスに基づいています。入力イメージ内の特定のピクセルを隣接するピクセルと組み合わせるという方法で、新しいピクセル値を生成します。結果として得られるピクセルは、対応するソースピクセルおよび連接するピクセルにマトリックスを適用することで算出されます。3 × 3 のマトリックス畳み込みの場合、独立するカラーチャネルごとに次の式を使用します。高速な畳み込み操作が可能となる基準は次のとおりです。すべてのフィルタ項の合計の絶対値が 127 を超えていない。
いずれかのフィルタ項が負である場合、除数は 2
フィルタ項がすべて正である場合、除数は 1
バイアスは整数である。メモ:パラメータなしのコンストラクタを使用して ConvolutionFilter インスタンスを作成する場合は、値をマトリックスプロパティに割り当てる順序がフィルタの動作に影響します。マトリックスの x 次元 (マトリックスの列数) です。デフォルト値は 0 です。マトリックスの y 次元 (マトリックスの行数) です。デフォルト値は 0 です。アルファチャンネルをフィルタ効果なしで維持するかどうか、またはカラーチャンネルだけではなく、アルファチャンネルにも畳み込みフィルタを適用するかどうかを示します。false である場合は、アルファチャンネルを含め、すべてのチャンネルに畳み込みを適用します。true である場合は、畳み込みをカラーチャンネルだけに適用します。
コンストラクタの詳細
デフォルト値は 0 です。0) — マトリックス変換中に使用する除数です。デフォルト値は 1 です。除数がすべてのマトリックス値の合計と等しい場合は、結果全体のカラー強度が均等化されます。値 0 は無視され、代わりにデフォルト値が使用されます。0) — マトリックス変換の結果に加算するバイアスです。デフォルト値は 0 です。true である場合は、畳み込みをカラーチャンネルだけに適用します。0) — 代替カラーのアルファです。
メソッドの詳細
このフィルタオブジェクトのコピーを返します。
例 例の使用法
次の例では、さまざまな畳み込みフィルタをイメージファイルに適用します。buildChild() を呼び出すたびに、最初のインスタンスにはフィルタを適用せず、異なる畳み込みフィルタをそれ以降のインスタンスに適用する関数を引数として取ります。メモ:幅が約 80 ピクセル以内のイメージを使用すると、最良の結果が得られます。イメージファイルの名前と場所は url プロパティに渡す値に一致する必要があります。jpg" という名前のイメージファイルを指します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
フィルタの使用方法は、フィルタの適用先オブジェクトによって異なります。表示オブジェクトにフィルタを適用する場合は、表示オブジェクトの filters プロパティを使用します。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルタを取り消すことができます。このフィルタでは次の式を使用します。y))から取得します。フィルタで使用するマップイメージは、ステージの拡大 / 縮小率に一致するように拡大 / 縮小されます。オブジェクト自体を拡大 / 縮小する場合には拡大 / 縮小されません。このフィルタはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。0 以外に設定されている場合)、フィルタ効果は拡大 / 縮小されません。フィルタが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
範囲外置き換えの場合に使用するアルファ透明度値を指定します。範囲外置き換えの場合に使用する色を指定します。x の結果を変位させる場合にどのカラーチャネルをマップイメージで使用するかを指定します。y の結果を変位させる場合にどのカラーチャネルをマップイメージで使用するかを指定します。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。マップイメージの左上隅を基準としたターゲット表示オブジェクトの左上隅のオフセットが含まれる値です。フィルタのモードです。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。マップ計算の x 置き換え結果を拡大 / 縮小する場合に使用する乗数です。マップ計算の y 置き換え結果を拡大 / 縮小する場合に使用する乗数です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
範囲外置き換えの場合に使用するアルファ透明度値を指定します。0 に正規化した値を指定します。25 を指定すると、透明度の値として 25% が設定されます。デフォルト値は 0 です。COLOR に設定されている場合は、このプロパティを使用します。範囲外置き換えの場合に使用する色を指定します。
置き換えの有効範囲は 0
この値は、16 進数形式です。COLOR に設定されている場合は、このプロパティを使用します。x の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。y の結果を変位させる場合にどのカラーチャンネルをマップイメージで使用するかを指定します。マップイメージの左上隅を基準としたターゲット表示オブジェクトの左上隅のオフセットが含まれる値です。フィルタのモードです。WRAP - 置き換え値をソースイメージの反対側で折り返します。CLAMP - 置き換え値をソースイメージのエッジに固定します。IGNORE - 置き換え値が範囲外である場合、その置き換えを無視して、ソースピクセルを使用します。マップ計算の x 置き換え結果を拡大 / 縮小する場合に使用する乗数です。マップ計算の y 置き換え結果を拡大 / 縮小する場合に使用する乗数です。
コンストラクタの詳細
0) — マップ計算の x 置き換え結果を拡大 / 縮小する場合に使用する乗数です。0) — マップ計算の y 置き換え結果を拡大 / 縮小する場合に使用する乗数です。
置き換えの有効範囲は 0
0) — 範囲外置き換えの場合に使用するアルファ値を指定します。0 に正規化した値を指定します。25 を指定すると、透明度の値として 25% が設定されます。
メソッドの詳細
このフィルタオブジェクトのコピーを返します。
例 例の使用法
この例に対する一般的なワークフローは、次のようになります。このクラスは背景色、テキストフィールドラベル、およびさまざまな関数で使用するサイズおよびオフセットの変数を定義します。コンストラクタ関数は draw() メソッドを呼び出します。このメソッドは、Graphics クラスのメソッドを使用して放射状グラデーション塗りの四角形を描画します。このメソッドは labelText の値を表示するテキストフィールドを作成して、表示リストに追加します。このメソッドは以下の処理を行います。フィルタオブジェクトの filter という名前の変数を作成します。mapBitmap オブジェクトは、他の変数と共に、新しい置き換えマップフィルタを定義します。bitmapData に基づいた新しいビットマップを作成し、ステージに追加します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
GlowFilter クラスを使用すると、表示オブジェクトにグロー効果を適用できます。グローのスタイルには複数のオプションがあり、内側グロー、外側グロー、ノックアウトモードなどがあります。グローフィルタは、ドロップシャドウの distance プロパティと angle プロパティを 0 に設定したドロップシャドウフィルタと同様です。フィルタの使用方法は、フィルタの適用先オブジェクトによって異なります。オブジェクトの filters プロパティを設定しても、オブジェクトは変更されません。filters プロパティをクリアすることにより、フィルタを取り消すことができます。このフィルタはステージの拡大 / 縮小に対応していますが、通常の拡大 / 縮小、回転、傾斜には対応していません。0 以外に設定されている場合) 、フィルタは拡大 / 縮小されません。フィルタが拡大 / 縮小されるのは、ユーザーがステージをズームインする場合のみです。結果として得られるイメージが最大サイズを超える場合、フィルタは適用されません。例えば、フィルタが適用されたサイズの大きいムービークリップをズームインするとき、結果として得られるイメージが最大サイズを超える場合は、フィルタがオフになります。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
カラーのアルファ透明度の値です。水平方向のぼかし量です。垂直方向のぼかし量です。グローのカラーを表します。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。グローが内側グローであるかどうかを示します。オブジェクトにノックアウト効果を適用するかどうかを指定します。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。フィルタを適用する回数です。インプリントの強さまたは広がりです。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
カラーのアルファ透明度の値です。25 を指定すると、透明度の値として 25% が設定されます。デフォルト値は 1 です。
水平方向のぼかし量
デフォルト値は 6 です。
垂直方向のぼかし量
デフォルト値は 6 です。グローのカラーを表します。グローが内側グローであるかどうかを示します。true の場合は、内側グローであることを示します。デフォルトは false (外側グロー) で、オブジェクトの外側のエッジにあるグローを示します。オブジェクトにノックアウト効果を適用するかどうかを指定します。true を指定すると、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
フィルタを適用する回数
フィルタに設定された値が小さいほど、速くレンダリングできます。多くのアプリケーションでは、quality の値は低、中、または高で十分です。最大 15 までの値を使用してさまざまな効果を出すことができますが、値が大きくなるほどレンダリング速度が低下します。この方法を実行すると、より高速にレンダリングされます。インプリントの強さまたは広がりです。値が大きいほど、濃い色がインプリントされるので、グローと背景との間のコントラストが強くなります。デフォルト値は 2 です。
コンストラクタの詳細
0) — カラーのアルファ透明度の値です。25 を指定すると、透明度の値として 25% が設定されます。値が大きいほど、濃い色がインプリントされるので、グローと背景との間のコントラストが強くなります。詳細については、quality プロパティの説明を参照してください。true の場合は、内側グローであることを示します。値 false は外側グロー (オブジェクトの外周にあるグロー) を示します。true を指定すると、オブジェクトの塗りが透明になり、ドキュメントの背景色が表示されます。
メソッドの詳細
このフィルタオブジェクトのコピーを返します。
例 例の使用法
次の例では、四角形を描画してぼかしフィルタを適用します。この例に対する一般的なワークフローは、次のようになります。必要なクラスを読み込みます。コンストラクタ関数を作成します。この関数は、次の処理を行います。これでフィルタが定義されます。これにより、myFilters で見つかったすべてのフィルタが適用されます。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Matrix クラスは、2 つの座標空間の間におけるポイントのマッピング方法を決定する変換マトリックス(変換行列)を表します。これらの変換機能には、平行移動(x と y の位置変更)、回転、拡大 / 縮小、傾斜などが含まれます。このような変換をアフィン変換と言います。アフィン変換では、変換中に線分の直線性が保たれるため、平行線は平行のままになります。Matrix オブジェクトは、次のようないくつかのメソッドのパラメータとしても使用します。変換行列オブジェクトは、次の内容を備えた 3 × 3 の行列です。従来の変換マトリックスでは、u、v および w プロパティによって特別な機能を提供します。この行列の有効値は次のとおりです。専用メソッドを使用して、これらのうち 3 つの変換機能を設定できます。以下の表に示します。
マトリックスの値
イメージを右に tx ピクセル、下に ty ピクセル移動します。各ピクセルの位置を sxx 軸方向に 倍、syy 軸方向に 倍することで、イメージの大きさを変更します。イメージを角度 q(単位はラジアン)だけ回転します。
傾斜または変形
プロパティ b と c に設定する必要があります。x 軸または y 軸に平行な方向にイメージをスライドします。Matrix オブジェクトの b プロパティは、y 軸に沿った傾斜角度のタンジェントを表し、Matrix オブジェクトの c プロパティは、x 軸に沿った傾斜角度のタンジェントを表します。効果的に複数の変換を組み合わせることができるように、変換関数はそれぞれ現在の行列プロパティを変更します。これを行うには、対象の表示オブジェクトの transform プロパティを使用して行列を適用する前に、複数の変換関数を呼び出します。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
イメージを拡大 / 縮小または回転するときに x 軸方向のピクセルの配置に影響を与える値です。イメージを回転または傾斜させるときに y 軸方向のピクセルの配置に影響を与える値です。イメージを回転または傾斜させるときに x 軸方向のピクセルの配置に影響を与える値です。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。イメージを拡大 / 縮小または回転するときに y 軸方向のピクセルの配置に影響を与える値です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。x 軸方向に各ポイントを平行移動する距離です。y 軸方向に各ポイントを平行移動する距離です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
指定されたパラメータで新しい Matrix オブジェクトを作成します。新しい Matrix オブジェクトとして、このマトリックスのクローンを返します。含まれるオブジェクトはまったく同じコピーになります。マトリックスを現在のマトリックスと連結して、2 つのマトリックスの図形効果を効果的に組み合わせます。拡大 / 縮小、回転、平行移動に関するパラメータなどがあります。変換前の座標空間内のポイントが指定されると、そのポイントの変換後の座標を返します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。各行列プロパティを null 変換になる値に設定します。元のマトリックスの逆の変換を実行します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。Matrix オブジェクトに回転変換を適用します。行列に拡大 / 縮小の変換を適用します。ループ処理に対するダイナミックプロパティの可用性を設定します。Matrix オブジェクトのプロパティを列挙するテキスト値を返します。Matrix オブジェクトで表現される図形変換を、指定されたポイントに適用した結果を返します。行列を x 軸と y 軸に沿って、dx パラメータと dy パラメータで指定された量だけ平行移動します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
イメージを拡大 / 縮小または回転するときに x 軸方向のピクセルの配置に影響を与える値です。イメージを回転または傾斜させるときに y 軸方向のピクセルの配置に影響を与える値です。イメージを回転または傾斜させるときに x 軸方向のピクセルの配置に影響を与える値です。イメージを拡大 / 縮小または回転するときに y 軸方向のピクセルの配置に影響を与える値です。x 軸方向に各ポイントを平行移動する距離です。y 軸方向に各ポイントを平行移動する距離です。
コンストラクタの詳細
指定されたパラメータで新しい Matrix オブジェクトを作成します。行列表記の場合、プロパティは次のようになります。new Matrix() コンストラクタにパラメータが指定されない場合は、次の値で構成される単位マトリックス(単位行列)を作成します。行列表記の場合、単位行列は次のようになります。同じコンストラクタにパラメータを渡して matrix_2 を作成しています。
メソッドの詳細
新しい Matrix オブジェクトとして、このマトリックスのクローンを返します。含まれるオブジェクトはまったく同じコピーになります。行列を現在の行列と連結して、2 つの行列の図形効果を効果的に組み合わせます。数学的に言うと、2 つのマトリックスを連結することは、マトリックスの乗算を使って組み合わせることと同じです。
たとえば、マトリックス m1 はオブジェクトの大きさを 4 倍にし、マトリックス m2 はオブジェクトを 1
PI/2 ラジアン回転するマトリックスに変換します。このメソッドは、連結された行列でソース行列を置き換えます。2 つのソース行列をどちらも変更せずに 2 つの行列を連結する場合は、クラスの例に示されているように、まず clone() メソッドを使用して、ソース行列をコピーします。拡大 / 縮小、回転、平行移動に関するパラメータなどがあります。マトリックスに適用する際に、これらのパラメータに基づいて、マトリックスの値を設定します。例えば、次の性質を持つグラデーションを作成するとします。
グラデーションの結果
この値は、width パラメータの半分だけオフセットされます。この値は、height パラメータの半分だけオフセットされます。変換前の座標空間内のポイントが指定されると、そのポイントの変換後の座標を返します。各行列プロパティを null 変換になる値に設定します。単位行列を適用して変形したオブジェクトは、元のオブジェクトと同じになります。行列表記の場合、単位行列は次のようになります。元の行列の逆の変形を実行します。逆マトリックスをオブジェクトに適用して、元のマトリックスの適用時に実行された変換を取り消すことができます。Matrix オブジェクトに回転変換を適用します。行列表記の場合、これは現在の行列を次の行列と連結することと同じです。行列に拡大 / 縮小の変換を適用します。行列表記の場合、これは現在の行列を次の行列と連結することと同じです。Matrix オブジェクトのプロパティを列挙するテキスト値を返します。Matrix オブジェクトで表現される図形変換を、指定されたポイントに適用した結果を返します。x 軸と y 軸に沿って、dx パラメータと dy パラメータで指定された量だけ行列を平行移動します。
例 例の使用法
次の例では、MatrixExample クラスを使用してグラデーション塗りの大きな正方形を作成する方法を示します。これを行うには、以下の手順を実行します。3 つの変数を設定してグラデーションボックスを塗る方法を制御します。colors:グラデーションカラーを赤から青の範囲で設定します。ratios:カラーの分布を、赤と青が共に等しくなるように設定します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Point オブジェクトは 2 次元の座標系の位置を表します。x は水平方向の軸を表し、y は垂直方向の軸を表します。次のコードでは、位置 (0,0) に配置されるポイントを作成します。次のクラスのメソッドとプロパティで Point オブジェクトを使用します。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] (0,0) からこのポイントまでの線のセグメントの長さです。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。ポイントの水平座標です。ポイントの垂直座標です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
新しいポイントを作成します。このポイントの座標に他のポイントの座標を加算して、新しいポイントを作成します。この Point オブジェクトのコピーを作成します。2 つのポイントが等しいかどうかを判別します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。[静的] 2 つの指定されたポイント間にあるポイントを判別します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。(0,0) と現在のポイント間の線のセグメントを設定された長さに拡大 / 縮小します。Point オブジェクトを指定された量だけオフセットします。[静的] 極座標ペアを直交点座標に変換します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。このポイントの座標から他のポイントの座標を減算して、新しいポイントを作成します。x 座標の値と y 座標の値を格納するストリングを返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
(0,0) からこのポイントまでの線のセグメントの長さです。
ポイントの水平座標
デフォルト値は 0 です。
ポイントの垂直座標
デフォルト値は 0 です。
コンストラクタの詳細
新しいポイントを作成します。パラメータを渡さずにこのメソッドを呼び出すと、(0,0) にポイントが作成されます。
メソッドの詳細
このポイントの座標に他のポイントの座標を加算して、新しいポイントを作成します。この Point オブジェクトのコピーを作成します。2 つのポイントが等しいかどうかを判別します。x 値と y 値が同じ場合、2 つのポイントは等しいことになります。2 つの指定されたポイント間にあるポイントを判別します。パラメータ f はパラメータ pt1 および pt2 で指定された 2 つの端点に対する、新しい補間ポイントの場所を決定します。0 に近づくほど、補間ポイントは最初のポイント(パラメータ pt1)に近づきます。パラメータ f の値が 0 に近づくほど、補間ポイントは 番目のポイント(パラメータ pt22)に近づきます。pt1 と pt2 間の線に沿って新しいポイントがある位置を示します。(0,0) と現在のポイント間の線のセグメントを設定された長さに拡大 / 縮小します。Point オブジェクトを指定された量だけオフセットします。極座標ペアを直交点座標に変換します。このポイントの座標から他のポイントの座標を減算して、新しいポイントを作成します。x 座標の値と y 座標の値を格納するストリングを返します。
例 例の使用法
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Sound クラスを使用すると、アプリケーション内のサウンドを処理することができます。Sound クラスを使用すると、Sound オブジェクトの作成や、外部 MP3 ファイルのオブジェクトへのロードと再生ができます。また、サウンドストリームを閉じたり、サウンド関連のデータ (ストリームおよび ID3 メタデータのバイト数などの情報) にアクセスしたりできます。5 以降では、このクラスを使用して、動的に生成されたサウンドを処理することもできます。この場合、sampleData イベントハンドラに割り当てた関数が Sound オブジェクトでサウンドデータのポーリングに使用されます。サウンドは、サウンドデータに設定された ByteArray オブジェクトから取得され、再生されます。抽出したサウンドデータは、ストリームに書き戻して再生する前に処理できます。0 とは異なります。0 では、取得して階層内に配置した Sound オブジェクトのプロパティを制御することができません。このクラスを使用するときは、次のセキュリティモデルを考慮してください。呼び出し元ファイルがネットワークサンドボックスにあり、ロードするサウンドファイルがローカルにある場合、サウンドのロードおよび再生はできません。呼び出し元 ファイルがローカルにあり、リモートサウンドのロードおよび再生を試行する場合、デフォルトでは、サウンドのロードや再生ができません。この種のアクセスを許可するには、ユーザーが明示的な許可を与える必要があります。サウンドを処理する特定の操作が制限されます。ロードされたサウンドのデータには、クロスドメインポリシーファイルを実装していない限り、別のドメインに存在するファイルからアクセスできないことに注意してください。ただし、Adobe AIR では、application セキュリティサンドボックス内のコンテンツ(AIR アプリケーションと共にインストールされたコンテンツ)は、これらのセキュリティ制限による制限を受けません。セキュリティ情報について詳しくは、以下を参照してください。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
[読み取り専用] この Sound オブジェクトで現在利用できるデータのバイト数を返します。[読み取り専用] この Sound オブジェクトの合計バイト数を返します。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] MP3 ファイルの一部であるメタデータに対するアクセスを提供します。[読み取り専用] 外部 MP3 ファイルのバッファリング状態を返します。[読み取り専用] 現在のサウンドの継続時間を示すミリ秒数です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[読み取り専用] サウンドがロードされる URL です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。ストリームを閉じて、データのダウンロードを中止します。イベントをイベントフローに送出します。Sound オブジェクトから生のサウンドデータを抽出します。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。データが正常にロードされたときに送出されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。入出力エラーが発生して読み込み操作が失敗したときに送出されます。読み込み操作が開始したときに送出されます。ロード処理の実行中にデータを受信したときに送出されます。
プロパティの詳細
この Sound オブジェクトで現在利用できるデータのバイト数を返します。このプロパティは、通常、外部から読み込むファイルのみに使用します。この Sound オブジェクトの合計バイト数を返します。MP3 ファイルの一部であるメタデータに対するアクセスを提供します。MP3 サウンドファイルには、ファイルについてのメタデータを示す ID3 タグを含めることができます。load() メソッドを使用してロードした MP3 サウンドに ID3 タグが含まれる場合は、これらのプロパティを調べることができます。4) のタグをサポートしています。0 タグと、そのタグが表すコンテンツタイプを示します。TIME などの形式を使用してこれらのタグにアクセスできます。0 プロパティ名または ActionScript プロパティ名のいずれかを使用してアクセスできるタグを示します。次の表は、サポートされているものの、Sound クラスに定義済みのプロパティが存在しない ID3 タグを示します。
内容の属するグループの説明
タイトル/曲名/内容の説明
サブタイトル/説明の追加情報
オリジナルのアルバム/ムービー/ショーのタイトル
オリジナルのファイル名
オリジナルの作詞家/文書作成者
オリジナルのアーティスト/演奏者
オリジナルのリリース年
ファイルの所有者/ライセンス保持者
主な演奏者/ソリスト
翻訳、リミックス、その他の修正を行った人
セット中の位置
トラック番号/セット内の位置
インターネットラジオ局の名前
インターネットラジオ局の所有者
エンコードに使用したソフトウェア/ハードウェアと設定
このプロパティを使用するときは、Flash Player セキュリティモデルを考慮してください。Sound オブジェクトの id3 プロパティは、サウンドファイルと同じセキュリティサンドボックス内にある SWF ファイルで常に使用できます。他のサンドボックス内のファイルには、セキュリティチェックがあります。ポリシーファイルが存在しており、そのファイルでロード元 SWF ファイルのドメインからのアクセスが許可されている場合、Sound オブジェクトの id3 プロパティにアクセスできます。それ以外の場合は、アクセスできません。ただし、Adobe AIR では、application セキュリティサンドボックス内のコンテンツ(AIR アプリケーションと共にインストールされたコンテンツ)は、これらのセキュリティ制限による制限を受けません。セキュリティ情報について詳しくは、以下を参照してください。次の例では、サウンドファイルから ID3 情報を読み取り、テキストフィールドに表示します。コンストラクタで、サウンドファイルがロードされますが、再生するように設定されていません。ここでは、ファイルが SWF ディレクトリにあると想定しています。ロードされるサウンドファイルの ID3 タグを読み取るために、システムにアクセス権がある必要があります。
ファイル内に 情報が存在し、プログラムに読み取ることが許可されている場合、Event
ID3 イベントが送出され、サウンドファイルの id3id3 プロパティに値が設定されます。テキストフィールドがインスタンス化され、ID3 タグの一覧が表示されます。0 タグが繰り返し処理され、テキストフィールドの内容に名前と値が追加されます。4 がサポートされます。0 タグだけが表示されます。ただし、以前のバージョンからのデータも曲の id3 プロパティに保存され、ID3 info クラスのプロパティを使用してアクセスできます。0 のタグはファイルに末尾にあります。0 タグはファイルの先頭にあります。以前のバージョンと最新バージョンのタグがファイルの同じ場所にある場合があります。
ファイルが、ファイルの先頭と末尾にあるバージョン 1
最初にバージョン 2
0 が読み込まれ、次にバージョン 1
0 が読み込まれます。などと記述して、ID3 info プロパティを介して情報にアクセスできます。TITS プロパティによって曲名が取得されます。この例にはエラー処理の記述がないため、ID3 の内容が長い場合、結果が表示可能領域を超える場合があります。外部 MP3 ファイルのバッファリング状態を返します。値が true の場合、再生は現在中断され、オブジェクトがデータを待機しています。現在のサウンドの継続時間を示すミリ秒数です。サウンドがロードされる URL です。url プロパティには、サウンドがロードされる元の最終的な絶対 URL が格納されます。また、元の 要求が HTTP サーバーによってリダイレクトされると、urlurl プロパティの値はサウンドファイルが実際にダウンロードされた URL を示します。
コンストラクタの詳細
呼び出さないと、ストリームがロードされません。別のサウンドファイルをロードするには、新しい Sound オブジェクトを作成します。これは、バッファ時間 (Sound オブジェクトのバッファに保持する MP3 データのミリ秒単位の最小数) を定義でき、また、アプリケーションがサウンドをロードする前にクロスドメインポリシーを確認すべきかどうかを指定できます。
メソッドの詳細
ストリームを閉じて、データのダウンロードを中止します。close() メソッドの呼び出し後は、ストリームからデータを読み込みません。IOError — ストリームを閉じることができないか、またはストリームが開いていません。
次の例では、ユーザーが「停止」ボタンをクリックしたときに、Sound
close() メソッドが呼び出され、サウンドがストリーミングを停止します。コンストラクタで、[開始] ボタンおよび [停止] ボタン用のテキストフィールドが作成されます。このメソッドは、サウンドファイルの開始と停止を処理します。ネットワーク接続によって、またはユーザーが [停止] ボタンを押したときにファイルの多くがロードされてしまっているため、サウンドファイルの再生を停止するのにしばらく時間がかかる場合があります。
ストリームを閉じている間に発生する可能性のある IO エラーをキャッチするために、try
例えば、サウンドがローカルディレクトリからロードされ、ストリームされない場合、エラー 2029 がキャッチされ、"この URLStream オブジェクトには開いているストリームがありません" というメッセージが表示されます。Sound オブジェクトから生のサウンドデータを抽出します。このメソッドは、動的に生成されたオーディオを処理する場合に、別の Sound オブジェクトの sampleData イベントに割り当てられた関数を使って使用するように設計されています。つまり、このメソッドを使用して Sound オブジェクトからサウンドデータを抽出できます。次に、別の Sound オブジェクトによってダイナミックオーディオのストリーミングに使用されているバイト配列に、そのデータを書き込むことができます。オーディオデータは、対象のバイト配列に、現在の位置から配置されます。サンプルには、2 つの 32 ビット浮動小数点数を意味する左チャンネルと右チャンネルがあります。upOctave() メソッドは、ソースのオーディオデータに基づいて、変更されたオーディオデータのバイト配列を返します。ソースデータのオーディオサンプルを 1 つおきにスキップすることにより、1 オクターブ高いオーディオが返されます。mp3 ファイルを SWF ファイルと同じディレクトリに追加してください。別のサウンドファイルをロードするには、新しい Sound オブジェクトを作成します。このメソッドを使用するときは、次のセキュリティモデルを考慮してください。
呼び出し元 ファイルが ローカルファイルシステムのサンドボックスにあり、サウンドがネットワーク上のサンドボックスにある場合、Sound
信頼できるローカルのサンドボックスまたはネットワーク接続したローカルのサンドボックスからアクセスするには、URL ポリシーファイルを使用して Web サイトで許可する必要があります。一般的な予約ポートには接続できません。0 のプログラミング』)の「ネットワーク API の制限」を参照してください。POST 処理は、マウスのクリックやキーの押下などのユーザーが開始したアクションに応答して実行する必要があります。POST 処理がクロスドメインである (POST ターゲットが、POST 要求を送信中の SWF ファイルと同じサーバー上にない) 場合は、クロスドメインアクセスを許可する URL ポリシーファイルをターゲットサーバーが提供する必要があります。シンタックスが有効でない場合は、アップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。Adobe AIR では、application セキュリティサンドボックス内のコンテンツ(AIR アプリケーションと共にインストールされたコンテンツ)は、これらのセキュリティ制限による制限を受けません。セキュリティ情報について詳しくは、以下を参照してください。これは、バッファ時間 (Sound オブジェクトのバッファに保持する MP3 データのミリ秒単位の最小数) を定義でき、また、アプリケーションがサウンドをロードする前にクロスドメインポリシーを確認すべきかどうかを指定できます。IOError — このロードの失敗原因であるネットワークエラーです。0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。次の例では、サウンドファイルのロードの進行状況を表示します。コンストラクタで、アドビ システムズ社のポッドキャストであるサウンドファイルの位置を識別する URLRequest オブジェクトが作成されます。
ファイルのロード中に発生する可能性のあるエラーをキャッチするために、ファイルが try
IO エラーが発生すると、errorHandler() メソッドも呼び出され、進行状況をレポートするテキストフィールドにエラーメッセージが書き出されます。PROGRESS イベントがロードの進行状況を計算するタイマとして使用されます。次に、これらの値がテキストフィールドに表示されます。ファイルが小さいか、キャッシュされているか、ローカルディレクトリにある場合、進行状況が目立たない場合があります。このオブジェクトにアクセスして、サウンドの停止、およびボリュームの監視を行います。ボリュームの制御、パン、バランスの設定を行うには、サウンドチャンネルに割り当てられた SoundTransform オブジェクトにアクセスします。このメソッドは、サウンドカードがない場合、または使用できるサウンドチャンネルが不足した場合は null を返します。一度に使用できるサウンドチャンネルの最大数は 32 チャネルです。次の例では、ファイルがロードされると、グラフィックバーを使用するユーザーは、サウンドファイルの開始位置 (開始時点) を選択できます。load() メソッドを呼び出して、サウンドデータのロードを開始します。play() メソッドを呼び出して、十分なデータがロードされ次第、サウンドの再生を開始します。テキストフィールドにはユーザーに対する説明が表示されます。ユーザーが再生を開始しようとしているサウンドの内容が確実にロードされているようにするため、ファイルのロードが完了してから bar Sprite オブジェクトが作成され、表示されます。
ファイルが正常にロードされると、Event
インタラクティブ機能をサポートするために、Shape オブジェクトの代わりに Sprite オブジェクトが使用されます。localX を使用して、ユーザーがファイルの開始を指定した場所が特定されます。バーは 100 ピクセルであり、x 座標の 100 ピクセルの位置から開始するので、位置の割合(パーセント)は簡単に特定されます。また、ファイルがロードされるため、サウンドファイルの length プロパティに、完全なファイルの長さ (ミリ秒単位) が設定されます。サウンドファイルの長さと行内の位置を使用して、サウンドファイルの開始位置が特定されます。サウンドの再生を停止した後は、選択した開始位置からサウンドファイルの再生が再開されます。次の例では、ユーザーがボタンをシングルクリックするか、ダブルクリックするかに応じて、サウンドを 1 回または 2 回再生します。インタラクティブ機能をサポートするために、Shape オブジェクトの代わりに Sprite オブジェクトが使用されます。ここでは、サウンドファイルが SWF ファイルと同じディレクトリにあると想定しています。この例には、エラー処理コードはありません。マウスのシングルクリックとダブルクリックに応答するために、2 つのイベントリスナーが設定されます。ユーザーがボタンをシングルクリックすると、clickHandler() メソッドが呼び出され、サウンドが再生されます。これは、サウンドが開始時点に 1 回ループバックされ、再び再生されることを意味します。1 つ目の引数(開始時点)は 0 に設定されます。これは、ファイルが最初から再生されることを意味します。次の例では、サウンドファイルのロードと再生の進行状況を表示します。
コンストラクタで、ファイルのロード中に発生する可能性のあるエラーをキャッチするために、ファイルが try
このイベントは、再生の進行状況を表示するタイミング制御メカニズムとして使用されます。再生されるサウンドデータの割合 (パーセント) は、サウンドチャンネルの position プロパティの値をサウンドデータの長さで除算することで算出される場合があります。ただし、サウンドデータが完全にロードされていない場合、サウンドオブジェクトの length プロパティは、現在ロードされているサウンドデータのみのサイズを表示します。ファイルが小さいか、キャッシュされているか、ローカルディレクトリにある場合、ロードの進行状況が目立たない場合があります。この値は、デフォルトで 1000 ミリ秒であり、リセットできます。
イベントの詳細
データが正常に読み込まれたときに送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ロードが完了したネットワークオブジェクトです。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。target は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、currentTarget プロパティを使用します。入出力エラーが発生して読み込み操作が失敗したときに送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
特定のエラーに関連付けられた参照番号です(AIR のみ)
入出力エラーが発生したネットワークオブジェクトです。エラーメッセージとして表示されるテキストです。読み込み操作が開始したときに送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。接続をオープンしたネットワークオブジェクトです。ロード処理の実行中にデータを受信したときに送出されます。このイベントには、次のプロパティがあります。リスナーがイベントを処理しているときにロードされたアイテム数またはバイト数です。ロードプロセスが成功した場合に最終的にロードされるアイテムまたはバイトの総数です。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。進行状況をレポートする オブジェクトです。次の例は、単純な正弦波を再生します。
例 例の使用法
次の例では、MP3 ファイルを開い再生すると発生するサウンドイベントに関する情報が表示されます。mp3 ファイルを SWF ファイルと同じディレクトリに配置します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
FileReference クラスには、ユーザーのコンピュータとサーバーとの間でファイルをアップロードおよびダウンロードするための手段があります。オペレーティングシステムのダイアログボックスを使用して、アップロードするファイルや、ダウンロード先の場所をユーザーが選択できるようにします。ダウンロード処理の実行中、name プロパティの値は select イベントが送出されたときに設定されます。これ以外のすべてのプロパティの値は、complete イベントが送出されたときに設定されます。browse() メソッドはオペレーティングシステムのダイアログボックスを開いて、ユーザーがアップロード対象のファイルを選択できるようにします。browse() メソッドを使用すると、ユーザーは単一のファイルを選択できます。browse() メソッドを使用すると、複数のファイルを選択できます。download() メソッドは、ファイルの保存先をユーザーに指定させ、リモート URL からのダウンロードを開始します。ダイアログボックスに表示されるデフォルトの場所は、最後に参照されたフォルダ (その場所を決定できる場合) またはデスクトップです。これらのクラスを使って、転送ファイルを読み込んだり、転送ファイルに書き込んだりすることはできません。これらのクラスを使用しても、アップロードまたはダウンロードを開始した SWF ファイルが、アップロードファイルやダウンロードファイル、またはユーザーのディスクのファイルの場所にアクセスすることはできません。認証が必要なサーバーでは、Flash® Player ブラウザプラグインを使ってファイルをダウンロードできますが、すべての Player でのアップロード、およびスタンドアローンまたは外部 Player でのダウンロードは失敗します。FileReference イベントをリッスンして、処理が正常に終了したかどうかを確認して、エラー処理を行います。Flash Player で実行されるコンテンツの場合、またはアプリケーションセキュリティサンドボックス外の、Adobe AIR で実行されるコンテンツの場合、アップロード操作およびダウンロード操作では、それ自身のドメイン内および URL ポリシーファイルが指定するドメイン内のファイルにのみアクセスできます。アップロードまたはダウンロードを開始しているコンテンツが、ファイルサーバーと同じドメインに属していない場合、ファイルサーバーにポリシーファイルを配置します。以前のバージョンの Flash Player については、同時に複数の操作を実行しても、この制限には影響されません。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] ローカルディスク上に存在するファイルの作成日です。[読み取り専用] ファイル名拡張子です。[読み取り専用] ローカルディスク上に存在するファイルの最終変更日です。[読み取り専用] ローカルディスク上に存在するファイルの名前です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[読み取り専用] ローカルディスク上に存在するファイルのサイズ (バイト単位) です。[読み取り専用] ファイル形式です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。アップロードするファイルを選択できるファイル参照ダイアログボックスを表示します。この FileReference オブジェクトで進行中のアップロード処理またはダウンロード処理を取り消します。イベントをイベントフローに送出します。リモートサーバーからファイルをダウンロードするためのダイアログボックスを開きます。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。ユーザーが選択したローカルファイルの読み込みを開始します。指定されたプロパティが存在し、列挙できるかどうかを示します。ローカルファイルシステムにファイルを保存するためのダイアログボックスを開きます。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。ユーザーが選択したファイルをリモートサーバーにアップロードする処理を開始します。ファイルをエンコードせずに URL へのアップロードを開始します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。ユーザーがアップロードまたはダウンロードするファイルをファイル参照ダイアログボックスからキャンセルしたときに送出されます。ダウンロードが完了、またはアップロードで HTTP ステータスコード 200 が生成された場合に送出されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。アップロードに失敗し、HTTP ステータスコードを使用して失敗を記述することができない場合に送出されます。アップロードまたはダウンロードが失敗したときに送出されます。アップロード処理またはダウンロード処理が開始するときに送出されます。ファイルのアップロード処理中またはダウンロード処理中に定期的に送出されます。download() メソッドの呼び出しによって、サーバーにファイルをアップロードするか、呼び出し元のセキュリティサンドボックスの外部にあるサーバーからファイルを取得しようとしたときに送出されます。ユーザーがアップロードするファイルまたはダウンロードするファイルをファイル参照ダイアログボックスから選択したときに、送出されます。アップロードの正常終了後、サーバーからデータを受信したときに送出されます。
プロパティの詳細
ローカルディスク上に存在するファイルの作成日です。オブジェクトに値が設定されていない場合に、このプロパティの値を取得する呼び出しが行われると null が返されます。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。IOError — ファイル情報にアクセスできない場合、I/O エラーを示すメッセージとともにエラーがスローされます。FileReference オブジェクトに値が設定されていない場合に、このプロパティの値を取得する呼び出しが行われると null を返します。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。IOError — ファイルを開くことや読み取ることができない場合、またはファイルへのアクセスで同様のエラーが発生した場合、例外がスローされ、ファイルの I/O エラーを知らせるメッセージが送信されます。ファイル名拡張子です。ファイルの拡張子は、名前内の最後のドット ("
") の後の部分です (ドットは含みません)
ファイル名内にドットがない場合、拡張子は null です。メモ : ファイルのタイプを確認するには、extension プロパティを使用する必要があります。これらのプロパティは、Mac OS の古いバージョンに適用されます。ローカルディスク上に存在するファイルの最終変更日です。FileReference オブジェクトに値が設定されていない場合に、このプロパティの値を取得する呼び出しが行われると null を返します。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。IOError — ファイル情報にアクセスできない場合、I/O エラーを示すメッセージとともにエラーがスローされます。ローカルディスク上に存在するファイルの名前です。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。ローカルディスク上に存在するファイルのサイズ (バイト単位) です。0 の初期のバージョンでは、size プロパティは、4 GB 程度までのサイズのファイルをサポートする uint オブジェクトとして定義されていました。現在では、それよりも大きいファイルをサポートする Number オブジェクトとして実装されています。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。IOError — ファイルを開くこと、読み取ることができない場合、またはファイルへのアクセスで同様のエラーが発生した場合、例外がスローされ、ファイルの I/O エラーを知らせるメッセージが送信されます。ファイル形式です。)の後の部分)でファイル形式を示します。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。
コンストラクタの詳細
設定されると、FileReference オブジェクトはユーザーのローカルディスク上のファイルを表します。
メソッドの詳細
アップロードするファイルを選択できるファイル参照ダイアログボックスを表示します。このダイアログボックスは、オペレーティングシステムのネイティブのダイアログボックスです。ユーザーは、例えば Windows の UNC パスを使用して、ローカルコンピュータまたは他のコンピュータからファイルを選択できます。このメソッドを呼び出して、ユーザーが正常にファイルを選択すると、この FileReference オブジェクトのプロパティにそのファイルのプロパティが設定されます。browse() メソッドが呼び出されるたびに、FileReference オブジェクトのプロパティは、ダイアログボックスでユーザーが選択したファイルにリセットされます。これは、一度に 1 つのダイアログボックスしか呼び出せないからです。どのファイルをダイアログボックスに表示するかを決定するために、typeFilter パラメータを使用できます。以前のバージョンの Flash Player については、同時に複数の操作を実行しても、この制限には影響されません。このパラメータを省略すると、すべてのファイルが表示されます。cancel:Event — ユーザーがファイルアップロードの参照ウィンドウをキャンセルすると、送出されます。ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
cfg ファイルの設定により、この操作が禁止されている場合
Error — マウスイベントやキー入力イベントなどのユーザー操作に応じてメソッドが呼び出されない場合
この FileReference オブジェクトで進行中のアップロード処理またはダウンロード処理を取り消します。このメソッドを呼び出しても cancel イベントは送出されません。このイベントは、ユーザーがファイルアップロードまたはダウンロードのダイアログボックスを閉じて処理をキャンセルした場合にのみ送出されます。リモートサーバーからファイルをダウンロードするためのダイアログボックスを開きます。Flash Player ではアップロードまたはダウンロードできるファイルのサイズに制限はありませんが、このプレーヤーが正式にサポートしているアップロードまたはダウンロードのサイズは最大 100 MB です。download() メソッドは、まず、オペレーティングシステムのダイアログボックスを表示して、ユーザーにファイル名を入力してもらった後、ファイル名の保存先となるローカルコンピュータ上の場所を選択してもらいます。ユーザーが保存場所を選択し、[保存] などをクリックして、ファイルをローカルに保存することを確認すると、リモートサーバーからのダウンロードが開始します。リスナーは、ダウンロードが進行中なのか、成功したのか、失敗したのかを示すイベントを受け取ります。これらの関数は呼び出された後、ファイル転送が完了する前に返されます。さらに、FileReference オブジェクトがスコープ外に移動した場合、そのオブジェクトに対して完了していないアップロードまたはダウンロードは、スコープから離れた時点でキャンセルされます。アップロードまたはダウンロードの続行を期待できる限りは、FileReference オブジェクトがスコープ内にあることを確認してください。ファイルが正常にダウンロードされると、FileReference オブジェクトのプロパティにローカルファイルのプロパティが設定されます。ダウンロードが成功した場合、complete イベントが送出されます。これは、一度に 1 つのダイアログボックスしか呼び出せないからです。このメソッドは、どのファイルタイプのダウンロードにも対応しており、HTTP と HTTPS のいずれも使用できます。一般的な予約ポートに接続することはできません。0 のプログラミング』)の「ネットワーク API の制限」を参照してください。メモ : サーバーでユーザー認証が必要な場合、ブラウザ内で実行される、つまり、ブラウザプラグインまたは ActiveX コントロールを使用する SWF ファイルでのみ、認証用のユーザー名とパスワードをユーザーが入力できるダイアログボックスを表示できます。ただし、それはダウンロードの場合のみです。プラグインまたは ActiveX コントロールを使用するアップロードの場合、または、スタンドアローンまたは外部 Player を使用するアップロードとダウンロードの場合、ファイル転送は失敗します。呼び出し元 SWF ファイルが信頼されないコードとしてローカルのサンドボックスに置かれている場合、ロード操作は実行できません。デフォルトの動作では、サンドボックス間のアクセスは拒否されます。URL ポリシーファイルを追加することによって、Web サイトでリソースにアクセスできるようになります。ただし、Adobe AIR では、application セキュリティサンドボックス内のコンテンツ(AIR アプリケーションと共にインストールされたコンテンツ)は、これらのセキュリティ制限による制限を受けません。セキュリティ情報について詳しくは、以下を参照してください。以前のバージョンの Flash Player については、同時に複数の操作を実行しても、この制限には影響されません。このパラメータが null の場合、例外がスローされます。一部のブラウザでは、URL ストリングの長さに制限があるものがあります。長さが 256 文字を超える場合、一部のブラウザまたはサーバーでは失敗する場合があります。を含めないでください。このパラメータを省略すると、リモート URL のファイル名が構文解析されて、デフォルトとして使用されます。select:Event — ダウンロードするファイルをユーザーがダイアログボックスから選択すると、送出されます。
ファイルの読み込み中または転送中に入出力エラーが発生した場合
Flash Player のスタンドアローンバージョンまたは外部バージョンで実行される SWF コンテンツが、認証が必要なサーバーからファイルをダウンロードしようとした場合
ダウンロードする際、スタンドアローンまたは外部 Player には、ユーザーがパスワードを入力する手段がありません。認証が必要なサーバーに対して、これらの Player 内の SWF がファイルをダウンロードしようとすると、ダウンロードは失敗します。
1) 他のブラウズセッションが進行中の場合
ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
2) request に渡された値に、無効なパスまたはプロトコルが含まれている場合
3) ダウンロードするファイルの名前に禁止文字が含まれている場合
cfg ファイルの設定により、この操作が禁止されている場合
この問題を回避するには、この SWF ファイルを、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類します。この例外がスローされると、ローカルファイルのセキュリティ制限が原因でアクセスできないファイル名および URL を示すメッセージが送信されます。0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。
Error — マウスイベントやキー入力イベントなどのユーザー操作に応じてメソッドが呼び出されない場合
次の例で、download イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。ユーザーが選択したローカルファイルの読み込みを開始します。Flash Player ではアップロード、ダウンロード、ロードまたは保存できるファイルのサイズに制限はありませんが、正式にサポートしているサイズは最大 100 MB です。リスナーは、読み込み処理が進行中なのか、成功したのか、失敗したのかを示すイベントを受け取ります。FileReferenceList オブジェクトを使用すると、ユーザーがロードするファイルを複数選択できるようになりますが、ファイルは 1 つずつロードする必要があります。save() 関数はノンブロッキング処理を行います。これらの関数は呼び出された後、ファイル転送が完了する前に返されます。さらに、FileReference オブジェクトがスコープ外に移動した場合、そのオブジェクトに対して完了していないトランザクションは、スコープから離れた時点でキャンセルされます。アップロード、ダウンロード、読み込みまたは保存の続行を期待できる限りは、FileReference オブジェクトがスコープ内にあることを確認してください。次のセキュリティに関する考慮事項が適用されます。呼び出し元 SWF ファイルが信頼されないコードとしてローカルのサンドボックスに置かれている場合、ロード操作は実行できません。デフォルトの動作では、サンドボックス間のアクセスは拒否されます。クロスドメインポリシーファイルを追加することによって、Web サイトでリソースにアクセスできるようになります。ただし、これらの考慮事項はアプリケーションサンドボックス内の AIR コンテンツには適用されません。複数の操作を実行すると、アプリケーションでランタイムエラー(コード 2174)が発生します。5 にのみ適用されます。ioError:IOErrorEvent — アプリケーションによるファイルの読み込み中または書き込み中に入出力エラーによりロードが失敗した場合に呼び出されます。ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
cfg ファイルの設定により、この操作が禁止されている場合
MemoryError — このエラーは、アプリケーションがファイルにメモリを割り当てることができない場合に発生することがあります。ファイルが大きすぎるか、または使用可能なメモリが少なすぎる可能性があります。ローカルファイルシステムにファイルを保存するためのダイアログボックスを開きます。Flash Player ではアップロード、ダウンロード、読み込みまたは保存できるファイルのサイズに制限はありませんが、このプレーヤーが正式にサポートしているサイズは最大 100 MB です。save() メソッドは、まず、オペレーティングシステムのダイアログボックスを表示して、ユーザーにファイル名を入力してもらった後、ファイル名の保存先となるローカルコンピュータ上の場所を選択してもらいます。ユーザーが保存場所を選択し、「保存」などをクリックして、ファイルをローカルに保存することを確認すると、保存処理が開始されます。リスナーは、保存処理が進行中なのか、成功したのか、失敗したのかを示すイベントを受け取ります。save() 関数はノンブロッキング処理を行います。これらの関数は呼び出された後、ファイル転送が完了する前に返されます。さらに、FileReference オブジェクトがスコープ外に移動した場合、そのオブジェクトに対して完了していないトランザクションは、スコープから離れた時点でキャンセルされます。アップロード、ダウンロード、読み込みまたは保存の続行を期待できる限りは、FileReference オブジェクトがスコープ内にあることを確認してください。ファイルが正常に保存されると、FileReference オブジェクトのプロパティにローカルファイルのプロパティが設定されます。これは、一度に 1 つのダイアログボックスしか呼び出せないからです。Flash Player では、このメソッドの呼び出しは、マウスのクリックやキー入力などのユーザーイベントに応じてイベントハンドラで呼び出した場合にのみ成功します。この制限は、アプリケーションサンドボックス内の AIR コンテンツには適用されません。データは複数の形式のうちのいずれかになり、以下のように適切に処理されます。値が XML の場合は、XML 形式でテキストファイルに書き込まれます。形式はすべて保持されます。値が ByteArray オブジェクトの場合は、データファイルにそのまま書き込まれます。値が上記のいずれでもない場合、save() メソッドはオブジェクトの toString() メソッドを呼び出し、データをストリングに変換して、データをテキストファイルとして保存します。を含めないでください。select:Event — ダウンロードするファイルをユーザーがダイアログボックスから選択すると、送出されます。
1)他のブラウズセッションが進行中の場合
ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
2)ダウンロードするファイルの名前に禁止文字が含まれている場合
cfg ファイルの設定により、この操作が禁止されている場合
Error — マウスイベントやキー入力イベントなどのユーザー操作に応じてメソッドが呼び出されない場合
ファイルが大きすぎるか、または使用可能なメモリが少なすぎる可能性があります。ユーザーが選択したファイルをリモートサーバーにアップロードする処理を開始します。Flash Player ではアップロードまたはダウンロードできるファイルのサイズに制限はありませんが、このプレーヤーが正式にサポートしているアップロードまたはダウンロードのサイズは最大 100 MB です。リスナーは、アップロードが進行中なのか、成功したのか、失敗したのかを示すイベントを受け取ります。FileReferenceList オブジェクトを使用すると、ユーザーが複数のファイルを選択してアップロードすることが可能になりますが、ファイルは 1 つずつアップロードする必要があります。これらの関数は呼び出された後、ファイル転送が完了する前に返されます。さらに、FileReference オブジェクトがスコープ外に移動した場合、そのオブジェクトに対して完了していないアップロードまたはダウンロードは、スコープから離れた時点でキャンセルされます。アップロードまたはダウンロードの続行を期待できる限りは、FileReference オブジェクトがスコープ内にあることを確認してください。ファイルは、url パラメータに渡された URL にアップロードされます。URL は、アップロードを許可するよう設定されたサーバースクリプトである必要があります。アップロードを処理するサーバースクリプトは、次のエレメントを持つ POST リクエストを想定しています。
ファイルのバイナリコンテンツ
一般的な予約ポートに接続することはできません。0 のプログラミング』)の「ネットワーク API の制限」を参照してください。メモ : サーバーでユーザー認証が必要な場合、ブラウザ内で実行される、つまり、ブラウザプラグインまたは ActiveX コントロールを使用する SWF ファイルでのみ、認証用のユーザー名とパスワードをユーザーが入力できるダイアログボックスを表示できます。ただし、それはダウンロードの場合のみです。プラグインまたは ActiveX コントロールを使用するアップロードの場合、または、スタンドアローンまたは外部 Player を使用するアップロードとダウンロードの場合、ファイル転送は失敗します。呼び出し元 SWF ファイルが信頼されないコードとしてローカルのサンドボックスに置かれている場合、ロード操作は実行できません。デフォルトの動作では、サンドボックス間のアクセスは拒否されます。URL ポリシーファイルを追加することによって、Web サイトでリソースにアクセスできるようになります。ただし、Adobe AIR では、application セキュリティサンドボックス内のコンテンツ(AIR アプリケーションと共にインストールされたコンテンツ)は、これらのセキュリティ制限による制限を受けません。詳細については、次のトピックを参照してください。以前のバージョンの Flash Player については、同時に複数の操作を実行しても、この制限には影響されません。一部のブラウザでは、URL ストリングの長さに制限があるものがあります。長さが 256 文字を超える場合、一部のブラウザまたはサーバーでは失敗する場合があります。このパラメータが null の場合、例外がスローされます。このテストアップロードでは、実際のファイルのアップロードが成功するかどうか、サーバー認証が必要な場合はそれが成功するかどうかがチェックされます。テストアップロードは、Windows プレーヤーでのみ使用できます。
ユーザー名とパスワードなど、認証が必要なサーバーにファイルをアップロードしようとしたことが原因でアップロードが失敗した場合
アップロード中、ユーザーがパスワードを入力する方法はありません。
url パラメータに無効なプロトコルが含まれることが原因でアップロードが失敗した場合
この問題を回避するには、この SWF ファイルを、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類します。この例外がスローされると、アクセスできないローカルファイルの名前および URL を示すメッセージが送信されます。0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
2) URL パラメータが有効なパスまたはプロトコルでない場合
ファイルのアップロードでは HTTP を使用し、ファイルのダウンロードでは FTP または HTTP を使用する必要があります。
cfg ファイルの設定により、この操作が禁止されている場合
ファイルをエンコードせずに URL へのアップロードを開始します。送信しようとするデータが、受信するサーバーで理解可能な形式で既にエンコードされている場合、uploadUnencoded() メソッドを使用します。一部のブラウザでは、URL ストリングの長さに制限があるものがあります。長さが 256 文字を超える場合、一部のブラウザまたはサーバーでは失敗する場合があります。このパラメータが null の場合、例外がスローされます。
Adobe AIR によるファイルの読み込み中、書き込み中、または転送中に入出力エラーが発生したために、アップロードが失敗した場合
ユーザー名とパスワードなど、認証が必要なサーバーにファイルをアップロードしようとしたことが原因でアップロードが失敗した場合
アップロード中、ユーザーがパスワードを入力する方法はありません。
url パラメータに無効なプロトコルが含まれることが原因でアップロードが失敗した場合
この問題を回避するには、この SWF ファイルを、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類します。この例外がスローされると、アクセスできないローカルファイルの名前および URL を示すメッセージが送信されます。ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
2) URL パラメータが有効なパスまたはプロトコルでない場合
ファイルのアップロードには HTTP を使用する必要があります。
イベントの詳細
ユーザーがアップロードまたはダウンロードするファイルをファイル参照ダイアログボックスからキャンセルしたときに送出されます。ユーザーが他の手段 (ブラウザを閉じたり、現在のアプリケーションを停止したりすること) によってアップロードまたはダウンロードをキャンセルした場合、Flash Player はこのイベントを送出しません。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。操作をキャンセルするオブジェクトへの参照です。次の例で、cancel イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。ダウンロードが完了、またはアップロードで HTTP ステータスコード 200 が生成された場合に送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ロードが完了したネットワークオブジェクトです。次の例で、complete イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。サーバーから返された HTTP ステータスコードです。HTTP ステータスコードを受け取るネットワークオブジェクトです。アップロードに失敗し、HTTP ステータスコードを使用して失敗を記述することができない場合に送出されます。Flash Player で実行されるコンテンツの場合、このイベントはダウンロードの失敗には適用されません。HTTP エラーのためにダウンロードが失敗した場合は、I/O エラーとして通知されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。サーバーから返された HTTP ステータスコードです。HTTP ステータスコードを受け取るネットワークオブジェクトです。アップロードまたはダウンロードが失敗したときに送出されます。次のいずれかの理由により、ファイル転送に失敗することがあります。
Player でファイルの読み込み中、書き込み中、または転送中に入出力エラーが発生した場合
ユーザー名とパスワードなど、認証が必要なサーバーに SWF ファイルがファイルをアップロードしようとした場合
認証が必要なサーバーに対して SWF ファイルがファイルをアップロードしようとすると、アップロードは失敗します。
スタンドアローンまたは外部 Player 内で、認証が必要なサーバーから SWF ファイルがファイルをダウンロードしようとした場合
ダウンロードする際、スタンドアローンまたは外部 Player には、ユーザーがパスワードを入力する手段がありません。認証が必要なサーバーから、これらの Player 内の SWF ファイルがファイルをダウンロードしようとすると、ダウンロードは失敗します。重要:ブラウザ内で実行される、つまり、ブラウザプラグインまたは ActiveX コントロールを使用するアプリケーションと、Adobe AIR で実行されるコンテンツでのみ、認証用のユーザー名とパスワードを入力できるダイアログボックスを表示できます。ただし、それはダウンロードの場合のみです。Flash Player のプラグインまたは ActiveX コントロールバージョンを使用するアップロードの場合、または、スタンドアローンまたは外部 Player を使用するアップロードまたはダウンロードの場合、ファイル転送は失敗します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
特定のエラーに関連付けられた参照番号です(AIR のみ)
入出力エラーが発生したネットワークオブジェクトです。エラーメッセージとして表示されるテキストです。アップロード処理またはダウンロード処理が開始するときに送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。接続をオープンしたネットワークオブジェクトです。次の例で、download イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。ファイルのアップロード処理中またはダウンロード処理中に定期的に送出されます。progress イベントは、Flash Player がバイトをサーバーに転送しているときに送出され、最終的に転送が成功しなくても、転送の実行中は定期的に送出されます。ファイルの転送が実際に成功して完了したかどうか、およびそのタイミングを確認するには、complete イベントを受け取ります。例えば、転送対象ファイルが非常に小さい場合や、アップロードやダウンロードが非常に短時間に終わる場合、progress イベントは送出されない場合があります。このイベントには、次のプロパティがあります。リスナーがイベントを処理しているときにロードされたアイテム数またはバイト数です。ロードプロセスが成功した場合に最終的にロードされるアイテムまたはバイトの総数です。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。進行状況をレポートする オブジェクトです。次の例では、progress イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。download() メソッドの呼び出しによって、サーバーにファイルをアップロードするか、呼び出し元のセキュリティサンドボックスの外部にあるサーバーからファイルを取得しようとすると、送出されます。呼び出し側の SWF ファイルが自分のドメインの外にある SWF ファイルにアクセスしようとして、アクセス権限がないと発生します。URL ポリシーファイルを使用することで、このエラーに対処できます。Adobe AIR では、これらのセキュリティ制限は、アプリケーションセキュリティサンドボックス内のコンテンツには適用されません。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。セキュリティエラーを報告するネットワークオブジェクトです。エラーメッセージとして表示されるテキストです。ユーザーがアップロードするファイルまたはダウンロードするファイルをファイル参照ダイアログボックスから選択したときに、送出されます。ユーザーがファイルを選択し、[OK] などをクリックして操作を確認すると、FileReference オブジェクトのプロパティに値が設定されます。Flash Player または Adobe AIR ランタイムのアプリケーションセキュリティサンドボックス外で実行されるコンテンツの場合、select イベントは、どのメソッドがそのイベントを呼び出したかにより、わずかに異なった動作をします。これは、ユーザーが選択したファイルが、ローカルファイルシステムに存在するためです。これは、select イベントが送出された時点では、ファイルがまだローカルファイルシステムにダウンロードされていないためです。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。アイテムが選択されたオブジェクトです。次の例で、select イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。xml ファイルを置いておく必要があります。アップロードの正常終了後、サーバーからデータを受信したときに送出されます。サーバーからデータが返されないと、このイベントは送出されません。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ファイルアップロードが正常に終了した後、サーバーから返された生データです。
例 例の使用法
次の例では、実行時にロードされるファイルのデータフォーマットとステータス情報を表示します。cfm という名前のファイルを参照している必要があります。設定に基づいて、[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合もあります。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
play() を使用して、パブリッシュされたストリームにサブスクライブし、データを受信できます。ライブ (リアルタイム) データおよび以前に記録したデータをパブリッシュすることも、再生することもできます。send() メソッドを呼び出して、メッセージをすべてのサブスクライブしているクライアントに送信することもできます。SWF ファイルにビデオを埋め込むよりも、外部のビデオファイルを再生した方が、パフォーマンスとメモリ管理の効率がよくなる、ビデオと SWF のフレームレートを独立化できるなどのメリットがあります。264 では、Sorenson または On2 の同じエンコードプロファイルと比較して、低いビットレートで高品質のビデオが配信されます。
サポートされているコーデックおよびファイル形式については、、http://www
ストリームのパブリッシュおよび再生のためのワークフロー:
connect() メソッドを呼び出して、サーバー上のアプリケーションインスタンスに接続します。
オーディオおよびビデオのキャプチャ、エンコード、およびパブリッシュを行うには、NetStream
publish() メソッドを呼び出して、ストリームに一意の名前を付けます。また、ストリームを介してサーバーにデータを送信します。これにより、他のユーザーがデータを受信できるようになります。データをパブリッシュしたときに、そのデータを記録することもできます。これにより、後でデータを再生することができます。play() メソッドを呼び出して、ライブストリームまたは録音したストリームを再生します。send() を使用してライブのオーディオまたはビデオにメタデータを追加できます。メタデータには、ビデオの高さまたは幅、ビデオの継続時間、作成者の名前などの情報を設定できます。再生中は、2 つの方法でストリームまたは FLV ファイルからのデータを処理できます。client プロパティをイベントハンドラと関連付けてデータオブジェクトを受信します。client プロパティを使用して、特定のデータ処理関数の呼び出しにオブジェクトを割り当てます。次に、これらの関数内にプロシージャを書き込んで、再生中にストリームまたは FLV ファイルから返されたデータオブジェクトを処理します。client プロパティを NetStream クラスのサブクラスに関連付けて、データオブジェクトを受信するイベントハンドラを書き込みます。ただし、NetStream のサブクラスを作成し、そのサブクラス内にイベントハンドラを定義することや、サブクラスをダイナミックにしてイベントハンドラ関数をサブクラスのインスタンスに追加することは可能です。注意:MP3 などのオーディオファイルでデータを送信するには、Sound クラスを使用してオーディオファイルと Sound オブジェクトを関連付けます。id3 プロパティを使用してサウンドファイルからメタデータを読み込みます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
[読み取り専用] バッファに現在格納されているデータの秒数です。ストリームの表示を開始するまでにメッセージをどの程度の時間バッファリングしておくかを指定します。[読み取り専用] 既にアプリケーションにロードされているデータのバイト数です。
[読み取り専用] アプリケーションにロードされるファイルの総バイト数
ビデオファイルのロードを開始する前に、アプリケーションが、ロードされるビデオファイルのサーバーからクロスドメインポリシーファイルをダウンロードしようとするかどうかを指定します。FLV ファイルデータのストリーミングの処理にコールバックメソッドが呼び出されるオブジェクトを指定します。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] 1 秒あたりの表示フレーム数です。[読み取り専用] 実際にはストリームの向こう側によって選択される値で、この接続に固有です。[読み取り専用] ライブ (バッファリングされていない) モードでサブスクライブしているストリームバッファ内にあるデータの秒数です。一時停止モード中にメッセージをバッファリングしておく時間を秒単位で指定します。[読み取り専用] 実際にはストリームのこちら側によって選択される値で、この接続に固有です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[読み取り専用] 再生ヘッドの位置(秒単位)です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
指定された NetConnection オブジェクトを使用して、ビデオファイルを再生するためのストリームを生成します。イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。カメラからビデオのキャプチャを開始します。ストリーム上のすべてのデータの再生を停止し、time プロパティを 0 に設定して、他の用途でストリームにアクセスできるようにします。イベントをイベントフローに送出します。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。ピアーがパブリッシュするストリームが、ピアーがサブスクライブするストリームに一致する場合に呼び出されます。ビデオストリームの再生を一時停止します。メディアファイルを再生します。再生用の各オプションを設定のうえ、メディアファイルの再生を開始します。ローカルに保存されたメディアファイルから任意の DRM メタデータを抽出します。指定されたプロパティが存在し、列挙できるかどうかを示します。送信中にストリームを記録することもできます。ストリーム上で着信オーディオが再生されるかどうかを示します。ストリーム上で着信ビデオが再生されるかどうかを指定します。着信ビデオのフレームレートを指定します。[静的] ローカルにキャッシュされたすべてのDRM(デジタル著作権管理)バウチャーデータを削除します。再生を一時停止していたビデオストリームを再開します。指定された位置に最も近いキーフレーム (ビデオ業界では I フレームとも呼ばれます) をシークします。パブリッシュされたストリーム上で、サブスクライブしているすべてのクライアントにメッセージを送信します。基になる暗号化コンテンツを表示するために必要な DRM 認証資格情報を設定します。ループ処理に対するダイナミックプロパティの可用性を設定します。ストリームの再生を一時停止または再開します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。非同期形式で、つまりネイティブ非同期コードから例外がスローされると送出されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。NetStream オブジェクトが、再生の前にユーザーの認証資格情報を要求する、DRM (デジタル著作権管理) で暗号化されたコンテンツを再生しようとしたときに送出されます。NetStream オブジェクトが DRM (デジタル著作権管理) で暗号化されたファイルを再生しようとして、DRM に関連したエラーを検出したときに送出されます。
DRM (デジタル著作権管理) で暗号化されたコンテンツの再生が開始されるときに送出されます (ユーザーが認証されてコンテンツの再生が許可された場合)
入出力エラーが発生してネットワーク処理が失敗したときに送出されます。NetStream オブジェクトが、そのステータスまたはエラーの状態をレポートすると送出されます。ビデオファイルの再生中に埋め込まれたキューポイントに達した場合に応答するリスナーを定義します。AIR がメディアファイルに埋め込まれた DRM コンテンツメタデータを抽出する場合に、応答するリスナーを確立します。再生中のメディアファイルにバイト配列として埋め込まれているイメージデータを Flash Player が受け取ったときに応答するリスナーを定義します。再生中のビデオに埋め込まれた記述的情報を Flash Player が受け取ったときに応答するリスナーを定義します。NetStream オブジェクトによるストリームの再生が終了した場合に応答するリスナーを定義します。Flash Player が再生中のメディアファイルに埋め込まれたテキストデータを受信したときに応答するリスナーを定義します。play() メソッドを呼び出して DRM (デジタル著作権管理) で暗号化されたコンテンツを再生しようとしたときに送出されます。
[静的] NetStream インスタンスのコンストラクタに対するパラメータとして使用される静的オブジェクト
[静的] ピアーツーピアーの発行者接続を作成します。
プロパティの詳細
バッファに現在格納されているデータの秒数です。このプロパティを bufferTime プロパティと組み合わせることにより、あとどれくらいの時間でバッファが満たされるかを見積もることができます。例えば、バッファにデータがロードされるのを待つユーザーに対してフィードバック情報を提供することが可能になります。ストリームの表示を開始するまでにメッセージをどの程度の時間バッファリングしておくかを指定します。この場合、アプリケーションはデータを 15 秒間バッファリングしてからストリームの再生を開始します。
デフォルト値は 0
メモ : 記録されている(ライブではない)コンテンツをストリーミングするときの歪みを避けるには、Netstream
記録されているコンテンツの場合、デフォルトでは入力バッファが使用され、メディアデータがキューに置かれてメディアが適切に再生されます。記録されているコンテンツでは、デフォルト値を使用するか、バッファ時間を延長します。pause() が呼び出されたときにバッファをクリアしなくなりました。0 以前は、Flash Player はバッファが満杯になるまで待機してから再生を開始していましたが、このため遅延がよく発生していました。pause() を使用し、閲覧者がコマーシャルを見ている間、データをバッファし、メインのビデオが開始されたときに一時停止を解除することができます。バッファの動作は、パブリッシュするストリームまたはサブスクライブするストリームにバッファ時間が設定されているかどうかによって異なります。パブリッシュするストリームの場合、bufferTime には、送信バッファに蓄積されたフレームの送信を開始するまでの時間の長さを指定します。高速な接続の場合は、バッファ時間を考慮する必要はありません。データはアプリケーションがバッファリングすると即座に送信されます。一方、低速な接続では、アプリケーションがデータをバッファリングする速度とそのデータをクライアントに送信する速度が大幅に異なることがあります。サブスクライブするストリームの場合、bufferTime には、受信データをバッファリングして、ストリームの表示を開始するまでの時間を指定します。この場合、Flash はデータを 15 秒間バッファリングしてからストリームの再生を開始します。ライブストリームを後で再生する場合 (例えば、再生リストから再生)、このバッファ時間が保持されます。既にアプリケーションにロードされているデータのバイト数です。このプロパティを bytesTotal プロパティと組み合わせることにより、あとどれくらいの時間でバッファが満たされるかを見積もることができます。例えば、バッファにデータがロードされるのを待つユーザーに対してフィードバック情報を提供することが可能になります。
アプリケーションにロードされるファイルの総バイト数
ビデオファイルのロードを開始する前に、アプリケーションが、ロードされるビデオファイルのサーバーからクロスドメインポリシーファイルをダウンロードしようとするかどうかを指定します。このプロパティは、プログレッシブビデオダウンロードに NetStream オブジェクト(スタンドアローンファイル)を使用する場合、または呼び出し元の ファイルの専用ドメイン外にあるファイルをロードする場合に適用します。draw() メソッドを使用してビデオにピクセルレベルでアクセスすることができます。これは、必要なポリシーファイルがダウンロードされていないためです。ポリシーファイルの確認はネットワーク帯域幅を消費し、ダウンロードの開始が遅れる場合があります。play() の呼び出しで指定したオブジェクトのダウンロードを開始する前に、そのようなポリシーファイルが存在しないことを判別しておく必要があります。ポリシーファイルの存在を確認するため、Flash Player または AIR ランタイムは次のアクションをこの順番で実行します。アプリケーションは、既にダウンロードされているポリシーファイルを考慮します。play() に渡された URL に対応するデフォルトの場所からポリシーファイルをダウンロードしようとします。xml がデフォルトの場所です。どのような場合も、Flash Player または AIR ランタイムでは、該当するポリシーファイルがビデオのサーバー上に存在しており、ポリシーファイルの場所に基づいて play() に渡された URL にあるオブジェクトへのアクセスを提供し、<allow-access-from> タグによって呼び出し元コードのファイルのドメインがビデオにアクセスできるようにする必要があります。最終的なファイルが HTTP リダイレクトによって別の URL から取得される場合、最初にダウンロードされたポリシーファイルはファイルの最終的な URL(セキュリティ判定においてはこの URL が重要となります)に適用できないことがあります。FLV ファイルデータのストリーミングの処理にコールバックメソッドが呼び出されるオブジェクトを指定します。client プロパティを別のオブジェクトに設定すると、コールバックメソッドはその別のオブジェクトで呼び出されます。
client プロパティをイベントハンドラに関連付けるには:
必要なデータイベントに対するハンドラ関数をクライアントオブジェクトのプロパティとして割り当てます。以下のようなデータイベントオブジェクトを受け取るハンドラ関数を記述します。データがストリームを通るとき、または再生中、データイベントオブジェクト(この場合は imageData オブジェクト)にデータが取り込まれます。client プロパティに関連付けられたオブジェクトの例がすべて記載されています。
client プロパティをサブクラスに関連付けるには:
ハンドラ関数を伴うサブクラスがデータイベントオブジェクトを受け取るように作成します。データがストリームを通るとき、または再生中、データイベントオブジェクト(この場合は info オブジェクト)にデータが取り込まれます。client プロパティへのサブクラスインスタンスの割り当てが記載されています。1 秒あたりの表示フレーム数です。複数のシステム上で再生できるようにビデオファイルを書き出す場合、テスト中にこの値をチェックすることで、ファイルの書き出し時にどの程度の圧縮が必要かを見極めることができます。このプロパティは、RTMFP 接続に対してのみ定義されます。実際にはストリームの向こう側によって選択される値で、この接続に固有です。このプロパティは、RTMFP 接続に対してのみ定義されます。このオブジェクトは現在の状態のスナップショットです。ライブ (バッファリングされていない) モードでサブスクライブしているストリームバッファ内にあるデータの秒数です。このプロパティは、現在のネットワーク転送の遅延時間を示します。詳細については、クラスの説明を参照してください。このプロパティの値を取得して、ストリームの転送品質を大まかに判断し、それをユーザーに伝えることができます。一時停止モード中にメッセージをバッファリングしておく時間を秒単位で指定します。このプロパティを使用して、一時停止モード中に行うバッファリングの量を制限できます。実際にはストリームのこちら側によって選択される値で、この接続に固有です。このプロパティは、RTMFP 接続に対してのみ定義されます。このプロパティの値は、ローカルストリームかリモートストリームかによって異なります。サーバーに接続しているリモートストリームでは、このサーバーとの接続のオブジェクトエンコーディングが返されます。接続されていない場合にこのプロパティを読み取ろうとするか、このプロパティを変更しようとすると、アプリケーションにより例外がスローされます。再生ヘッドの位置 (秒単位) です。パブリッシュするストリームの場合、ストリームをパブリッシュした秒数です。この数値は、小数点以下 3 桁までの精度があります。この数値に 1000 を掛けると、ストリームを再生したミリ秒単位の時間数になります。サブスクライブするストリームでは、サーバーがデータの送信を停止してもストリームが開いたままになっている場合、time プロパティの値の増加が止まります。サーバーがデータの送信を再開すると、値の増加が止まった個所から値の増加が続けられます。再生リストの要素間でストリームを切り替えても、time の値は増加を続けます。
コンストラクタの詳細
指定された NetConnection オブジェクトを使用して、ビデオファイルを再生するためのストリームを生成します。
サポートされているコーデックおよびファイル形式については、、http://www
ただし、peerID パラメータはオプションのため、クライアントとサーバが接続している間、以下がプログレッシブ再生の動作を継続します。次のコードは、変数 videoURL に割り当てられたビデオを連続的にダウンロードし、表示する接続を示しています。
メソッドの詳細
このメソッドは、指定されたストリームの発行者だけが使用できます。このメソッドは、ユーザーがクライアントコンピュータからサーバーにライブオーディオ (またはオーディオ付きのライブビデオ) を送信するときに呼び出される場合があります。このメソッドは、publish() メソッドを呼び出す前または後に呼び出すことができ、実際に送信を開始します。マイクオブジェクトの soundTransform プロパティを使用して、このオーディオストリームのサウンドプロパティ(ボリュームとパン)を制御できます。カメラからビデオのキャプチャを開始します。