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 開始，行動裝置都支援此項功能。從 AIR 3 開始，桌上型電腦裝置中使用 extendedDesktop 裝置描述檔的應用程式也支援此項功能。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，它也可以傳送事件。

這個事件具有下列屬性：