Hiển thị hình ảnh Ultra HDR

Định dạng hình ảnh Ultra HDR cho phép hình ảnh lưu trữ nhiều thông tin hơn về cường độ ánh sáng, nhờ đó, các vùng sáng và vùng tối sẽ chi tiết hơn, cũng như màu sắc sẽ sống động hơn. Android hỗ trợ hình ảnh Ultra HDR kể từ Android 14 (API cấp 34). Nếu ứng dụng của bạn đang chạy trên các phiên bản đó, điều quan trọng là bạn phải định cấu hình ứng dụng để hiển thị đúng cách các hình ảnh này. Mặt khác, nếu ứng dụng của bạn không hiển thị hình ảnh Ultra HDR, bạn có thể tiết kiệm tài nguyên thiết bị bằng cách không bật màn hình Ultra HDR. Trang này giải thích cách kiểm tra xem đồ hoạ có hỗ trợ Ultra HDR hay không và cách hiển thị đồ hoạ đúng cách.

Kiểm tra xem có bản đồ tăng cường hay không

Hình ảnh Ultra HDR chứa bản đồ độ lợi. Bản đồ độ lợi được dùng để xác định độ sáng tăng lên của từng pixel trong hình ảnh. Để xác minh xem một hình ảnh có ở định dạng Ultra HDR hay không, hãy chuyển đổi hình ảnh hoặc đối tượng có thể vẽ thành Bitmap và gọi Bitmap.hasGainMap() (có sẵn từ Android 14) để kiểm tra xem hình ảnh đó có bản đồ độ lợi hay không.

Định cấu hình cửa sổ để hiển thị Ultra HDR

Để hiển thị hình ảnh Ultra HDR với dải động đầy đủ, hãy đặt chế độ màu của cửa sổ thành ActivityInfo.COLOR_MODE_HDR. Thực hiện việc này bằng cách gọi phương thức setColorMode() của cửa sổ. (Các API này có sẵn từ Android 8; tuy nhiên, hình ảnh sẽ không hiển thị ở chế độ Ultra HDR trừ phi thiết bị đang chạy Android 14 trở lên.)

Kết hợp kiến thức đã học

Đoạn mã sau đây cho thấy toàn bộ quá trình. Mã này giả định một hình ảnh được tải vào Bitmap và kiểm tra xem hình ảnh có bản đồ độ lợi hay không. Nếu có, mã sẽ chuyển chế độ màu của cửa sổ thành COLOR_MODE_HDR. Nếu hình ảnh không có bản đồ độ lợi, mã sẽ chuyển cửa sổ sang chế độ màu mặc định.

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);

Tài nguyên khác

Để tìm hiểu thêm về hình ảnh Ultra HDR, hãy xem các tài nguyên bổ sung sau đây: