Reprodução de vídeo HDR

O HDR, ou High Dynamic Range, oferece uma gama mais ampla de cores e maior contraste entre os brancos mais brilhantes e as sombras mais escuras, resultando em uma qualidade de vídeo que se assemelha mais ao que o olho humano percebe.

Você pode configurar a reprodução de vídeo HDR no seu app para visualizar e reproduzir conteúdo de vídeo com essa tecnologia.

Este artigo pressupõe que você já adicionou suporte básico para reprodução de vídeo ao seu app. Consulte a documentação do ExoPlayer para mais detalhes sobre a reprodução.

Pré-requisitos do dispositivo

Nem todos os dispositivos Android são compatíveis com a reprodução em HDR. Antes de reproduzir conteúdo de vídeo HDR no app, determine se o dispositivo atende aos seguintes pré-requisitos:

  • É direcionado ao Android 7.0 ou mais recente (nível 24 da API).
  • Tem um decodificador e uma tela compatíveis com HDR.

Verificar se há suporte para reprodução em HDR

Use Display.getHdrCapabilities() para consultar os recursos de HDR de uma tela. O método retorna informações sobre os perfis HDR compatíveis e o intervalo de luminância da tela.

O código a seguir verifica se o dispositivo é compatível com a reprodução de HLG10. A partir do Android 13, o HLG10 é o padrão mínimo que os fabricantes de dispositivos precisam oferecer se o dispositivo for capaz de reproduzir 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");
}

Configurar a reprodução de HDR no app

Se o app usa o ExoPlayer, ele é compatível com a reprodução em HDR por padrão. Consulte Verificar a compatibilidade com a reprodução em HDR para saber as próximas etapas.

Se o app não usar o ExoPlayer, configure a reprodução em HDR usando MediaCodec com SurfaceView.

Configurar o MediaCodec usando SurfaceView

Configure um fluxo de reprodução padrão do MediaCodec usando SurfaceView. Isso permite exibir conteúdo de vídeo HDR sem nenhum tratamento especial para a reprodução:

  • MediaCodec: decodifica conteúdo de vídeo HDR.
  • SurfaceView: mostra conteúdo de vídeo em HDR.

O código abaixo verifica se o codec é compatível com o perfil HDR e configura MediaCodec usando 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 mais implementações de MediaCodec usando SurfaceView, consulte os exemplos de câmera do Android.

Recursos

Para mais informações sobre a reprodução em HDR, consulte os seguintes recursos:

HDR

Mídia