AIR for TV 應用程式設計注意事項

視訊編碼原則

針對傳遞至 AIR for TV 裝置的視訊，Adobe 建議採用 H.264 轉碼器。

StageVideo 類別

AIR for TV 支援直接在硬體中解碼和顯示 H.264 編碼視訊。您可以使用 StageVideo 類別來啟用此功能。

請參閱「ActionScript 3.0 開發人員指南」的 使用硬體加速呈現方式的 StageVideo 類別 ，以取得下列方面的詳細資訊：

為了讓使用 H.264 編碼視訊 Video 物件的現有 AIR 應用程式獲得最佳支援，AIR for TV 會「在內部」使用 StageVideo 物件。此作法可讓視訊播放從硬體解碼和顯示中獲益。不過，Video 物件有著與 StageVideo 物件相同的限制。例如，如果應用程式嘗試旋轉視訊，視訊並不會旋轉，因為視訊是由硬體顯示，而非執行階段。

不過，當您撰寫新的應用程式時，請針對 H.264 編碼視訊使用 StageVideo 物件。

如需 StageVideo 類別的使用範例，請參閱 在電視上傳遞 Flash Platform 的視訊與內容 。

視訊傳遞原則

在 AIR for TV 裝置上播放視訊期間，網路的可用頻寬可能會有所變化。例如，可能有其他使用者開始使用同一條網際網路連線，而使這類變化產生。

因此，Adobe 建議讓視訊傳遞系統使用最適化位元傳輸速率功能。例如，在伺服端上，Flash Media Server 支援最適化位元傳輸速率功能。在用戶端，您可以使用 Open Source Media Framework (OSMF)。

如需詳細資訊，請參閱下列章節：

使用硬體圖形加速

AIR for TV 裝置提供 2D 圖形作業的硬體加速功能。本裝置的硬體圖形加速器會執行下列作業，以減輕 CPU 的負擔：

此硬體圖形加速可讓 AIR for TV 應用程式中的許多圖形作業展現高度效能。其中部分作業包括：

若要運用硬體圖形加速來提高這幾種作業的效能，請採取下列其中一種技術：

如需有關點陣圖快取的詳細資訊，請參閱下列章節：

管理圖形記憶體

為了執行圖形加速作業，硬體加速器會使用特殊的圖形記憶體。如果應用程式用盡所有圖形記憶體，則應用程式執行速度會變慢，因為 AIR for TV 會退一步使用軟體來處理圖形作業。

若要管理應用程式的圖形記憶體使用情形，您可以：

• 在使用完影像或其他點陣圖資料後，釋放相關的圖形記憶體。若要執行這項操作，請呼叫 Bitmap 物件之 bitmapData 屬性的 dispose() 方法。例如：

  myBitmap.bitmapData.dispose();

  備註： 釋放 BitmapData 物件的參考並不會立即釋放圖形記憶體。執行階段的記憶體回收程式最後還是會釋放圖形記憶體，但是呼叫 dispose() 讓應用程式有更大的控制權。

• 使用 Adobe 提供的 AIR 應用程式 PerfMaster Deluxe，充分瞭解目標裝置上的硬體圖形加速。此應用程式會顯示各種作業執行時的每秒影格數。請使用 PerfMaster Deluxe 來比較相同作業的不同實作。例如，比較移動點陣圖影像與移動向量影像有何不同。您可以從 電視版 Flash Platform 取得 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 設為 StageScaleMode.NO_SCALE ，然後偵聽舞台調整大小事件。

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 。您無法改變。

此屬性指定所有 Stage 物件的顯示品質。

反應性

使用下列秘訣，提高 AIR for TV 應用程式的反應性。

易用性

AIR for TV 應用程式的使用者是在「客廳」環境裡。他們會坐在房間裡電視機的另一頭，大約相距 10 英呎。房間有時很暗。他們通常使用遙控器裝置來輸入選擇。可能有多人同時使用應用程式，有時一起使用，有時輪流使用。

因此，若要設計方便在電視上使用的使用者介面，請注意下列幾點：

如需使用遙控器的詳細資訊，請參閱 遙控器輸入處理 。

使用者的個性與期望

AIR for TV 應用程式的使用者通常是要在輕鬆愉快的環境中，享受電視機娛樂。他們不見得具備電腦或技術方面的知識。

因此，請設計具有下列特色的 AIR for TV 應用程式：