顯示 Ultra HDR 圖片

超 HDR 圖片格式可讓圖片儲存更多有關光線強度的資訊，使高亮度和陰影部分呈現更細緻的亮光和色彩。自 Android 14 (API 級別 34) 起，Android 便支援 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。如果圖片沒有增益圖，程式碼會將視窗切換至預設的色彩模式。

KotlinJava
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
 
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 圖片，請參閱下列其他資源：