AIR for TV 应用程序设计注意事项

视频编码准则

对于传送到 AIR for TV 设备的视频，Adobe 建议使用 H.264 编解码器。

StageVideo 类

AIR for TV 支持对 H.264 编码的视频进行硬件解码并呈现。使用 StageVideo 类可以启用此功能。

请参阅 ActionScript 3.0 开发人员指南 中的 使用 StageVideo 类实现硬件加速呈现 ，了解以下详细信息：

为了更好地支持使用 Video 对象播放 H.264 编码的视频的现有 AIR 应用程序， AIR for TV 将在 内部 使用 StageVideo 对象。这样做意味着可以利用硬件解码和呈现实现视频播放。但是，Video 对象与 StageVideo 对象具有相同的限制。例如，如果应用程序试图旋转视频，但却无法旋转，这是因为正在使用硬件而非运行时呈现视频。

不过，在编写新应用程序时，请使用 StageVideo 对象来播放 H.264 编码的视频。

有关使用 StageVideo 类的示例，请参阅 在电视上传送 Flash Platform 的视频和内容 。

视频传输指南

在 AIR for TV 设备上，视频播放期间网络的可用带宽可能会发生变化。例如，当另一个用户开始使用同一 Internet 连接时，可用带宽可能会发生变化。

因此，Adobe 建议在您的视频传输系统中采用自适应比特率功能。例如，在服务器端，Flash Media Server 支持自适应比特率功能。在客户端，可以使用开源媒体框架 (OSMF)。

有关详细信息，请参阅以下内容：

使用硬件图形加速

AIR for TV 设备为 2D 图形操作提供了硬件加速功能。设备的硬件图形加速器可以代替 CPU 执行以下操作：

这种硬件图形加速意味着在 AIR for TV 应用程序中，可以更加高效地执行许多图形操作。其中的一些操作包括：

若要获得此类操作的硬件图形加速性能优势，请使用以下方法之一：

有关位图缓存的详细信息，请参阅以下内容：

管理图形内存

要执行加速图形操作，硬件加速器会使用专用的图形内存。如果应用程序使用了所有图形内存，则应用程序的运行速度会变慢，因为 AIR for TV 会恢复为使用软件执行图形操作。

管理应用程序对图形内存的使用：

• 使用完图像或其他位图数据后，请释放相关的图形内存。若要释放图形内存，请调用 Bitmap 对象 bitmapData 属性的 dispose() 方法。例如：

  myBitmap.bitmapData.dispose();

  注： 释放对 BitmapData 对象的引用不会立即释放图形内存。运行时的垃圾回收器最终会释放图形内存，但是调用 dispose() 可为应用程序提供更多控制手段。

• 使用 PerfMaster Deluxe（Adobe 提供的 AIR 应用程序）可更好地了解目标设备上的硬件图形加速功能。此应用程序可显示执行各种操作的每秒帧数。使用 PerfMaster Deluxe 可比较相同操作的不同实现。例如，比较移动位图图像与移动矢量图像。 Flash Platform for TV 提供了 PerfMaster Deluxe。

管理显示列表

要使某个显示对象不可见，请将该对象的 visible 属性设置为 false 。则该对象仍在显示列表中，但 AIR for TV 不会呈现或显示它。此技术对于在视图中来回频繁显示的对象非常有用，因为它只产生少量的处理开销。但是，将 visible 属性设置为 false 不会释放任何对象资源。因此，当您完成某个对象的显示或至少将其显示较长一段时间时，请从显示列表中删除该对象。此外，将对该对象的所有引用设置为 null 。这些操作允许垃圾回收器释放对象资源。

屏幕分辨率

目前，电视设备通常具有以下屏幕分辨率之一：540p、720p 和 1080p。这些屏幕分辨率对应于 ActionScript Capabilities 类中的以下值：

若要针对特定设备编写 AIR for TV 全屏应用程序，请将 Stage.stageWidth 和 Stage.stageHeight 硬编码为设备的屏幕分辨率。但是，若要编写可在多种设备上运行的全屏应用程序，请使用 Capabilities.screenResolutionX 和 Capabilities.screenResolutionY 属性设置舞台尺寸。

例如：

stage.stageWidth = Capabilities.screenResolutionX; 
stage.stageHeight = Capabilities.screenResolutionY;

安全观看区域

电视机上的 安全观看区域 是指沿屏幕边缘向内缩放而形成的一个屏幕区域。该区域的内缩距离足够大，可确保最终用户能够看到整个区域，而不会被电视外壳的边缘所遮盖。由于电视外壳边缘（形成屏幕的物理边框）的宽度因制造商而异，因此所需的内缩距离也会有所不同。安全观看区域试图保证屏幕可见区域的准确性。安全观看区域也称为 标题安全区域 。

过扫描 区域是指被外壳边缘遮盖的不可见屏幕区域。

Adobe 建议在屏幕的每个边缘向内缩放 7.5%。例如：

查看完全大小图形

1920 x 1080 屏幕分辨率的安全观看区域

在设计 AIR for TV 全屏应用程序时，应始终考虑安全观看区域：

下表显示了各种典型屏幕分辨率的安全观看区域尺寸（使用 7.5％ 内缩比例）。

但是，最佳做法是始终动态计算安全观看区域的尺寸。例如：

var horizontalInset, verticalInset, safeAreaWidth, safeAreaHeight:int; 
 
horizontalInset = .075 * Capabilities.screenResolutionX; 
verticalInset = .075 * Capabilities.screenResolutionY; 
safeAreaWidth = Capabilities.screenResolutionX - (2 * horizontalInset); 
safeAreaHeight = Capabilities.screenResolutionY - (2 * verticalInset);

舞台缩放模式

将 Stage.scaleMod e 设置为 StageScaleMode.NO_SCALE ，并侦听舞台的 resize 事件。

stage.scaleMode = StageScaleMode.NO_SCALE; 
stage.addEventListener(Event.RESIZE, layoutHandler);

此设置使舞台坐标与像素坐标相同。将此设置与 FULL_SCREEN_INTERACTIVE 显示状态和 TOP_LEFT 舞台对齐方式结合使用，可以有效地使用安全观看区域。

具体来说，在全屏应用程序中，此缩放模式意味着 Stage 类的 stageWidth 和 stageHeight 属性与 Capabilities 类的 screenResolutionX 和 screenResolutionY 属性相对应。

此外，当应用程序的窗口大小发生更改时，舞台内容会保持所定义的大小。运行时不执行任何自动布局或缩放。此外，当窗口大小发生更改时，运行时会调度 Stage 类的 resize 事件。因此，当启动应用程序时以及当调整应用程序窗口大小时，您可以完全控制如何调整应用程序的内容。

舞台对齐方式

将 Stage.align 设置为 StageAlign.TOP_LEFT ：

stage.align = StageAlign.TOP_LEFT; 

此对齐方式将 0,0 坐标放置在屏幕的左上角，这便于使用 ActionScript 放置内容。

将此设置与 NO_SCALE 缩放模式和 FULL_SCREEN_INTERACTIVE 显示状态结合使用，可以有效地使用安全观看区域。

舞台显示状态

在 AIR for TV 全屏应用程序中，将 Stage.displayState 设置为 StageDisplayState.FULL_SCREEN_INTERACTIVE ：

stage.displayState = StageDisplayState.FULL_SCREEN_INTERACTIVE; 

设置该值后，AIR 应用程序将扩展舞台以覆盖整个屏幕（允许用户输入）。

Adobe 建议您使用 FULL_SCREEN_INTERACTIVE 设置。将此设置与 NO_SCALE 缩放模式和 TOP_LEFT 舞台对齐方式结合使用，可以有效地使用安全观看区域。

因此，对于全屏应用程序，在主文档类的 ADDED_TO_STAGE 事件的处理函数中，请执行以下操作：

private function onStage(evt:Event):void 
{ 
    stage.scaleMode = StageScaleMode.NO_SCALE; 
    stage.align = StageAlign.TOP_LEFT; 
    stage.addEventListener(Event.RESIZE, onResize); 
    stage.displayState = StageDisplayState.FULL_SCREEN_INTERACTIVE; 
}

然后，在 RESIZE 事件的处理函数中：

private function onResize(evt:Event):void 
{ 
    if ((Capabilities.screenResolutionX == stage.stageWidth) && 
        (Capabilities.screenResolutionY == stage.stageHeight)) 
    { 
         
        // Calculate and save safe viewing area dimensions. 
    } 
}

当舞台尺寸等于 Capabilities.screenResolutionX 和 screenResolutionY 时，AIR for TV 会使硬件为您的视频和图形传递可能的最佳保真度。

多种屏幕尺寸设计

您可以按相同方式开发可在多种 AIR for TV 设备上正常运行并显示的 AIR for TV 全屏应用程序。请执行以下操作：

1. 将舞台属性 scaleMode 、 align 和 displayState 分别设置为推荐值： StageScaleMode.NO_SCALE 、 StageAlign.TOP_LEFT 和 StageDisplayState.FULL_SCREEN_INTERACTIVE 。

2. 根据 Capabilities.screenResolutionX 和 Capabilities.screenResolutionY 设置安全观看区域。

3. 根据安全观看区域的宽度和高度调整您的内容的大小布局。

   虽然您的内容对象非常庞大（尤其是与移动设备应用程序相比），但是诸如动态布局、相对定位和自适应内容之类的概念是相同的。有关 ActionScript 对这些概念的支持的详细信息，请参阅 针对多种屏幕大小创作移动 Flash 内容 。

舞台品质

AIR for TV 应用程序的 Stage.quality 属性始终为 StageQuality.High 。您无法更改它。

此属性指定所有舞台对象的呈现品质。

响应性能

使用以下技巧尽量提高 AIR for TV 应用程序的响应能力。

易用性

AIR for TV 应用程序的用户处于“客厅”环境中。他们坐在电视机的对面，离电视机大约 3 米远。客厅内有时会很黑暗。用户通常使用遥控设备进行输入。会有多个人使用应用程序，有时同时使用，有时交替使用。

因此，为改善用户界面在电视上的易用性，请在设计时考虑以下事项：

有关使用遥控器的更多信息，请参阅 遥控器输入处理 。

用户的个性和期望

考虑到 AIR for TV 应用程序的用户通常是在娱乐性的轻松环境中寻求高品质的电视娱乐。他们不一定熟练掌握相关计算机或技术知识。

因此，在设计 AIR for TV 应用程序时，应遵循以下原则：