Свойства дескриптора приложений AIR for TV

Как и при разработке других приложений AIR в файле дескриптора приложения задаются базовые свойства приложения. Приложения с профилем ТВ-устройств игнорируют некоторые настройки, относящиеся к настольным системам, например размер окна и прозрачность. В приложениях для целевых устройств с профилем extendedTV можно использовать собственные расширения. Используемые собственные расширения идентифицируются в элементе extensions .

Общие настройки

Некоторые настройки в дескрипторе приложения важны для всех приложений для ТВ-устройств.

Требуемая версия среды выполнения AIR

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

Пространство имен, назначенное элементом application , в большей степени определяет функции, которые используются в приложении. Например, рассмотрите приложение, в котором используется пространство имен AIR 2.5, однако у пользователя установлена более поздняя версия. В этом случае приложение по-прежнему будет видеть поведение AIR 2.5, даже если поведение будущей версии AIR отличается. Приложение получит доступ к новому поведению и функциям только после изменения пространства имен и публикации обновления. Исправления безопасности являются важным исключением из этого правила.

Укажите пространство имен с помощью атрибута xmlns корневого элемента application :

<application xmlns="http://ns.adobe.com/air/application/2.5">

AIR 2.5 — это первая версия AIR, поддерживающая приложения для ТВ-устройств.

Идентификация приложения

Некоторые настройки публикуемых приложений могут быть уникальными. К этим настройкам относятся элементы id , name и filename .

<id>com.example.MyApp</id> 
<name>My Application</name> 
<filename>MyApplication</filename>

Версия приложения

Укажите версию приложения с помощью элемента versionNumber . При указании значения для элемента versionNumber можно использовать последовательность из трех цифр, разделенных точками, например «0.1.2». Каждый сегмент номера версии может содержать до трех цифр (то есть максимальным номером версии может быть «999.999.999»). Номер не обязательно должен включать все три сегмента. Также допускается устанавливать версии «1» и «1.0».

Кроме того, можно задать метку для версии с помощью элемента versionLabel . Если добавлена метка версии, она будет показана вместо номера версии.

<versionNumber>1.23.7<versionNumber> 
<versionLabel>1.23 Beta 7</versionLabel>

Основной SWF-файл приложения

Укажите основной SWF-файл приложения в дочернем элементе versionLabel элемента initialWindow . Если целевое устройство имеет профиль ТВ-устройства, необходимо использовать SWF-файл (приложения на основе HTML не поддерживаются).

<initialWindow> 
    <content>MyApplication.swf</content> 
</initialWindow>

Файл должен быть включен в пакет AIR (с помощью ADT или ИСР). Если только указать имя в дескрипторе приложения, это не позволит автоматически включить файл в пакет.

Свойства главного окна

Исходный вид и поведение главного окна приложения определяют несколько дочерних элементов элемента initialWindow . Несмотря на то что большинство этих свойств игнорируются на устройствах с ТВ-профилем, можно использовать элемент fullScreen :

  • fullScreen — указывает, заполняет ли приложение всю область отображения на устройстве или на экране также отображаются системные элементы, например обычный хром операционной системы.

    <fullScreen>true</fullScreen>

Элемент visible

Элемент visible является дочерним элементом для элемента initialWindow initialWindow AIR for TV игнорирует элемент visible , так как содержимое приложения всегда является видимым на устройствах AIR for TV.

Однако можно задать элементу visible значение true , если приложение также предназначено для компьютеров.

На компьютерах этот элемент по умолчанию имеет значение false . Поэтому если не включить элемент visible , содержимое приложения не будет отображаться на компьютерах. Хотя можно использовать класс ActionScript NativeWindow, чтобы сделать содержимое видимым на компьютерах, профили для ТВ-устройств не поддерживают класс NativeWindow. Если попытаться использовать класс NativeWindow в приложении, выполняемом на устройстве AIR for TV, приложение не загрузится. Независимо от того, вызывается ли метод класса NativeWindow, приложение, в котором используется этот класс, не загружается на устройстве AIR for TV.

Поддерживаемые профили

Если приложение предназначено только для телевизионных устройств, можно запретить его установку на другие типы устройств. Исключите другие профили из списка поддерживаемых в элементе supportedProfiles :

<supportedProfiles>tv extendedTV</supportedProfiles>

Если в приложении используется собственное расширение, включите только профиль extendedTV в список поддерживаемых профилей:

<supportedProfiles>extendedTV</supportedProfiles>

Если элемент supportedProfiles не указан, предполагается, что приложение поддерживает все профили.

Не включайте только профиль tv в список supportedProfiles . Некоторые ТВ-устройства всегда выполняют AIR for TV в режиме, который соответствует профилю extendedTV . Это позволяет AIR for TV выполнять приложения, в которых используются собственные расширения. Если в элементе supportedProfiles указан только профиль tv , этим объявляется, что содержимое несовместимо с режимом AIR for TV для профиля extendedTV . По этой причине некоторые ТВ-устройства не загружают приложения, в которых указан только профиль tv .

Список классов ActionScript, поддерживаемых в профилях tv и extendedTV , представлен в разделе Возможности различных профилей .

Необходимые собственные расширения

Приложения, поддерживающие профиль extendedTV , могут использовать собственные расширения.

Объявите все собственные расширения, которые использует приложение AIR, в дескрипторе приложения, используя элементы extensions и extensionID . В следующем примере показан синтаксис, применяемый для указания требуемых собственных расширений:

<extensions> 
     <extensionID>com.example.extendedFeature</extensionID> 
    <extensionID>com.example.anotherFeature</extensionID> 
</extensions>

Если расширение не указано в списке, приложение не может его использовать.

Значение элемента extensionID совпадает со значением элемента id в файле дескриптора расширения. Файл дескриптора расширения — это файл XML с именем extension.xml. Он упакован в ANE-файл, получаемый от производителя устройства.

Если расширение перечислено в элементе extensions , но не установлено на устройстве AIR for TV, приложение не сможет работать. Исключением из этого правило является случай, когда ANE-файл, упакованный с приложением AIR for TV имеет фиктивный модуль расширения. В таком случае приложение может выполняться и использовать фиктивный модуль расширения. Фиктивная версия содержит код ActionScript без собственного кода.

Значки приложения

Требования к значкам приложений для телевизионных устройств зависят от конкретных устройств. Например, производитель устройств указывает следующую информацию:
  • Требуемые значки и размеры значков.

  • Требуемые типы файлов и правила именования.

  • Порядок предоставления значков для приложения, например, требуется ли включать значки в пакет приложения.

  • Необходимость указания значков в элементе icon в файле дескриптора приложения.

  • Поведение в случае, когда приложение не предоставляет значков.

Для получения дополнительной информации свяжитесь с производителем устройства.

Игнорируемые настройки

Приложения на телевизионных устройствах игнорируют настройки приложения, которые относятся к мобильным устройствам, собственным окнам или функциям операционной системы настольного компьютера. Игнорируются следующие настройки:

  • allowBrowserInvocation

  • aspectRatio

  • autoOrients

  • customUpdateUI

  • fileTypes

  • height

  • installFolder

  • maximizable

  • maxSize

  • minimizable

  • minSize

  • programMenuFolder

  • renderMode

  • resizable

  • systemChrome

  • title

  • transparent

  • visible

  • width

  • x

  • y