AIR for TV 应用程序描述符属性

对于其他 AIR 应用程序,可以在应用程序描述符文件中设置基本应用程序属性。TV 配置文件应用程序会忽略某些特定于桌面的属性,例如窗口大小和透明度。面向 extendedTV 配置文件中的设备的应用程序可以使用本机扩展。这些应用程序可识别 extensions 元素中使用的本机扩展。

通用设置

某些应用程序描述符设置对所有 TV 配置文件应用程序都很重要。

所需的 AIR 运行时版本

使用应用程序描述符文件的命名空间指定应用程序所需的 AIR 运行时版本。

在 application 元素中分配的命名空间,很大程度上决定了应用程序可以使用哪些功能。 例如,假设有一个应用程序使用的是 AIR 2.5 命名空间,但是用户却安装了某个未来版本。在这种情况下,应用程序仍遵循 AIR 2.5 行为,即使该行为在 AIR 的未来版本中已改变。只有当您更改命名空间并发布更新时,应用程序才会访问新的行为和功能。不过,安全修补程序不受此规则限制。

使用 application 根元素的 xmlns 属性指定命名空间:

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

AIR 2.5 是第一个支持 TV 应用程序的 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

在 versionLabel 元素的 initialWindow 子元素中指定主应用程序 SWF 文件。在 TV 配置文件中定位设备时,必须使用 SWF 文件(不支持基于 HTML 的应用程序)。

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

必须包括 AIR 包中的文件(使用 ADT 或 IDE)。如果只是引用应用程序描述符中的名称,不会自动将此文件包括进包中。

主屏幕属性

initialWindow 元素的一些子元素可控制主应用程序屏幕的初始外观和行为。 尽管在 TV 配置文件中的设备上会忽略其中大多数属性,但是可以使用 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 元素,则会假定应用程序支持所有配置文件。

请勿在 supportedProfiles 列表中 只 包含 tv 配置文件。一些电视设备始终以与 extendedTV 配置文件对应的模式运行 AIR for TV。正是由于这种行为才使得 AIR for TV 能够运行使用本机扩展的应用程序。如果您的 supportedProfiles 元素只指定了 tv ,则表示您的内容与 AIR for TV 的 extendedTV 模式不兼容。因此,一些电视设备无法加载只指定了 tv 配置文件的应用程序。

有关 tv 和 extendedTV 配置文件中支持的 ActionScript 类列表,请参阅 不同配置文件的功能 。

必需的本机扩展

支持 extendedTV 配置文件的应用程序可以使用本机扩展。

使用 extensions 和 extensionID 元素声明 AIR 应用程序用于应用程序描述符的所有本机扩展。下面的例子说明了用于指定两个所需本机扩展的语法:

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

如果未列出某扩展,则应用程序将无法使用它。

extensionID 元素的值与扩展描述符文件中的 id 元素的值相同。扩展描述符文件是一个名为 extension.xml 的 XML 文件。已打包在从设备制造商处接收到的 ANE 文件中。

如果在 extensions 元素中列出了某扩展,但是 AIR for TV 设备未安装此扩展,则应用程序将无法运行。此规则的例外情况是,如果和 AIR for TV 应用程序打包在一起的 ANE 文件拥有扩展的存根版本,则此规则失效。如果是这种情况,应用程序将可以运行,它将使用扩展的存根版本。存根版本具有 ActionScript 代码,但无本机代码。

应用程序图标

对电视设备中应用程序图标的要求与设备有关。例如,设备制造商指定:
  • 所需的图标和图标大小。

  • 所需的文件类型和命名约定。

  • 如何为应用程序提供图标,例如,是否将图标与应用程序一起打包。

  • 是否在应用程序描述符文件的 icon 元素中指定图标。

  • 当应用程序未提供图标时的行为。

有关详细信息,请咨询设备制造商。

忽略的设置

电视设备上的应用程序会忽略应用于移动设备、本机窗口或桌面操作系统功能的应用程序设置。忽略的设置包括:

  • allowBrowserInvocation

  • aspectRatio

  • autoOrients

  • customUpdateUI

  • fileTypes

  • height

  • installFolder

  • maximizable

  • maxSize

  • minimizable

  • minSize

  • programMenuFolder

  • renderMode

  • resizable

  • systemChrome

  • title

  • transparent

  • visible

  • width

  • x

  • y