توفّر تقنية النطاق العالي الديناميكية (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(); Listcapabilities = 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، يمكنك إعداد تشغيل 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، يُرجى الاطّلاع على المراجع التالية:
نطاق عالي الديناميكية
- تسجيل فيديو بنطاق عالي الديناميكية: تعرَّف على كيفية ضبط إعدادات تسجيل الفيديو بنطاق عالي الديناميكية باستخدام واجهات برمجة تطبيقات Camera2.
- نموذج Camera2Video على GitHub: يمكنك الاطّلاع على تطبيق يعمل مع وظيفة تسجيل الفيديوهات بنطاق عالي الديناميكية وتشغيلها.
الوسائط
- مرجع Media API: اطّلِع على مزيد من المعلومات عن واجهات برمجة تطبيقات Media API.
- ExoPlayer: تعرَّف على كيفية إعداد تطبيقك باستخدام مكتبة ExoPlayer.