Reproducción de video HDR

El HDR, o alto rango dinámico, proporciona un rango más amplio de colores 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 parece más a lo que percibe a simple vista.

Puedes configurar la reproducción de video 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 video en 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 HDR en la app, determina si el dispositivo cumple con los siguientes requisitos previos:

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

Cómo comprobar la compatibilidad con la reproducción HDR

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

El siguiente código verifica si el dispositivo admite la reproducción HLG10. A partir de Android 13, HLG10 es el estándar mínimo que deben admitir los fabricantes de dispositivos si son compatibles con la reproducción en HDR:

Kotlin

// 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");
}

Java

// Check if display supports the HDR type
int[] list = getDisplay().getHdrCapabilities().getSupportedHdrTypes();
List capabilities = Arrays.stream(list).boxed().collect(Collectors.toList());
if (!capabilities.contains(HDR_TYPE_HLG)) {
 throw new RuntimeException("Display does not support desired HDR type");
}

Cómo configurar la reproducción HDR en tu app

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

Si la app no usa ExoPlayer, configura la reproducción HDR con MediaCodec mediante SurfaceView.

Cómo configurar MediaCodec con SurfaceView

Configura un flujo de reproducción estándar de MediaCodec con SurfaceView. De esta manera, podrás mostrar contenido de video en HDR sin tener que realizar ningún control especial para su reproducción:

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

El siguiente código verifica si el códec admite el perfil HDR y, luego, configura MediaCodec usando SurfaceView:

Kotlin

// 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(/* write bitstream */)
   codec.queueInputBuffer(index, offset, size, timestamp, flags)
}
codec.stop()
codec.release()

Java

// Check if there's a codec that supports the specific HDR profile
MediaCodecList list = new MediaCodecList(MediaCodecList.REGULAR_CODECS);
MediaFormat format = /* media format from the container */;
format.setInteger(
    MediaFormat.KEY_PROFILE, CodecProfileLevel.AV1ProfileMain10);
String codecName = list.findDecoderForFormat(format);
if (codecName == null) {
    throw new RuntimeException("No codec supports the format");
}

// Below is a standard MediaCodec playback flow
MediaCodec codec = MediaCodec.getCodecByName(codecName);
Surface surface = surfaceView.getHolder().getSurface();
MediaCodec.Callback callback = new MediaCodec.Callback() {
    @Override
    void onInputBufferAvailable(MediaCodec codec, int index) {
        queue.offer(index);
    }

    @Override
    void onOutputBufferAvailable(MediaCodec codec, int index) {
        // release the buffer for render
        codec.releaseOutputBuffer(index, timestamp);
    }

    @Override
    void onOutputFormatChanged(MediaCodec codec, MediaFormat format) {
        // handle format change
    }

    @Override
    void onError(MediaCodec codec, MediaCodec.CodecException ex) {
        // handle error
    }

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

Para ver más implementaciones de MediaCodec con SurfaceView, consulta los ejemplos de la cámara Android.

Recursos

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

HDR

Contenido multimedia