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