ExtensionContext  - AS3

このコンテキストに関連する ActionScript オブジェクトです（存在する場合）。

任意の ActionScript オブジェクトを ExtensionContext インスタンスに関連付けることができます。また、ネイティブ実装は、この ActionScript オブジェクトを取得および設定できます。そのため、actionScriptData を使用して、拡張の ActionScript 側とネイティブ側でデータを共有できます。

また、actionScriptData の値を null に設定できます。

functionName で指定されているネイティブ関数を呼び出します。追加の引数があれば、ネイティブ関数に渡されます。

パラメーター

指定した拡張 ID およびコンテキストタイプに対して ExtensionContext インスタンスを作成します。

パラメーター

この ExtensionContext インスタンスを破棄します。

ランタイムからネイティブ実装に通知され、関連するネイティブリソースがすべて解放されます。dispose() の呼び出し後は、コードから call() メソッドを呼び出すことや、actionScriptData プロパティを取得または設定することはできなくなります。

拡張がデバイスにインストールされているディレクトリを返します。

拡張には、拡張の ActionScript コードからアクセスする画像などのリソースが含まれることがあります。また、コードには、拡張記述子ファイルで使用できる情報が必要な場合もあります（拡張のバージョン番号など）。このメソッドを使用して、拡張のベースディレクトリにアクセスできます。

デバイスの拡張の場所にかかわらず、拡張のファイルは、拡張のベースディレクトリに相対して常に同じ場所にあります。このメソッドが返す File インスタンスを使用して、拡張に含まれる特定のファイルを特定し、操作できます。

拡張ディレクトリの構造は次のとおりです。

			 extension base directory/
			      platform independent files
			      META-INF/
			           ANE/
			                extension.xml
			                platform name/
			                     platform-dependent files and directories
			 

拡張ディレクトリの場所は、次のように、拡張がアプリケーションバンドルを通して使用できるか、デバイスバンドルを通して使用できるかによって異なります。

• アプリケーションバンドルでは、拡張ディレクトリはアプリケーションディレクトリ内に配置されています。
• デバイスバンドルでは、拡張ディレクトリの場所はデバイスによって異なります。

例外として、iOS デバイス用のネイティブ拡張の場合は、getExtensionDirectory() を使用します。これらの拡張のリソースは、拡張ディレクトリではなく、アプリケーションのトップレベルのディレクトリに配置されています。

パラメーター

ExtensionContext クラスには、Adobe AIR のネイティブ拡張のネイティブ実装内にある関数を呼び出すためのインタフェースが用意されています。このクラスは、拡張に含まれる ActionScript クラスにのみ使用できます。

AIR プロファイルサポート：この機能は AIR 3 以降のモバイルデバイス上でサポートされます。また、デスクトップデバイス上では、extendedDesktop デバイスプロファイルを使用するアプリケーションにおいて、AIR 3 以降でサポートされます。AIR for TV デバイス上では、extendedTV デバイスプロファイルを使用するアプリケーションにおいて、AIR 2.5 以降でサポートされます。

ネイティブ拡張は、次の要素を組み合わせたものです。

• ActionScript クラス
• ネイティブコードネイティブコードは、デバイス上のランタイム外で実行されるコードです。例えば、C で記述されたコードはネイティブコードです。

ネイティブ拡張は次の目的で作成できます。

• AIR アプリケーションに対してデバイス固有の機能へのアクセス権を付与します。
• 既存のネイティブコードを再利用します。
• ネイティブコードを使用して、ActionScript コードを使用した場合よりも処理効率を上げます。

拡張の ActionScript 側からネイティブ側にアクセスするには、ExtensionContext クラスを使用します。まず、ExtensionContext クラスのインスタンスを作成します。これを行うには、静的メソッド ExtensionContext.createExtensionContext() を呼び出します。

ExtensionContext インスタンスの作成後、インスタンスの call() メソッドを使用してネイティブ関数を呼び出します。

ExtensionContext インスタンスの処理が完了したら、dispose() を呼び出して、関連するネイティブリソースをすべて解放します。dispose() を明示的に呼び出さないと、インスタンスの破棄時にランタイムガベージコレクターによって dispose() が呼び出されます。dispose() の明示的な呼び出しは、通常、ガベージコレクター処理の待機よりもはるかに早く発生します。

ExtensionContext インスタンスは、拡張のネイティブ実装で何らかの非同期イベントが発生するときにネイティブコードが発行する StatusEvent イベントをリッスンできます。ExtensionContext クラスは EventDispatcher から派生するので、結果としてイベントを発行できます。

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