HDR video oynatma

HDR veya Yüksek Dinamik Aralık, daha geniş bir renk yelpazesi ve en parlak beyazlar ile en koyu gölgeler arasında daha yüksek kontrast sağlar. Bu sayede, çıplak gözle algılanana daha yakın bir video kalitesi elde edilir.

HDR video içeriğini önizlemek ve oynatmak için uygulamanızda HDR video oynatma özelliğini ayarlayabilirsiniz.

Bu makalede, uygulamanıza temel video oynatma desteği eklediğiniz varsayılmaktadır. Oynatma hakkında daha fazla bilgi için ExoPlayer dokümanlarına bakın.

Cihaz ön koşulları

HDR oynatma özelliği tüm Android cihazlarda desteklenmez. Uygulamanızda HDR video içeriği oynatmadan önce cihazınızın aşağıdaki ön koşulları karşılayıp karşılamadığını belirleyin:

  • Android 7.0 veya sonraki sürümleri (API katmanı 24) hedefler.
  • HDR özellikli bir kod çözücüye ve HDR özellikli bir ekrana erişimi olmalıdır.

HDR oynatma desteği olup olmadığını kontrol etme

Bir ekranın HDR özelliklerini sorgulamak için Display.getHdrCapabilities() kullanın. Yöntem, ekranın desteklenen HDR profilleri ve parlaklık aralığı hakkında bilgi döndürür.

Aşağıdaki kod, cihazın HLG10 oynatmayı destekleyip desteklemediğini kontrol eder. Android 13'ten itibaren, cihaz üreticilerinin HDR oynatma özelliğine sahip cihazlarda desteklemesi gereken minimum standart HLG10'dur:

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

Uygulamanızda HDR oynatmayı ayarlama

Uygulamanız ExoPlayer kullanıyorsa varsayılan olarak HDR oynatmayı destekler. Sonraki adımlar için HDR oynatma desteği olup olmadığını kontrol etme bölümüne bakın.

Uygulamanız ExoPlayer kullanmıyorsa SurfaceView üzerinden MediaCodec kullanarak HDR oynatmayı ayarlayın.

SurfaceView'ı kullanarak MediaCodec'i ayarlama

SurfaceView kullanarak standart bir MediaCodec oynatma akışı oluşturun. Bu sayede, HDR oynatma için özel bir işlem yapmadan HDR video içeriği gösterebilirsiniz:

  • MediaCodec: HDR video içeriğinin kodunu çözer.
  • SurfaceView: HDR video içeriği gösterir.

Aşağıdaki kod, codec'in HDR profilini destekleyip desteklemediğini kontrol eder ve ardından SurfaceView kullanarak MediaCodec'ü ayarlar:

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();

SurfaceView kullanan daha fazla MediaCodec uygulaması için Android kamera örneklerine göz atın.

Kaynaklar

HDR oynatma ile ilgili daha fazla bilgi için aşağıdaki kaynaklara göz atın:

HDR

Medya

  • Media API referansı: Media API'ler hakkında daha fazla bilgi edinin.
  • ExoPlayer: Uygulamanızı ExoPlayer kitaplığıyla nasıl ayarlayacağınızı öğrenin.