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 开发人员）或 与其他 Flash Player 和 AIR 实例通信 （针对 HTML 开发人员）。

AIR SDK 和 Flex SDK 中包含一个 badge.swf 文件，通过此文件，您可轻松使用无缝安装功能。badge.swf 可以从网页中的链接安装运行时和 AIR 应用程序。为您提供了 badge.swf 文件及其源代码以供您在您的网站上分发。

您可以创建自己的 SWF 文件，使之使用 air.swf 文件中的 API 从浏览器中的网页与运行时和 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 文件可以通过在从 http://airdownload.adobe.com/air/browserapi/air.swf 加载的 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 文件可以通过在从 http://airdownload.adobe.com/air/browserapi/air.swf 加载的 air.swf 文件中调用 getApplicationVersion( ) 方法，检查是否已安装 AIR 应用程序（具有匹配的应用程序 ID 和发行商 ID）。有关详细信息，请参阅 加载 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 文件可以通过在从 http://airdownload.adobe.com/air/browserapi/air.swf 加载的 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 操作系统中，若要安装某一应用程序的更新版本，用户必须拥有足够的系统权限才能将新版本安装到应用程序目录中（如果此应用程序更新运行时，则还须拥有管理权限）。在 Windows 中，用户必须具有管理权限。

您也可以调用 air.swf 文件的 getApplicationVersion() 方法来检查是否已安装应用程序。可以在开始应用程序安装过程之前调用此方法，亦可在安装开始之后进行调用。有关详细信息，请参阅 从网页检查是否已安装 AIR 应用程序 。此应用程序运行后便可以通过使用 LocalConnection 类与浏览器中的 SWF 内容通信。有关详细信息，请参阅 与其他 Flash Player 和 AIR 实例通信 （针对 ActionScript 开发人员）或 与其他 Flash Player 和 AIR 实例通信 （针对 HTML 开发人员）。

若要使用浏览器调用功能（使其可以从浏览器启动），目标应用程序的应用程序描述符文件必须包含以下设置：

<allowBrowserInvocation>true</allowBrowserInvocation>

有关应用程序描述符文件的详细信息，请参阅 AIR 应用程序描述符文件 。

浏览器中的 SWF 文件可以通过在从 http://airdownload.adobe.com/air/browserapi/air.swf 加载的 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 文件所在的应用程序域中加载）的顶级定义。调用此方法将导致 AIR 启动指定的应用程序（如果该应用程序已安装，且通过应用程序描述符文件中的 allowBrowserInvocation 设置允许浏览器调用）。此方法具有以下参数：

仅当在用户事件（例如鼠标单击）的事件处理程序中调用 launchApplication() 方法时，此方法才执行。

如果浏览器中未安装所需的 Flash Player 版本（Windows 和 Mac OS 中为版本 9 更新 3 或更高版本，Linux 中为版本 10），则 launchApplication() 方法会引发错误。

如果在应用程序描述符文件中将 allowBrowserInvocation 元素设置为 false ，则调用 launchApplication() 方法将不起任何作用。

在显示用于启动应用程序的用户界面之前，您可能需要在 air.swf 文件中调用 getApplicationVersion( ) 方法。有关详细信息，请参阅 从网页检查是否已安装 AIR 应用程序 。

当通过浏览器调用功能调用此应用程序时，此应用程序的 NativeApplication 对象将调度 BrowserInvokeEvent 对象。有关详细信息，请参阅 从浏览器调用 AIR 应用程序 （针对 ActionScript 开发人员）或 从浏览器调用 AIR 应用程序 （针对 HTML 开发人员）。

如果使用浏览器调用功能，请务必考虑安全性问题。 从浏览器调用 AIR 应用程序 （针对 ActionScript 开发人员）和 从浏览器调用 AIR 应用程序 （针对 HTML 开发人员）中介绍了这些含义。

此应用程序运行后便可以通过使用 LocalConnection 类与浏览器中的 SWF 内容通信。有关详细信息，请参阅 与其他 Flash Player 和 AIR 实例通信 （针对 ActionScript 开发人员）或 与其他 Flash Player 和 AIR 实例通信 （针对 HTML 开发人员）。