在行動裝置上播放高動態範圍 (HDR) 影片時，經常會遇到重大瑕疵：不同面板的視覺效果不一致。瀏覽混合內容動態消息時，標準動態範圍 (SDR) 和 HDR 元素會同時存在，導致算繪管道難以平衡兩者。這會導致過渡效果不穩定、不流暢，以及亮度突然升高。
對內容創作者而言，這種不一致性會影響藝術意圖。在專業螢幕上經過細心調校的 HDR 影片，在一般裝置上播放時，可能會出現亮部剪裁、色調黯淡或陰影過暗等問題。
Eclipsa 影片是現代 HDR 影片標準，專門解決這些跨裝置生態系統的挑戰。Eclipsa 影片以 SMPTE ST 2094-50 規格為基礎，可讓螢幕根據實體硬體功能和即時環境照明條件，動態調整內容對應。Eclipsa 影片由 Jetpack Media3 ExoPlayer 和標準 Camera2 擷取管道內建的零設定整合功能提供支援，可為行動工程團隊提供零成本、無摩擦的路徑，實作新一代硬體適應性影片串流，在每個螢幕上保留藝術意圖。
SMPTE ST 2094-50 的技術架構
行動裝置螢幕的亮度上限差異極大，也就是螢幕參考白點以上的可用亮度。如果螢幕的硬體限制與 HDR 影片的母帶製作需求不符，亮部就會遭到剪除或顯得黯淡。螢幕的實際亮度上限和參考白點會隨著環境光感應器調整面板，動態配合周遭環境。
SMPTE ST 2094-50 導入雙層中繼資料，透過兩大主要支柱確保視覺效果一致性，解決上述問題：
參考白色錨點
這項機制會建立嚴格的基準，將 SDR 元素的峰值亮度直接對應至螢幕的參考白點。任何超過這個錨點的亮度值都嚴格保留給 HDR 亮部。這種可預測的錨定機制可確保 SDR 和 HDR 圖層在螢幕上合成時，能維持預期的視覺關係，不會互相沖淡。
進步空間適應性增益曲線 (AGTM)
創作者會嵌入參數式中繼資料，指示顯示管道在可用動態範圍有限時，應如何精確縮放，而不是強制使用靜態色調對應曲線。這項標準可讓創作者精細地選擇目標面板應柔和剪除亮部、硬性剪除亮部，還是壓縮中間色調和陰影，主動保留亮部區域的細節。
平台支援
Android 17 (API 級別 37) 導入了平台層級的 Eclipsa 影片播放和擷取支援。
實作播放功能
如果是標準應用程式開發作業，Media3 ExoPlayer 會提供 Eclipse 影片的現成支援。剖析內嵌 SMPTE 2094-50 中繼資料的檔案時，ExoPlayer 會順暢地擷取及套用中繼資料，不需要自訂播放器設定。
標準播放器初始化：如要例項化播放器介面，請參閱「Media3 ExoPlayer 總覽」。
追蹤覆寫：如果應用程式以程式輔助方式查詢或鎖定特定 HDR 設定檔，請參閱 Media3 軌道選取 API。
建議將播放管道卸載至 Jetpack Media3。ExoPlayer 會原生處理低階容器擷取作業，完全略過 Android 16 (API 級別 36) 以下版本舊版算繪層中已知的平台層級解碼構件。
實作影片擷取功能
如要從裝置錄製 Eclipsa 影片，必須設定攝影機管道，指派相容的動態範圍設定檔，產生 AGTM 中繼資料。
使用 CameraCharacteristics 驗證裝置支援後，請使用 DynamicRangeProfiles.HLG10_SMPTE_2094_50 設定檔將串流傳送至編碼器介面。如需在攝影機工作階段中查詢及設定動態範圍設定檔的操作說明，請參閱「HDR 影片拍攝」。
AGTM 中繼資料不需要明確的轉碼器設定。如果現用動態設定檔中存在中繼資料，Android 媒體架構會自動附加並傳遞中繼資料。
相容性和效能注意事項
如要監控效能，請擷取有效的 Display 物件，並檢查其 overlayProperties 上的 LutProperties，找出硬體加速路徑的可用性。
對於不具備硬體加速功能的裝置，我們正在開發相關支援，讓您在 Exoplayer 中選擇停用 Eclipsa 影片轉譯功能。