System  - AS3

Adobe^® Flash^® Player または Adobe^® AIR^® に割り当てられているが現在使用されていないメモリ量（バイト単位）です。この割り当て済みメモリの未使用領域（System.totalMemory）は、ガベージコレクションが行われると変動します。このプロパティを使用して、ガベージコレクションを監視します。

関連する API エレメント

現在インストールされているシステムの IME です。imeComposition イベントに登録するには、このインスタンスで addEventListener() を呼び出します。

関連する API エレメント

アプリケーションで使用されるメモリ量の合計（バイト単位）です。これは、プロセス全体の常駐プライベートメモリの量です。

AIR 開発者は、このプロパティを使用してアプリケーション全体のメモリ消費量を特定します。

Flash Player の場合は、Web ブラウザーなどのコンテナアプリケーションで使用されるメモリも含まれます。

関連する API エレメント

Flash Player または AIR によって直接割り当てられている現在使用中のメモリ量（バイト単位）です。

このプロパティは、Adobe AIR アプリケーション、または Flash Player コンテンツを含むアプリケーション（ブラウザーなど）によって使用されるすべてのメモリを返すわけではありません。ブラウザーまたはオペレーティングシステムは、これ以外にメモリを消費する可能性があります。System.privateMemory プロパティは、アプリケーションによって使用されるすべてのメモリを反映します。

割り当てられたメモリ量が、uint オブジェクトの最大値（uint.MAX_VALUE、または 4,294,967,295）よりも大きい場合、このプロパティは 0 に設定されます。System.totalMemoryNumber プロパティでは、より大きい値が許容されます。

関連する API エレメント

Flash Player または AIR によって直接割り当てられている現在使用中のメモリ量（バイト単位）です。

このプロパティは、int 型の System.totalMemory プロパティよりも大きい値を許容する Number 型として表現されます。

このプロパティは、Adobe AIR アプリケーション、または Flash Player コンテンツを含むアプリケーション（ブラウザーなど）によって使用されるすべてのメモリを返すわけではありません。ブラウザーまたはオペレーティングシステムは、これ以外にメモリを消費する可能性があります。System.privateMemory プロパティは、アプリケーションによって使用されるすべてのメモリを反映します。

関連する API エレメント

外部テキストファイルを解釈するときにどのコードページを使用するかを決定するブール値です。 このプロパティを false に設定すると、外部テキストファイルは Unicode として解釈されます。 これらのファイルは、保存する際に Unicode でエンコードする必要があります。このプロパティを true に設定すると、アプリケーションを実行するオペレーティングシステムの通常のコードページを使用して外部テキストファイルが解釈されます。 useCodePage のデフォルト値は false です。

（Loader.load()、URLLoader クラスまたは URLStream を使用して）外部ファイルとしてロードするテキストを Unicode として認識するには、そのファイルを Unicode として保存しておく必要があります。 外部ファイルを Unicode でエンコードするには、Unicode をサポートするアプリケーション（Windows のメモ帳など）でファイルを保存します。

Unicode でエンコードされていない外部テキストファイルをロードする際には、useCodePage を true に設定してください。次の行を、データをロードしているファイルのコードの最初の行として追加します（Flash Professional の場合は、最初のフレームに追加します）。

System.useCodePage = true;

このコードがあると、外部テキストは、オペレーティングシステムの通常のコードページを使用して解釈されます。 例えば、一般に、英語の Windows オペレーティングシステムでは CP1252 が、日本語のオペレーティングシステムでは Shift-JIS が使用されます。

Flash Player 6 以降で useCodePage を true に設定すると、テキストは Flash Player 5 の場合と同様に扱われます。Flash Player 5 では、すべてのテキストは、Flash Player を実行するオペレーティングシステムの通常のコードページを使用して解釈されていました。

useCodePage を true に設定した場合、外部テキストファイル内で使用されている文字がアプリケーションを実行するオペレーティングシステムの通常のコードページに含まれていないと、そのテキストは表示されません。例えば、中国語を含む外部テキストファイルをロードする場合、CP1252 コードページを使用するシステムでは、これらの文字を表示できません。CP1252 コードページには中国語が含まれていないためです。

アプリケーションで使用する外部テキストファイルをすべてのプラットフォームのユーザーが表示できるようにするには、すべての外部テキストファイルを Unicode でエンコードし、useCodePage を false に設定します。 これにより、アプリケーション（Flash Player 6 以降または AIR ）でテキストが Unicode として解釈されます。

関連する API エレメント

指定した XML オブジェクトを即時にガベージコレクションで処理できるようにします。このメソッドを使用すると、指定した XML ノードに対するすべてのノード間の親接続と子接続が削除されます。

パラメーター

Flash Player を閉じます。

スタンドアローン Flash Player デバッグ版のみ。

AIR アプリケーションでは、アプリケーションを終了するために NativeApplication.exit() メソッドを呼び出す必要があります。

パラメーター

関連する API エレメント

ガベージコレクションプロセスを強制します。

Flash Player デバッグ版および AIR アプリケーションのみ。AIR アプリケーションでは、System.gc() メソッドは AIR Debug Launcher（ADL）で実行しているコンテンツ、またはインストールされているアプリケーションではアプリケーションセキュリティサンドボックスのコンテンツでのみ有効になります。

Flash Player または AIR Debug Launcher（ADL）を一時停止します。 このメソッドを呼び出したときにアプリケーションで実行が続行されるのは、Socket イベントの配信だけです。

Flash Player デバッガー版または AIR Debug Launcher（ADL）のみに対応しています。

関連する API エレメント

ガベージコレクターの緊急度が関数の imminence パラメーターを上回った場合に、コレクターのインクリメンタルな収集サイクルを終了する必要があることをコレクターに指示します。

Flash ランタイムガベージコレクターアルゴリズムは、インクリメンタルに実行しながら、使用中のメモリをマークします。メモリの未使用部分を収集中は、アプリケーションの実行を一時停止します。インクリメンタルな収集サイクルが終了したときに発生する一時停止の時間は、望ましい時間より長くなることがあり、プログラムによっては目や耳で感知できる場合があります。この関数により、アプリケーションからランタイムに対して、マークの完了と収集の実行に適したタイミングであることを知らせることができます。ユーザーが気付かないタイミングで一時停止をスケジュールすることは、ユーザーエクスペリエンスの向上につながります。例えば、ゲームでは、あるレベルが完了した時点でこの関数を呼び出せば、プレイ中に一時停止が発生する可能性が低くなります。

緊急度は、マーキングによるコレクターの判断、つまり、収集の一時停止をトリガーするタイミングがどこまで近付いているかで定義されます。この関数の imminence 引数はしきい値です。実際の緊急度がしきい値を超えた場合にのみ、ガベージコレクターは呼び出されます。それ以外の場合は、この関数は処理を行わずに直ちに返されます。

imminence に低い値を設定してこの関数を呼び出すと、比較的大量のマーキングを完了する必要があることをアプリケーションが許容できることが示されます。一方、imminence に高い値を設定すると、マーキングがほぼ完了した場合にのみアプリケーションの一時停止が必要なことが示されます。通常、後者よりも前者で一時停止の時間が長くなります。

解放されるメモリ量は、imminence パラメーターによって変化しません。解放可能なオブジェクト数のみによって変化します。アプリケーションが大きなデータ構造や多数のオブジェクトへの参照を解放したばかりの場合は、imminence パラメーターに低い値を設定すると、コレクション処理がトリガーされて、これらのオブジェクトがすぐに解放される傾向があります。

パラメーター

System.pause() を呼び出した後、アプリケーションを再開します。

Flash Player デバッガー版または AIR Debug Launcher（ADL）のみに対応しています。

関連する API エレメント

クリップボードの内容を、指定されたテキストストリングで置き換えます。このメソッドは、キー入力や入力デバイスのクリックなどのユーザーイベントに応じて呼び出されたときに、任意のセキュリティコンテキストで動作します。

このメソッドは、Flash Player 9 で実行されている SWF コンテンツに提供されます。クリップボードへのストリング内容の追加のみが許可されます。

Flash Player 10 のコンテンツと AIR アプリケーションのアプリケーションセキュリティサンドボックスのコンテンツは、Clipboard.setData() メソッドを呼び出すことができます。

パラメーター

関連する API エレメント