Reproducción de video HDR

El HDR, o alto rango dinámico, proporciona un rango de colores más amplio y un mayor contraste entre los blancos más brillantes y las sombras más oscuras, lo que da como resultado una calidad de video que se asemeja más a lo que percibe el ojo humano.

Puedes configurar la reproducción de video en HDR en tu app para obtener una vista previa y reproducir contenido de video en HDR.

En este artículo, se supone que ya agregaste compatibilidad básica con la reproducción de videos a tu app. Consulta la documentación de ExoPlayer para obtener más detalles sobre la reproducción.

Requisitos previos del dispositivo

No todos los dispositivos Android admiten la reproducción en HDR. Antes de reproducir contenido de video en HDR en tu app, determina si tu dispositivo cumple con los siguientes requisitos previos:

  • Se orienta a Android 7.0 o versiones posteriores (nivel de API 24).
  • Tiene un decodificador compatible con HDR y acceso a una pantalla compatible con HDR.

Cómo verificar la compatibilidad con la reproducción en HDR

Usa Display.getHdrCapabilities() para consultar las capacidades de HDR de una pantalla. El método devuelve información sobre los perfiles HDR compatibles y el rango de luminancia de la pantalla.

En el siguiente código, se verifica si el dispositivo admite la reproducción de HLG10. A partir de Android 13, HLG10 es el estándar mínimo que deben admitir los fabricantes de dispositivos si el dispositivo es compatible con la reproducción de 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");
}

Configura la reproducción en HDR en tu app

Si tu app usa ExoPlayer, admite la reproducción en HDR de forma predeterminada. Consulta Cómo verificar la compatibilidad con la reproducción en HDR para conocer los próximos pasos.

Si tu app no usa ExoPlayer, configura la reproducción de HDR con MediaCodec a través de SurfaceView.

Cómo configurar MediaCodec con SurfaceView

Configura un flujo de reproducción estándar de MediaCodec con SurfaceView. Esto te permite mostrar contenido de video HDR sin ningún control especial para la reproducción en HDR:

  • MediaCodec: Decodifica contenido de video en HDR.
  • SurfaceView: Muestra contenido de video en HDR.

El siguiente código verifica si el códec admite el perfil HDR y, luego, configura MediaCodec con 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()

Para obtener más implementaciones de MediaCodec con SurfaceView, consulta las muestras de la cámara de Android.

Recursos

Para obtener más información relacionada con la reproducción de HDR, consulta los siguientes recursos:

HDR

Medios