L'HDR (High Dynamic Range) offre una gamma di colori più ampia e un contrasto maggiore tra i bianchi più luminosi e le ombre più scure, con una qualità video che si avvicina di più a ciò che l'occhio nudo percepisce.
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 per la 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:
- Target Android 7.0 o versioni successive (livello API 24).
- Dispone di un decoder compatibile con HDR e di un display compatibile con HDR.
Verifica il supporto della riproduzione HDR
Utilizza Display.getHdrCapabilities() per eseguire query sulle funzionalità HDR di un display. Il metodo restituisce informazioni sui profili HDR supportati e sull'intervallo di luminanza del display.
Il seguente codice verifica se il dispositivo supporta la riproduzione HLG10. A partire da Android 13, HLG10 è lo standard minimo che i produttori di dispositivi devono supportare se il dispositivo è in grado di riprodurre contenuti 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 riproduzione HDR nella tua app
Se la tua app utilizza ExoPlayer, supporta la riproduzione HDR per impostazione predefinita. Per i passaggi successivi, consulta Verifica il supporto della riproduzione HDR.
Se la tua app non utilizza ExoPlayer, configura la riproduzione HDR utilizzando MediaCodec tramite SurfaceView.
Configura MediaCodec utilizzando SurfaceView
Configura un flusso di riproduzione MediaCodec standard utilizzando SurfaceView. In questo modo puoi visualizzare contenuti video HDR senza dover gestire in modo speciale la riproduzione HDR:
MediaCodec: decodifica i contenuti video HDR.SurfaceView: mostra contenuti video HDR.
Il seguente codice verifica se il codec supporta il profilo HDR, quindi configura MediaCodec utilizzando 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()
Per altre implementazioni di MediaCodec che utilizzano SurfaceView, consulta gli esempi di fotocamera Android.
Risorse
Per ulteriori informazioni sulla riproduzione HDR, consulta le seguenti risorse:
HDR
- Acquisizione di video HDR: scopri come configurare l'acquisizione di video HDR utilizzando le API Camera2.
- Esempio di Camera2Video su GitHub: visualizza un'app funzionante con funzionalità di acquisizione e riproduzione HDR.
Media
- Riferimento API Media: scopri di più sulle API Media.
- ExoPlayer: scopri come configurare la tua app con la libreria ExoPlayer.