تشغيل فيديو بنطاق عالي الديناميكية (HDR)

يوفر HDR، أو النطاق الديناميكي العالي، نطاقًا أكبر من الألوان التباين بين درجات اللون الأبيض الأكثر سطوعًا والظلال الأغمق، مما يؤدي إلى ظهور الفيديو جودة تشبه العين المجردة إلى حد كبير.

يمكنك إعداد تشغيل الفيديوهات بنطاق عالي الديناميكية في تطبيقك لمعاينة محتوى الفيديوهات بنطاق عالي الديناميكية وتشغيله.

تفترض هذه المقالة أنك أضفت من قبل دعم تشغيل الفيديو الأساسي إلى تطبيقك. يمكنك الاطلاع على وثائق ExoPlayer للحصول على مزيد من التفاصيل حول التشغيل.

المتطلبات الأساسية للأجهزة

لا تتيح بعض أجهزة Android تشغيل المحتوى بدقة عالية الديناميكية. قبل تشغيل تقنية HDR محتوى الفيديو في تطبيقك، يُرجى تحديد ما إذا كان جهازك يستوفي ما يلي: المتطلبات الأساسية:

  • يستهدف الإصدار 7.0 من نظام التشغيل Android أو إصدارًا أحدث (المستوى 24 من واجهة برمجة التطبيقات).
  • أن يكون مزوّدًا بوحدة فك ترميز متوافقة مع تقنية النطاق العالي الديناميكية (HDR) وإمكانية الوصول إلى شاشة متوافقة مع هذه التقنية

التحقّق من توفّر ميزة التشغيل باستخدام النطاق العالي الديناميكية

استخدِم Display.getHdrCapabilities() للاستعلام عن إمكانات تقنية النطاق العالي الديناميكية (HDR) في الشاشة. تعرض هذه الطريقة معلومات حول ملفات HDR ونطاق السطوع المتوافقَين مع الشاشة.

يتحقّق الرمز التالي مما إذا كان الجهاز متوافقًا مع تشغيل HLG10. اعتبارًا من الإصدار 13 من نظام التشغيل Android، أصبح معيار 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");
}

إعداد التشغيل بتقنية HDR في تطبيقك

إذا كان تطبيقك يستخدم ExoPlayer، يعني ذلك أنّه يتيح التشغيل بتقنية HDR بشكل تلقائي. لمعرفة الخطوات التالية، يُرجى الاطّلاع على مقالة التحقّق من إمكانية تشغيل المحتوى بنطاق عالي الديناميكية (HDR).

إذا كان تطبيقك لا يستخدم ExoPlayer، يمكنك إعداد ميزة التشغيل بتقنية HDR باستخدام "MediaCodec" من خلال "SurfaceView".

إعداد MediaCodec باستخدام SurfaceView

اضبط مسار تشغيل عادي في MediaCodec باستخدام SurfaceView. يتيح لك ذلك عرض محتوى فيديو بنطاق عالي الديناميكية بدون أي معالجة خاصة لتشغيله:

  • ‫MediaCodec: فك ترميز محتوى الفيديو بنطاق عالي الديناميكية
  • SurfaceView: لعرض محتوى فيديو بنطاق عالي الديناميكية

يتحقّق الرمز البرمجي التالي ممّا إذا كان برنامج الترميز متوافقًا مع الملف الشخصي لميزة HDR، ثمّ يضبط MediaCodec باستخدام 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();

لمزيد من عمليات تنفيذ MediaCodec باستخدام SurfaceView، يمكنك الاطّلاع على عيّنات من "كاميرا Android".

المراجع

للحصول على مزيد من المعلومات حول التشغيل بنطاق عالي الديناميكية (HDR)، يمكنك الاطّلاع على المراجع التالية:

نطاق عالي الديناميكية

الوسائط