Воспроизведение HDR-видео

HDR (расширенный динамический диапазон) обеспечивает более широкий диапазон цветов и большую контрастность между самыми яркими белыми и самыми темными тенями, в результате чего качество видео более точно соответствует тому, что воспринимает невооруженный глаз.

Вы можете настроить воспроизведение HDR-видео в своем приложении, чтобы просматривать и воспроизводить HDR-видеоконтент.

В этой статье предполагается, что вы уже добавили в приложение базовую поддержку воспроизведения видео. Дополнительную информацию о воспроизведении можно найти в документации по ExoPlayer.

Требования к устройствам

Не все устройства Android поддерживают воспроизведение HDR. Прежде чем воспроизводить HDR-видеоконтент в приложении, убедитесь, что устройство соответствует следующим требованиям:

  • Целевая версия Android – 7.0 или выше (уровень API 24).
  • имеет декодер с поддержкой HDR и доступ к экрану с поддержкой HDR.

Как проверить, поддерживается ли воспроизведение в HDR

Используйте Display.getHdrCapabilities(), чтобы запросить возможности HDR дисплея. Метод возвращает информацию о поддерживаемых профилях HDR и диапазоне яркости для дисплея.

Следующий код проверяет, поддерживает ли устройство воспроизведение HLG10. Начиная с Android 13, HLG10 – это минимальный стандарт, который должны поддерживать производители устройств, если устройство способно воспроизводить 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");
}

Как настроить воспроизведение HDR в приложении

Если в вашем приложении используется ExoPlayer, то воспроизведение HDR поддерживается по умолчанию. Подробнее о том, как проверить, поддерживается ли HDR…

Если в вашем приложении не используется ExoPlayer, настройте воспроизведение HDR-контента с помощью MediaCodec через SurfaceView.

Как настроить MediaCodec с помощью SurfaceView

Настройте стандартный процесс воспроизведения MediaCodec с помощью SurfaceView. Это позволяет показывать видеоконтент HDR без специальной обработки для воспроизведения HDR:

  • MediaCodec: декодирует видеоконтент HDR.
  • SurfaceView: показывает видеоконтент в формате HDR.

Следующий код проверяет, поддерживает ли кодек профиль HDR, а затем настраивает MediaCodec с помощью 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()

Дополнительные примеры реализации MediaCodec с помощью SurfaceView можно найти в примерах использования камеры Android.

Ресурсы

Дополнительную информацию о воспроизведении HDR-видео можно найти в следующих статьях:

HDR

Мультимедиа