Доступ к классам API-интерфейса AIR из JavaScript

Adobe AIR 1.0 и более новых версий

Помимо стандартного и расширенного элементов Webkit, код HTML и JavaScript имеет доступ к домашним классам среды выполнения. Эти классы разрешают доступ к расширенным функциям AIR, некоторые из которых перечислены ниже:

  • Доступ к файловой системе

  • Использование локальных баз данных SQL

  • Управление меню приложений и окон

  • Доступ к сокетам для работы в сети

  • Использование заданных пользователем классов и объектов

  • Звуковые возможности

    Например, API-интерфейс файла AIR включает класс File, содержащийся в пакете flash.filesystem. Объект File создается в JavaScript следующим образом: 

    var myFile = new window.runtime.flash.filesystem.File();

    Объект runtime является особым объектом JavaScript, который доступен HTML-содержимому в изолированной программной среде приложения AIR. С его помощью можно получать доступ из JavaScript к классам среды выполнения. Свойство flash объекта runtime предоставляет доступ к flash-пакету. В свою очередь, свойство flash.filesystem объекта runtime обеспечивает доступ к пакету flash.filesystem (а он содержит класс File). Пакеты помогают организовать классы ActionScript.

    Примечание. Свойство runtime автоматически не добавляется к объектам window страниц, загружаемых в элементы frame или iframe. Тем не менее, пока дочерний документ находится в изолированной программной среде приложения, он имеет доступ к свойству runtime своего родителя.

    Так как структура пакета классов среды выполнения требует вводить длинные строки кода JavaScript для доступа к каждому из классов (например, window.runtime.flash.desktop.NativeApplication), в комплект AIR SDK включен файл AIRAliases.js, который открывает доступ к классам среды выполнения более простым способом (например, с помощью записи air.NativeApplication).

    Классы API-интерфейса AIR рассматриваются в разных частях данного руководства. Другие классы API-интерфейса проигрывателя Flash Player, которые могут быть полезны разработчикам, описаны в справочнике по API-интерфейсу Adobe AIR для HTML-разработчиков. Язык ActionScript используется в SWF-содержимом (проигрывателе Flash Player). Синтаксисы JavaScript и ActionScript похожи. (И тот, и другой основаны на разных версиях языка ECMAScript.) Все встроенные классы доступны как для языка JavaScript (в HTML-содержимом), так и для языка ActionScript (в SWF-содержимом).

    Примечание. В коде JavaScript нельзя использовать классы Dictionary, XML и XMLList, которые доступны в ActionScript.