顯示 Ultra HDR 圖片

Ultra HDR 圖片格式可讓圖片儲存更多光線強度的資訊，呈現更細緻的亮部和陰影，以及更鮮豔的色彩。Android 從 Android 14 (API 級別 34) 開始支援 Ultra HDR 圖片。如果應用程式在這些版本上執行，請務必設定應用程式，正確顯示這些圖片。另一方面，如果應用程式未顯示 Ultra HDR 圖片，則可不啟用 Ultra HDR 顯示，節省裝置資源。本頁說明如何檢查圖片是否支援 Ultra HDR，以及如何正確顯示圖片。

檢查增益圖是否存在

Ultra HDR 圖片包含增益圖。增益圖可用於判斷圖片中每個像素的亮度增加程度。如要驗證圖片是否為 Ultra HDR 格式，請將圖片或可繪項目轉換為 Bitmap，並呼叫 Bitmap.hasGainMap() (自 Android 14 起提供)，檢查圖片是否有增益圖。

設定視窗以顯示 Ultra HDR

如要以完整動態範圍顯示 Ultra HDR 圖片，請將視窗的色彩模式設為 ActivityInfo.COLOR_MODE_HDR。方法是呼叫視窗的 setColorMode() 方法。(這些 API 適用於 Android 8 以上版本，但只有搭載 Android 14 以上版本的裝置，才會以 Ultra HDR 格式顯示圖片)。

正在統整內容

以下程式碼顯示整個程序。這段程式碼會假設圖片已載入點陣圖，並檢查圖片是否有增益圖。如果是，程式碼會將視窗的色彩模式切換為 COLOR_MODE_HDR。如果圖片沒有增益圖，程式碼會將視窗切換為預設色彩模式。

Kotlin

val bitmap = /* Get Bitmap from Image Resource */
binding.imageContainer.setImageBitmap(bitmap)

// Set color mode of the activity to the correct color mode.
requireActivity().window.colorMode =
   if (bitmap.hasGainmap()) ActivityInfo.COLOR_MODE_HDR else ActivityInfo.COLOR_MODE_DEFAULT

Java

final Bitmap bitmap = /* Get Bitmap from Image Resource */
binding.imageContainer.setImageBitmap(bitmap);

// Set color mode of the activity to the correct color mode.
int colorMode = ActivityInfo.COLOR_MODE_DEFAULT;
if (bitmap.hasGainmap()) colorMode = ActivityInfo.COLOR_MODE_HDR;
requireActivity().getWindow().setColorMode(colorMode);

其他資源

如要進一步瞭解 Ultra HDR 圖片，請參閱下列其他資源：