Setting AIR for TV application propertiesAs with other AIR applications, you set the basic application properties in the application descriptor file. TV profile applications ignore some of the desktop-specific properties, such as window size and transparency. Applications targeting devices in the extended TV profile can use AIR native extensions and must identify the extensions used in an extensions element. Common settingsSeveral application descriptor settings are important for all TV profile applications. Required AIR runtime versionSpecify the version of the AIR runtime required by your application using the namespace of the application descriptor file. The namespace, assigned in the application element, determines, in large part, which features your application can use. For example, if your application uses the AIR 2.5 namespace, and the user has some future version installed, then your application will still see the AIR 2.5 behavior (even if the behavior has been changed in the future version). Only when you change the namespace and publish an update will your application have access to the new behavior and features. Security fixes are an important exception to this rule. Specify the namespace using the xmlns attribute of the root application element: <application xmlns="http://ns.adobe.com/air/application/2.5"> AIR 2.5 is the first version of AIR to support TV applications. Application identitySeveral settings should be unique for each application that you publish. These include the ID, the name, and the filename. <id>com.example.MyApp</id> <name>My Application</name> <filename>MyApplication</filename> Application versionSpecify the application version in the versionNumber element. When specifying a value for versionNumber, you can use a sequence of up to three numbers separated by dots, such as: “0.1.2”. Each segment of the version number can have up to three digits. (In other words, “999.999.999” is the largest version number permitted.) You do not have to include all three segments in the number; “1” and “1.0” are legal version numbers as well. You can also specify a label for the version using the versionLabel element. When you add a version label it is displayed instead of the version number . <versionNumber>1.23.7<versionNumber> <versionLabel>1.23 Beta 7</versionLabel> Main application SWFSpecify the main application SWF file in the content child of the initalWindow element. When you target devices in the tv profile, you must use a SWF file (HTML-based applications are not supported). <initialWindow>
<content>MyApplication.swf</content>
</initialWindow>
You must include the file in the AIR package (using ADT or your IDE). Simply referencing the name in the application descriptor does not cause the file to be included in the package automatically. Main screen propertiesSeveral child elements of the initialWindow element control the initial appearance and behavior of the main application screen. While most of these properties are ignored on devices in the TV profiles, you can use the fullScreen element:
Supported profilesIf your application only makes sense on a television device, then you can prevent an AIR file from being installable on other types of computing devices by excluding the other profiles from the supported list: <supportedProfiles>tv</supportedProfiles> Applications using an extension library must support the extendedTV profile: <supportedProfiles>extendedTV</supportedProfiles> If you omit the supportedProfiles element, then the application is assumed to support all profiles. For a list of ActionScript classes supported in the tv and extendedTV profiles, see Capabilities of different profiles. Required extensionsApplications that support the extendedTV profile can use ActionScript extensions to access All extensions used by an AIR application must be declared in the application descriptor. The following example illustrates the syntax for specifying two required extensions: <extensions>
<extensionID>com.example.extendedFeature</extensionID>
<extensionID>com.example.anotherFeature</extensionID>
</extensions>
Use the extension ID from the extension descriptor Ignored settingsApplications on television devices ignore application settings that apply to mobile, native window, or desktop operating system features. The ignored settings are:
|
|