顯示 Ultra HDR 圖片

Ultra HDR 圖片格式可讓圖片儲存更多關於光強度的資訊，進而產生較詳細的高亮度和陰影，以及更強烈的色彩。Android 支援從 Android 14 (API 級別 34) 開始的 Ultra HDR 圖片。如果您的應用程式是在這些版本上執行，請務必設定應用程式，使其能夠正確顯示這些圖片。另一方面，如果您的應用程式未顯示 Ultra HDR 圖片，您不必啟用 Ultra HDR 顯示功能，藉此儲存裝置資源。本頁面說明如何檢查圖像是否支援 Ultra HDR，以及如何正確顯示圖像。

圖片顯示標準動態範圍與高動態範圍之間的差異。這張圖片顯示多雲的天空。右半部是模擬 HDR 動畫的畫面，亮度更明亮、陰影部分更暗，色彩更清晰。
圖 1 模擬標準動態範圍 (SDR) 和高動態範圍 (HDR) 圖像之間的差異。如果裝置支援 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 圖片，請參閱下列其他資源：