ExtensionContext  - AS3

Объект ActionScript (если таковой имеется), связанный с данным контекстом.

Можно связать любой объект ActionScript с экземпляром ExtensionContext. В собственной реализации можно также получать и задавать этот объект ActionScript. Поэтому можно использовать метод actionScriptData для совместного использования данных на стороне ActionScript и собственной стороне расширения.

Можно также установить значение actionScriptData, равное null.

Вызывает собственную функцию, указанную в functionName. Любые дополнительные аргументы передаются в собственную функцию.

Параметры

Создает экземпляр 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 для телевизионных устройств, начиная с AIR 2.5, в приложениях, использующих профиль приложения extendedTV.

Встроенное расширение представляет собой комбинацию следующих элементов:

• Классы ActionScript.
• Собственный код. Собственный код — это код, который выполняется на устройстве вне среды выполнения. Например, код, который написан на языке C, является собственным кодом.

Можно создать встроенное расширение, чтобы:

• предоставить приложению AIR доступ к определенным возможностям устройства;
• многократно использовать существующий собственный код;
• обеспечить более эффективную обработку с использованием собственного кода, чем при использовании кода ActionScript.

Используйте класс ExtensionContext на стороне расширения ActionScript для доступа к собственной части расширения. Сначала создайте экземпляр класса ExtensionContext. Для этого вызовите статический метод ExtensionContext.createExtensionContext().

После создания экземпляра ExtensionContext используйте метод call() экземпляра для вызова собственной функции.

По завершении работы с экземпляром ExtensionContext вызовите метод dispose() для освобождения любых связанных собственных ресурсов. Без явного вызова метода dispose() «сборщик мусора» среды выполнения вызывает метод dispose() при удалении экземпляра. Явный вызов метода dispose(), как правило, происходит гораздо быстрее запуска функции «сборщик мусора».

Экземпляр ExtensionContext может прослушивать события StatusEvent, которые отправляет собственный код в случае возникновения некоторых асинхронных событий в собственной реализации расширения. Так как класс ExtensionContext является производным от класса EventDispatcher, он может в свою очередь отправлять события.

Это событие имеет следующие свойства: