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
- Запись HDR-видео. Узнайте, как настроить запись HDR-видео с помощью Camera2 API.
- Пример Camera2Video на GitHub. Посмотрите, как работает приложение с функциями записи и воспроизведения HDR-видео.
Мультимедиа
- Документация по Media API – подробная информация о Media API.
- ExoPlayer. Узнайте, как настроить приложение с помощью библиотеки ExoPlayer.