ExtensionContext  - AS3

与此上下文关联的 ActionScript 对象（如果有）。

可以将任何 ActionScript 对象与 ExtensionContext 实例关联。本机实现也可以获取和设置此 ActionScript 对象。因此，可以使用 actionScriptData 在扩展的 ActionScript 端和本机端之间共享数据。

还可以将 actionScriptData 的值设置为 null。

调用由 functionName 指定的本机函数。任何其他参数都将传递到本机函数。

参数

为给定的扩展标识符和上下文类型创建 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 中启动的移动设备支持此功能。在 AIR 3 中启动的桌面设备上，使用 extendedDesktop 设备配置文件的应用程序也支持此功能。在 AIR 2.5 中启动的 AIR for TV 设备上，使用 extendedTV 设备配置文件的应用程序支持此功能。

本机扩展为以下组合：

• ActionScript 类。
• 本机代码。本机代码是在没有运行时的设备上执行的代码。例如，C 语言编写的代码就是本机代码。

您可以出于以下目的创建本机扩展：

• 为 AIR 应用程序提供对特定设备的功能的访问。
• 重用现有本机代码。
• 使用本机代码比 ActionScript 代码提供更有效的处理。

在 扩展的 ActionScript 端使用 ExtensionContext 类，以访问扩展的本机端。首先，创建 ExtensionContext 类的实例。为此，请调用静态方法 ExtensionContext.createExtensionContext()。

创建 ExtensionContext 实例后，使用该实例的 call() 方法调用本机函数。

对 ExtensionContext 实例完成操作后，调用 dispose() 以释放任何关联的本机资源。运行时垃圾回收器在处理此实例时调用 dispose()，而不显式调用 dispose()。显式调用 dispose() 通常比等待垃圾回收器执行操作的时间要早得多。

ExtensionContext 实例可侦听当扩展的本机实现中发生某些异步事件时由本机代码调度的 StatusEvent 事件。由于 ExtensionContext 类派生自 EventDispatcher，因此它可以依次调度事件。

此事件具有以下属性：