يوفر HDR أو النطاق الديناميكي العالي نطاقًا أوسع من الألوان التباين بين درجات اللون الأبيض الأكثر سطوعًا والظلال الأغمق، مما يؤدي إلى ظهور الفيديو جودة تشبه العين المجردة إلى حد كبير.
يمكنك إعداد ميزة تشغيل الفيديو بتقنية HDR في التطبيق لمعاينة الفيديوهات وتشغيلها بتقنية HDR. المحتوى.
تفترض هذه المقالة أنك أضفت من قبل دعم تشغيل الفيديو الأساسي إلى تطبيقك. يمكنك الاطلاع على وثائق ExoPlayer بشأن مزيد من التفاصيل حول التشغيل.
المتطلّبات الأساسية للجهاز
بعض أجهزة Android لا تتوفّر فيها إمكانية التشغيل بتقنية HDR. قبل تشغيل تقنية HDR محتوى الفيديو في تطبيقك، يُرجى تحديد ما إذا كان جهازك يستوفي ما يلي: المتطلبات الأساسية:
- تستهدف الإصدار 7.0 من نظام التشغيل Android أو إصدارًا أحدث (طبقة واجهة برمجة التطبيقات 24).
- يتضمّن برنامج فك ترميز متوافقًا مع تقنية HDR وإمكانية الوصول إلى شاشة تدعم النطاق العالي الديناميكية.
التحقّق من إمكانية التشغيل بتقنية HDR
يمكنك استخدام Display.getHdrCapabilities()
لطلب الحصول على إمكانات النطاق العالي الديناميكية (HDR) على الشاشة. تعرض هذه الطريقة معلومات حول ملفات HDR ونطاق السطوع المتوافقَين مع الشاشة.
يتحقّق الرمز التالي مما إذا كان الجهاز متوافقًا مع تشغيل HLG10. اعتبارًا من نظام التشغيل Android 13، سيكون HLG10 هو الحد الأدنى من المعيار الذي يجب أن يتيحه صنّاع الأجهزة إذا كان الجهاز قادرًا على التشغيل بتقنية 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(); Listcapabilities = 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
. يتيح لك ذلك عرض محتوى فيديو بنطاق عالي الديناميكية (HDR) بدون أي معالجة خاصة للتشغيل بتقنية HDR:
MediaCodec
: فك ترميز محتوى فيديو بنطاق عالي الديناميكية (HDR)SurfaceView
: لعرض محتوى فيديو بنطاق عالي الديناميكية (HDR)
يتحقّق الرمز التالي مما إذا كان برنامج الترميز متوافقًا مع الملف الشخصي بتقنية 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)، يمكنك الاطّلاع على المراجع التالية:
نطاق عالي الديناميكية
- التقاط فيديو بنطاق عالي الديناميكية: تعرّف على كيفية إعداد التقاط فيديو بنطاق عالي الديناميكية باستخدام واجهات برمجة تطبيقات Camera2.
- نموذج Camera2Video على GitHub: يمكنك الاطّلاع على تطبيق قيد التشغيل يتضمن وظيفة التقاط وتشغيل HDR.
الوسائط
- مرجع واجهة برمجة التطبيقات للوسائط: تعرَّف على مزيد من المعلومات حول واجهات برمجة تطبيقات الوسائط.
- ExoPlayer: تعرّف على كيفية إعداد تطبيقك باستخدام مكتبة ExoPlayer.