El HDR, o Alto rango dinámico, proporciona una gama más amplia de colores y una mayor contraste entre los blancos más brillantes y las sombras más oscuras, lo que da como resultado una que se asemeja 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 reproducirlo. contenido.
En este artículo, se presupone que ya agregaste la compatibilidad básica con la reproducción de video 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 HDR. Antes de reproducir contenido HDR contenido de video en la app, determina si tu 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 es compatible con la reproducción de HLG10. A partir de Android 13, HLG10 es el estándar mínimo que los fabricantes de dispositivos deben admitir si estos 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(); Listcapabilities = 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. Para conocer los próximos pasos, consulta Cómo comprobar la compatibilidad con la reproducción en HDR.
Si tu app no usa ExoPlayer, configura la reproducción HDR con MediaCodec
a través de SurfaceView
.
Cómo configurar MediaCodec con SurfaceView
Configurar un flujo de reproducción de MediaCodec
estándar 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 HDR.SurfaceView
: Muestra contenido de video HDR.
El siguiente código verifica si el códec admite el perfil HDR y, luego, configura MediaCodec
con 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 obtener más implementaciones de MediaCodec
con SurfaceView
, consulta los ejemplos de la cámara de Android.
Recursos
Para obtener más información relacionada con la reproducción HDR, consulta los siguientes recursos:
HDR
- Captura de video HDR: Obtén información para configurar la captura de video HDR con las APIs de Camera2.
- Ejemplo de Camera2Video en GitHub: Accede a una app en funcionamiento con las funciones de captura y reproducción HDR.
Contenido multimedia
- Referencia de la API de medios: Obtén más información sobre las API de medios.
- ExoPlayer: Obtén información para configurar tu app con la biblioteca de ExoPlayer.