Phát video HDR

HDR (Dải động cao) mang đến dải màu rộng hơn và độ tương phản cao hơn giữa vùng sáng nhất và vùng tối nhất, giúp chất lượng video gần giống hơn với những gì mắt thường nhìn thấy.

Bạn có thể thiết lập tính năng phát video HDR trong ứng dụng để xem trước và phát lại nội dung video HDR.

Bài viết này giả định rằng bạn đã thêm tính năng hỗ trợ phát video cơ bản vào ứng dụng của mình. Hãy xem tài liệu về ExoPlayer để biết thêm thông tin chi tiết về tính năng phát.

Điều kiện tiên quyết về thiết bị

Không phải thiết bị Android nào cũng hỗ trợ chế độ phát HDR. Trước khi phát nội dung video HDR trong ứng dụng, hãy xác định xem thiết bị của bạn có đáp ứng các điều kiện tiên quyết sau đây hay không:

  • Nhắm đến Android 7.0 trở lên (API cấp 24).
  • Có bộ giải mã hỗ trợ HDR và có quyền truy cập vào màn hình hỗ trợ HDR.

Kiểm tra xem thiết bị có hỗ trợ phát HDR hay không

Sử dụng Display.getHdrCapabilities() để truy vấn các chức năng HDR của màn hình. Phương thức này trả về thông tin về các hồ sơ HDR được hỗ trợ và dải độ sáng cho màn hình.

Mã sau đây kiểm tra xem thiết bị có hỗ trợ phát HLG10 hay không. Kể từ Android 13, HLG10 là tiêu chuẩn tối thiểu mà nhà sản xuất thiết bị phải hỗ trợ nếu thiết bị có khả năng phát HDR:

// Check if display supports the HDR type
val capabilities = display?.hdrCapabilities?.supportedHdrTypes ?: intArrayOf()
if (!capabilities.contains(HDR_TYPE_HLG)) {
  throw RuntimeException("Display does not support desired HDR type");
}

Thiết lập chế độ phát HDR trong ứng dụng

Nếu ứng dụng của bạn sử dụng ExoPlayer, thì ứng dụng đó sẽ hỗ trợ tính năng phát HDR theo mặc định. Hãy xem phần Kiểm tra khả năng hỗ trợ phát HDR để biết các bước tiếp theo.

Nếu ứng dụng của bạn không sử dụng ExoPlayer, hãy thiết lập chế độ phát HDR bằng MediaCodec thông qua SurfaceView.

Thiết lập MediaCodec bằng SurfaceView

Thiết lập quy trình phát MediaCodec chuẩn bằng SurfaceView. Điều này cho phép bạn hiển thị nội dung video HDR mà không cần xử lý đặc biệt cho chế độ phát HDR:

  • MediaCodec: Giải mã nội dung video HDR.
  • SurfaceView: Hiển thị nội dung video HDR.

Mã sau đây kiểm tra xem bộ mã hoá và giải mã có hỗ trợ hồ sơ HDR hay không, sau đó thiết lập MediaCodec bằng SurfaceView:

// Check if there's a codec that supports the specific HDR profile.
val list = MediaCodecList(MediaCodecList.REGULAR_CODECS)
var format = MediaFormat() /* media format from the container */
format.setInteger(MediaFormat.KEY_PROFILE, MediaCodecInfo.CodecProfileLevel.AV1ProfileMain10)
val codecName = list.findDecoderForFormat(format) ?: throw RuntimeException("No codec supports the format")

// Here is a standard MediaCodec playback flow.
val codec: MediaCodec = MediaCodec.createByCodecName(codecName)
val surface: Surface = surfaceView.holder.surface
val callback: MediaCodec.Callback = (
    object : MediaCodec.Callback() {
        override fun onInputBufferAvailable(codec: MediaCodec, index: Int) {
            queue.offer(index)
        }

        override fun onOutputBufferAvailable(
            codec: MediaCodec,
            index: Int,
            info: MediaCodec.BufferInfo
        ) {
            codec.releaseOutputBuffer(index, timestamp)
        }

        override fun onError(codec: MediaCodec, e: MediaCodec.CodecException) {
            // handle error.
        }

        override fun onOutputFormatChanged(
            codec: MediaCodec,
            format: MediaFormat
        ) {
            // handle format change.
        }
    }
    )

codec.setCallback(callback)
codec.configure(format, surface, crypto, 0 /* flags */)
codec.start()
while (/* until EOS */) {
    val index = queue.poll()
    val buffer = codec.getInputBuffer(index)
    buffer?.put(bitstream)
    codec.queueInputBuffer(index, offset, size, timestamp, flags)
}
codec.stop()
codec.release()

Để biết thêm các cách triển khai MediaCodec bằng SurfaceView, hãy xem Mẫu camera Android.

Tài nguyên

Để biết thêm thông tin liên quan đến tính năng phát HDR, hãy xem các tài nguyên sau:

HDR

Nội dung nghe nhìn