Riproduzione video HDR

La tecnologia HDR, o High Dynamic Range, offre una gamma più ampia di colori e un maggiore contrasto tra i bianchi più luminosi e le ombre più scure, per offrire una qualità video più simile a quella percepita da occhio nudo.

Puoi configurare la riproduzione di video HDR nella tua app per visualizzare l'anteprima e riprodurre i contenuti video HDR.

Questo articolo presuppone che tu abbia già aggiunto il supporto di base della riproduzione di video alla tua app. Per ulteriori dettagli sulla riproduzione, consulta la documentazione di ExoPlayer.

Prerequisiti del dispositivo

Non tutti i dispositivi Android supportano la riproduzione HDR. Prima di riprodurre contenuti video HDR nella tua app, verifica se il tuo dispositivo soddisfa i seguenti prerequisiti:

  • Ha come target Android 7.0 o versioni successive (livello API 24).
  • Ha un decodificatore compatibile con HDR e l'accesso a un display compatibile con HDR.

Verificare il supporto della riproduzione HDR

Utilizza Display.getHdrCapabilities() per eseguire query sulle funzionalità HDR di un display. Il metodo restituisce informazioni sui profili HDR e sull'intervallo di luminanza supportati per il display.

Il codice seguente consente di verificare se il dispositivo supporta la riproduzione HLG10. A partire da Android 13, HLG10 è lo standard minimo che i produttori devono supportare se il dispositivo supporta la riproduzione 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");
}

Configurare la riproduzione HDR nell'app

Se la tua app utilizza ExoPlayer, supporta la riproduzione HDR per impostazione predefinita. Consulta Verificare il supporto della riproduzione HDR per i passaggi successivi.

Se la tua app non utilizza ExoPlayer, configura la riproduzione HDR utilizzando MediaCodec tramite SurfaceView.

Configurare MediaCodec utilizzando SurfaceView

Configura un flusso di riproduzione standard di MediaCodec utilizzando SurfaceView. In questo modo puoi visualizzare i contenuti video HDR senza una gestione speciale per la riproduzione HDR:

  • MediaCodec: decodifica i contenuti video HDR.
  • SurfaceView: vengono visualizzati contenuti video HDR.

Il codice seguente consente di verificare se il codec supporta il profilo HDR, quindi configura MediaCodec utilizzando 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();

Per ulteriori implementazioni di MediaCodec con SurfaceView, consulta gli esempi di videocamere Android.

Risorse

Per ulteriori informazioni relative alla riproduzione HDR, consulta le seguenti risorse:

HDR

Contenuti multimediali