एचडीआर वीडियो चलाना

एचडीआर या हाई डाइनैमिक रेंज, रंगों की बड़ी रेंज वगैरह उपलब्ध कराता है सबसे चमकदार सफ़ेद और सबसे गहरे शैडो के बीच कंट्रास्ट, जिससे वीडियो की क्वालिटी जो सबसे ज़्यादा मिलती-जुलती है.

एचडीआर वीडियो की झलक देखने और उसे फिर से चलाने के लिए, अपने ऐप्लिकेशन में एचडीआर वीडियो चलाने की सुविधा सेट अप की जा सकती है कॉन्टेंट.

इस लेख में यह माना गया है कि आपने वीडियो को चलाने की बुनियादी सुविधा पहले ही जोड़ दी है आपका ऐप्लिकेशन. इसके लिए ExoPlayer दस्तावेज़ देखें प्लेबैक के बारे में ज़्यादा जानकारी मिलेगी.

डिवाइस से जुड़ी ज़रूरी शर्तें

सभी Android डिवाइसों पर एचडीआर क्वालिटी में वीडियो चलाने की सुविधा नहीं होती. एचडीआर में वीडियो चलाने से पहले अपने ऐप्लिकेशन का वीडियो कॉन्टेंट सेव करके, यह देख सकते हैं कि आपका डिवाइस इन शर्तों को पूरा करता है या नहीं ज़रूरी शर्तें:

  • Android 7.0 या उसके बाद के वर्शन (एपीआई लेयर 24) को टारगेट करता है.
  • इसमें एचडीआर की सुविधा वाला डिकोडर मौजूद है. साथ ही, इसमें एचडीआर क्वालिटी के डिसप्ले का ऐक्सेस भी है.

देखें कि एचडीआर प्लेबैक की सुविधा है या नहीं

किसी डिसप्ले में एचडीआर की सुविधाओं के बारे में क्वेरी करने के लिए, Display.getHdrCapabilities() का इस्तेमाल करें. इस तरीके से, डिसप्ले के साथ काम करने वाली एचडीआर प्रोफ़ाइलों और चमक की सीमा के बारे में जानकारी मिलती है.

यहां दिया गया कोड यह पता लगाता है कि आपके डिवाइस पर HLG10 वीडियो चलाने की सुविधा है या नहीं. Android 13 और उसके बाद के वर्शन वाले डिवाइसों में एचडीआर क्वालिटी के वीडियो चलाने की सुविधा उपलब्ध होने पर, डिवाइस बनाने वालों को HLG10 स्टैंडर्ड के साथ काम करना चाहिए:

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

अपने ऐप्लिकेशन में एचडीआर क्वालिटी में वीडियो चलाने की सुविधा सेट अप करना

अगर आपके ऐप्लिकेशन में ExoPlayer का इस्तेमाल किया जाता है, तो उस पर डिफ़ॉल्ट रूप से एचडीआर क्वालिटी में वीडियो चलाने की सुविधा काम करती है. अगले चरणों के बारे में जानने के लिए, एचडीआर वीडियो चलाने की सुविधा देखना लेख पढ़ें.

अगर आपका ऐप्लिकेशन ExoPlayer का इस्तेमाल नहीं करता है, तो SurfaceView के ज़रिए MediaCodec का इस्तेमाल करके एचडीआर में वीडियो चलाने की सुविधा सेट अप करें.

SurfaceView का इस्तेमाल करके MediaCodec सेट अप करें

SurfaceView का इस्तेमाल करके, स्टैंडर्ड MediaCodec प्लेबैक फ़्लो सेट अप करें. इससे आपको एचडीआर प्लेबैक के लिए किसी खास तरीके से हैंडल किए बिना एचडीआर वीडियो कॉन्टेंट दिखाया जा सकता है:

  • MediaCodec: एचडीआर वीडियो कॉन्टेंट को डिकोड करता है.
  • SurfaceView: एचडीआर वीडियो कॉन्टेंट दिखाता है.

यहां दिया गया कोड जांच करता है कि कोडेक एचडीआर प्रोफ़ाइल के साथ काम करता है या नहीं. इसके बाद, SurfaceView का इस्तेमाल करके MediaCodec को सेट अप किया जाता है:

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 का इस्तेमाल करके, MediaCodec लागू करने की ज़्यादा जानकारी के लिए, Android कैमरे के सैंपल देखें.

संसाधन

एचडीआर प्लेबैक से जुड़ी ज़्यादा जानकारी के लिए, नीचे दिए गए संसाधन देखें:

एचडीआर

  • एचडीआर वीडियो कैप्चर: Camera2 एपीआई का इस्तेमाल करके एचडीआर वीडियो कैप्चर करने की सुविधा सेट अप करने का तरीका जानें.
  • GitHub पर Camera2Video का सैंपल: एचडीआर कैप्चर और वीडियो चलाने की सुविधा वाला कोई ऐसा ऐप्लिकेशन देखें जो काम कर रहा हो.

मीडिया

  • Media API का रेफ़रंस: Media API के बारे में ज़्यादा जानें.
  • ExoPlayer: ExoPlayer लाइब्रेरी की मदद से, अपने ऐप्लिकेशन को सेट अप करने का तरीका जानें.