AIR.SWF, встроенный в браузер интерфейс API

Помимо файла badge.swf, включенного в SDK, можно создать собственный SWF-файл для использования на странице в обозревателе. Этот SWF-файл может взаимодействовать с средой выполнения несколькими способами.

• Он может устанавливать приложение AIR. См. раздел « Установка приложений AIR из обозревателя ».

• Он может проверять, установлено ли данное приложение AIR. См. раздел « Проверка наличия установленного AIR с веб-страницы ».

• Он может проверять, установлена ли среда выполнения. См. раздел « Проверка наличия установленной среды выполнения ».

• Он может запускать установленное приложение AIR в системе пользователя. См. раздел « Запуск установленных приложений AIR из обозревателя ».

Для использования этих возможностей необходимо вызвать API-интерфейсы в SWF-файле на сайте adobe.com: air.swf. Можно настроить файл badge.swf и вызвать прикладные интерфейсы программирования air.swf из собственного SWF-файла.

Кроме того, SWF-файл, запущенный в обозревателе, может взаимодействовать с запущенным приложением AIR с помощью класса LocalConnection. Дополнительные сведения см. в разделе « Взаимодействие с другим экземплярами Flash Player и AIR » (для разработчиков ActionScript) или « Взаимодействие с другим экземплярами Flash Player и AIR » (для разработчиков HTML).

Файл badge.swf включен в AIR SDK и Flex SDK, который позволяет легко использовать возможность автоматической установки. Файл badge.swf может установить среду выполнения и приложение AIR по ссылке с веб-страницы. Файл badge.swf и его исходный код предоставляются для распространения через веб-сайт.

Можно создать собственный SWF-файл, использующий API-интерфейсы файла air.swf для взаимодействия с средой выполнения и приложениями AIR со страницы в обозревателе. Файл air.swf расположен по адресу http://airdownload.adobe.com/air/browserapi/air.swf. Чтобы сослаться на API-интерфейсы файла air.swf из своего SWF-файла, загрузите файл 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 (объект contentLoaderInfo объекта Loader отправляет событие init ), можно вызывать любые API-интерфейсы air.swf, описанные в следующих разделах.

SWF-файл может проверять, установлена ли среда выполнения. Для этого он вызывает метод getStatus( в файле air.swf, загружаемом с домена http://airdownload.adobe.com/air/browserapi/air.swf. Дополнительные сведения см. в разделе « Загрузка файла air.swf ».

После загрузки файла air.swf ваш SWF-файл может вызывать его метод getStatus( ), как показано ниже:

var status:String = airSWF.getStatus();

Метод getStatus() возвращает одно из показанных ниже строковых значений, в зависимости от состояния среды выполнения:

Метод getStatus() возвращает ошибку, если требуемая версия Adobe Flash Player (не ниже версии 9 с обновлением 3 в Windows и Mac OS или версия 10 в Linux) не установлена в обозревателе.

SWF-файл может проверять, установлено ли приложение AIR (с совпадающими ID приложения и ID издателя), с помощью метода getApplicationVersion( ) в файле air.swf, загружаемом с http://airdownload.adobe.com/air/browserapi/air.swf. Дополнительные сведения см. в разделе « Загрузка файла air.swf ».

После загрузки файла air.swf 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. 
    } 
}

Для метода getApplicationVersiom() предусмотрены следующие параметры:

Метод getApplicationVersion() возвращает ошибку, если требуемая версия Adobe Flash Player (не ниже версии 9 с обновлением 3 в Windows и Mac OS или версия 10 в Linux) не установлена в обозревателе.

SWF-файл может устанавливать приложение AIR, вызывая метод installApplication( ) в файле air.swf, загружаемом с http://airdownload.adobe.com/air/browserapi/air.swf . Дополнительные сведения см. в разделе « Загрузка файла air.swf ».

После загрузки файла air.swf ваш 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() работает только при вызове в обработчике пользовательского события, например щелчка мыши.

Метод installApplication() возвращает ошибку, если требуемая версия Adobe Flash Player (не ниже версии 9 с обновлением 3 в Windows и Mac OS или версия 10 в Linux) не установлена в обозревателе.

В Mac OS для установки обновленной версии приложения пользователю требуются права, разрешающие установку в каталог приложений (и администраторские права, если требуется обновить среду выполнения). В Windows пользователю нужны права администратора.

Проверить, установлено ли приложение, можно и с помощью метода getApplicationVersion() файла air.swf. Этот метод можно вызвать или до начала процесса установки приложения, или после его начала. Дополнительные сведения см. в разделе « Проверка наличия установленного AIR с веб-страницы ». Когда приложение уже запущено, оно может взаимодействовать с SWF-содержимым в обозревателе с помощью класса LocalConnection. Дополнительные сведения см. в разделе « Взаимодействие с другим экземплярами Flash Player и AIR » (для разработчиков ActionScript) или « Взаимодействие с другим экземплярами Flash Player и AIR » (для разработчиков HTML).

Для использования функции вызова из обозревателя (разрешающей запуск из обозревателя) в файл дескриптора целевого приложения необходимо включить следующий параметр:

<allowBrowserInvocation>true</allowBrowserInvocation>

Дополнительные сведения о файле дескриптора приложения см. в разделе « Файлы дескриптора приложения AIR ».

SWF-файл может запускать в обозревателе приложение AIR, вызывая метод launchApplication( ) в файле air.swf, загружаемом с http://airdownload.adobe.com/air/browserapi/air.swf. Дополнительные сведения см. в разделе « Загрузка файла air.swf ».

После загрузки файла air.swf ваш 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() работает только при вызове в обработчике пользовательского события, например щелчка мыши.

Метод launchApplication() возвращает ошибку, если требуемая версия Adobe Flash Player (не ниже версии 9 с обновлением 3 в Windows и Mac OS или версия 10 в Linux) не установлена в обозревателе.

Если элемент allowBrowserInvocation имеет значение false в файле дескриптора приложения, вызов метода launchApplication() ни к чему не приведет.

Прежде чем выводить пользовательский интерфейс для запуска приложения, может потребоваться вызвать метод getApplicationVersion( ) в файле air.swf. Дополнительные сведения см. в разделе « Проверка наличия установленного AIR с веб-страницы ».

Когда приложение вызывается с помощью функции вызова из обозревателя, его объект NativeApplication отправляет объект BrowserInvokeEvent. Дополнительные сведения см. в разделе « Вызов приложения AIR из обозревателя » (для разработчиков ActionScript) или « Вызов приложения AIR из обозревателя » (для разработчиков HTML).

Если используется функция вызова обозревателя, не забывайте об ограничениях безопасности. Эти·ограничения·описаны·в разделе « Вызов приложения AIR из обозревателя « (для разработчиков ActionScript) и « Вызов приложения AIR из обозревателя » (для разработчиков HTML).

Когда приложение уже запущено, оно может взаимодействовать с SWF-содержимым в обозревателе с помощью класса LocalConnection. Дополнительные сведения см. в разделе « Взаимодействие с другим экземплярами Flash Player и AIR » (для разработчиков ActionScript) или « Взаимодействие с другим экземплярами Flash Player и AIR » (для разработчиков HTML).