对于其他 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)。如果只是引用应用程序描述符中的名称,不会自动将此文件包括进包中。
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 代码,但无本机代码。
应用程序图标
对电视设备中应用程序图标的要求与设备有关。例如,设备制造商指定:
有关详细信息,请咨询设备制造商。
忽略的设置
电视设备上的应用程序会忽略应用于移动设备、本机窗口或桌面操作系统功能的应用程序设置。忽略的设置包括:
-
allowBrowserInvocation
-
aspectRatio
-
autoOrients
-
customUpdateUI
-
fileTypes
-
height
-
installFolder
-
maximizable
-
maxSize
-
minimizable
-
minSize
-
programMenuFolder
-
renderMode
-
resizable
-
systemChrome
-
title
-
transparent
-
visible
-
width
-
x
-
y
|
|
|