AIR.SWF 內部瀏覽器 API

除了使用 SDK 隨附的 badge.swf 檔案，您也能自行建立 SWF 檔以供瀏覽器網頁使用。您自訂的 SWF 檔可以透過下列方式與執行階段互動：

• 安裝 AIR 應用程式。請參閱 從瀏覽器安裝 AIR 應用程式 。

• 檢查是否已安裝特定的 AIR 應用程式。請參閱 從網頁檢查是否已安裝 AIR 應用程式 。

• 檢查是否已安裝執行階段。請參閱 檢查是否已安裝執行階段 。

• 啟動使用者系統上已安裝的 AIR 應用程式。請參閱 從瀏覽器啟動已安裝的 AIR 應用程式 。

這些功能是經由呼叫裝載於 adobe.com 上的 SWF 檔 air.swf 中的 API 所取得。您可以自訂 badge.swf 檔案，並從您自己的 SWF 檔案呼叫 air.swf API。

此外，在瀏覽器內執行的 SWF 檔還能利用 LocalConnection 類別，與執行中的 AIR 應用程式進行通訊。如需詳細資訊，請參閱 與其他 Flash Player 和 AIR 實體進行通訊 (適用於 ActionScript 開發人員) 或 Communicating with other Flash Player and AIR instances (適用於 HTML 開發人員)。

AIR SDK 和 Flex SDK 隨附有 badge.swf 檔，讓您得以輕鬆使用隱藏安裝功能。badge.swf 能夠從網頁上的連結來安裝執行階段和 AIR 應用程式。所附的項目包括 badge.swf 檔案及其原始碼，可供您的網站進行散佈。

您可以取用 air.swf 檔案中的 API 來自行建立 SWF 檔，然後透過瀏覽器內的網頁與執行階段及 AIR 應用程式進行互動。air.swf 檔案裝載於 http://airdownload.adobe.com/air/browserapi/air.swf。若要從您的 SWF 檔中參考 air.swf API，請將 air.swf 檔案載入到與您的 SWF 檔相同的應用程式網域。下列程式碼會示範如何將 air.swf 檔案載入到載入端 SWF 檔所在的應用程式網域：

var airSWF:Object; // This is the reference to the main class of air.swf 
var airSWFLoader:Loader = new Loader(); // Used to load the SWF 
var loaderContext:LoaderContext = new LoaderContext();  
                                // Used to set the application domain  
 
loaderContext.applicationDomain = ApplicationDomain.currentDomain; 
 
airSWFLoader.contentLoaderInfo.addEventListener(Event.INIT, onInit); 
airSWFLoader.load(new URLRequest("http://airdownload.adobe.com/air/browserapi/air.swf"),  
                    loaderContext); 
 
function onInit(e:Event):void  
{ 
    airSWF = e.target.content; 
}

一旦載入 air.swf 檔案之後 (此時 Loader 物件的 contentLoaderInfo 物件會傳送 init 事件)，您就可以如下列各節所述，呼叫任何的 air.swf API。

SWF 檔可藉由呼叫 air.swf 檔案 (載入來源為 http://airdownload.adobe.com/air/browserapi/air.swf) 所提供的 getStatus() 方法，檢查是否已經安裝執行階段。如需詳細資訊，請參閱 載入 air.swf 檔案 。

一旦載入 air.swf 檔案之後，SWF 檔即可呼叫 air.swf 檔案的 getStatus() 方法，如下所示：

var status:String = airSWF.getStatus();

getStatus() 方法會傳回下列任一字串值，視電腦上的執行階段狀態而定：

如果瀏覽器並未安裝必要的 Flash Player 版本 (若使用 Windows 和 Mac OS，則安裝第 9 版更新 3 或更新版本；若使用 Linux，則安裝第 10 版)， getStatus() 方法就會擲出錯誤。

SWF 檔可藉由呼叫 air.swf 檔案 (載入來源為 http://airdownload.adobe.com/air/browserapi/air.swf) 所提供的 getApplicationVersion() 方法，透過比對應用程式 ID 和發行者 ID 的方式，檢查是否已經安裝特定的 AIR 應用程式。如需詳細資訊，請參閱 載入 air.swf 檔案 。

一旦載入 air.swf 檔案之後，SWF 檔即可呼叫 air.swf 檔案的 getApplicationVersion() 方法，如下所示：

var appID:String = "com.example.air.myTestApplication"; 
var pubID:String = "02D88EEED35F84C264A183921344EEA353A629FD.1"; 
airSWF.getApplicationVersion(appID, pubID, versionDetectCallback); 
 
function versionDetectCallback(version:String):void 
{ 
    if (version == null) 
    { 
        trace("Not installed."); 
        // Take appropriate actions. For instance, present the user with 
        // an option to install the application. 
    } 
    else 
    { 
        trace("Version", version, "installed."); 
        // Take appropriate actions. For instance, enable the 
        // user interface to launch the application. 
    } 
}

getApplicationVersion() 方法具有下列參數：

如果瀏覽器並未安裝必要的 Flash Player 版本 (若使用 Windows 和 Mac OS，則安裝第 9 版更新 3 或更新版本；若使用 Linux，則安裝第 10 版)， getApplicationVersion() 方法就會擲出錯誤。

SWF 檔可藉由呼叫 air.swf 檔案 (載入來源為 http://airdownload.adobe.com/air/browserapi/air.swf ) 所提供的 installApplication() 方法，安裝 AIR 應用程式。如需詳細資訊，請參閱 載入 air.swf 檔案 。

一旦載入 air.swf 檔案之後，SWF 檔即可呼叫 air.swf 檔案的 installApplication() 方法，如下列程式碼所示：

var url:String = "http://www.example.com/myApplication.air"; 
var runtimeVersion:String = "1.0"; 
var arguments:Array = ["launchFromBrowser"]; // Optional 
airSWF.installApplication(url, runtimeVersion, arguments); 

installApplication() 方法會在使用者的電腦上安裝指定的應用程式。這個方法具有下列參數：

您必須在使用者事件 (例如按下滑鼠) 的事件處理常式中呼叫 installApplication() 方法，否則此方法不能運作。

如果瀏覽器並未安裝必要的 Flash Player 版本 (若使用 Windows 和 Mac OS，則安裝第 9 版更新 3 或更新版本；若使用 Linux，則安裝第 10 版)， installApplication() 方法就會擲出錯誤。

若要在 Mac OS 上安裝更新版的應用程式，使用者必須具有適當的系統權限，才能在應用程式目錄內進行安裝 (如果應用程式要更新執行階段，則必須具有系統管理權限)。在 Windows 上，使用者必須具有系統管理權限。

您也可以呼叫 air.swf 檔案的 getApplicationVersion() 方法，檢查是否安裝了特定的應用程式。不論是在應用程式安裝程序進行之前或開始安裝後，皆可呼叫此方法。如需詳細資訊，請參閱 從網頁檢查是否已安裝 AIR 應用程式 。執行中的應用程式可以使用 LocalConnection 類別，與瀏覽器內的 SWF 內容進行通訊。如需詳細資訊，請參閱 與其他 Flash Player 和 AIR 實體進行通訊 (適用於 ActionScript 開發人員) 或 Communicating with other Flash Player and AIR instances (適用於 HTML 開發人員)。

若要使用瀏覽器叫用功能 (以便可從瀏覽器啟動應用程式)，目標應用程式的應用程式描述器檔案必須包含下列設定：

<allowBrowserInvocation>true</allowBrowserInvocation>

如需有關應用程式描述器檔案的詳細資訊，請參閱 AIR 應用程式描述器檔案 。

瀏覽器內的 SWF 檔可藉由呼叫 air.swf 檔案 (載入來源為 http://airdownload.adobe.com/air/browserapi/air.swf) 所提供的 launchApplication() 方法，啟動 AIR 應用程式。如需詳細資訊，請參閱 載入 air.swf 檔案 。

一旦載入 air.swf 檔案之後，SWF 檔即可呼叫 air.swf 檔案的 launchApplication() 方法，如下列程式碼所示：

var appID:String = "com.example.air.myTestApplication"; 
var pubID:String = "02D88EEED35F84C264A183921344EEA353A629FD.1"; 
var arguments:Array = ["launchFromBrowser"]; // Optional 
airSWF.launchApplication(appID, pubID, arguments);

launchApplication() 方法定義於 air.swf 檔案的頂層 (後者是載入到使用者介面 SWF 檔的應用程式網域)。若已安裝指定的應用程式，且應用程式描述器檔案中的 allowBrowserInvocation 設定為允許瀏覽器叫用功能，呼叫此方法將導致 AIR 啟動該應用程式。這個方法具有下列參數：

您必須在使用者事件 (例如按下滑鼠) 的事件處理常式中呼叫 launchApplication() 方法，否則此方法不能運作。

如果瀏覽器並未安裝必要的 Flash Player 版本 (若使用 Windows 和 Mac OS，則安裝第 9 版更新 3 或更新版本；若使用 Linux，則安裝第 10 版)， launchApplication() 方法就會擲出錯誤。

如果應用程式描述器檔案將 allowBrowserInvocation 元素設定為 false ，呼叫 launchApplication() 方法就沒有任何效用。

您或許可以先呼叫 air.swf 檔案所提供的 getApplicationVersion() 方法，再決定是否顯示使用者介面告知即將啟動應用程式。如需詳細資訊，請參閱 從網頁檢查是否已安裝 AIR 應用程式 。

透過瀏覽器叫用功能叫用應用程式時，應用程式的 NativeApplication 物件會傳送 BrowserInvokeEvent 事件。如需詳細資訊，請參閱 從瀏覽器叫用 AIR 應用程式 (適用於 ActionScript 開發人員) 或 Invoking an AIR application from the browser (適用於 HTML 開發人員)。

如果您要使用瀏覽器叫用功能，請務必考量安全性方面的隱憂。這些隱憂將描述於 從瀏覽器叫用 AIR 應用程式 (適用於 ActionScript 開發人員) 和 Invoking an AIR application from the browser (適用於 HTML 開發人員)。

執行中的應用程式可以使用 LocalConnection 類別，與瀏覽器內的 SWF 內容進行通訊。如需詳細資訊，請參閱 與其他 Flash Player 和 AIR 實體進行通訊 (適用於 ActionScript 開發人員) 或 Communicating with other Flash Player and AIR instances (適用於 HTML 開發人員)。