Media3 Transformer قيد التطوير بشكل نشط ونتطلّع إلى سماع رأيك. نرحب بملاحظاتك وطلبات الميزات وتقارير الأخطاء في
أداة تتبُّع المشاكل. يُرجى متابعة
مدونة ExoPlayer لمعرفة آخر المعلومات.
ربط الألوان: إتاحة محتوى بنطاق عالي الديناميكية (HDR) ونطاق SDR
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عند العمل مع Transformer، من المهم مراعاة التوافق
بين محتوى HDR ونطاق SDR تعرض تقنية HDR المحتوى بألوان أكثر
اللون والتباين، مما يمنح المستخدمين تجربة مرئية أفضل. ومع ذلك، بسبب
الاختلاف في نطاقات الألوان بين HDR وSDR، مما يجمع بين نوعي
المحتوى إلى مشكلات التوافق.
أثناء قيامك ببناء
Composition
,
يتوفّر لك خيار setHdrMode
.
لمدخلات الفيديو بتقنية HDR. يضبط المحوِّل هذه القيمة بشكلٍ تلقائي على
HDR_MODE_KEEP_HDR
,
مما يضمن الاحتفاظ بالإخراج بتنسيق HDR. إذا لم يظهر على الجهاز
من أجل التوافق مع تنسيق HDR،
يحاول تطبيق Transformer تلقائيًا استخدام
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL
بدلاً من ذلك.
في بعض الحالات، قد تجمع بين مادتَي عرض HDR ونطاق SDR معًا. على سبيل المثال،
قد تحتوي على تراكبات SDR أعلى مقاطع الفيديو والصور ذات النطاق العالي الديناميكية، أو قد تجمع مزيجًا
للفيديوهات بنطاق عالي الديناميكية (HDR) وبنطاق عادي الديناميكية (SDR). وفي هذه الحالة، تتوفر لك الخيارات التالية:
|
الإيجابيات |
العيوب |
خريطة الألوان باستخدام MediaCodec |
أفضل جودة نتائج مرئية إذا كانت متوافقة مع الجهاز وواجهة برمجة التطبيقات |
هذه الميزة متاحة فقط على الإصدار 31 والإصدارات الأحدث من واجهة برمجة التطبيقات على أجهزة معيّنة وواجهة برمجة التطبيقات 33 والإصدارات الأحدث للأجهزة.
مع إمكانية التقاط الصور بتقنية HDR. إذا لم تكن متاحة، تطرح الدالة Transformer العلامة
ExportException |
خريطة الألوان باستخدام OpenGL |
متوافق مع الإصدار 29 من واجهة برمجة التطبيقات أو الإصدارات الأحدث، مع دعم على نطاق أوسع بشكل عام على جميع الأجهزة التوصل إلى نتائج أكثر اتساقًا. |
قد تنتج اختلافات طفيفة مقارنةً بالناتج من استخدام
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC |
تفسير HDR على أنّه SDR |
الخيار الأكثر انتشارًا |
سيبدو المحتوى باهتًا وقد يتم عرضه بشكل غير صحيح. |
القيود الحالية
لا يُسمح بما يلي للمقطوعات الموسيقية التي تتضمّن مواد عرض متعددة:
- ربط درجات ألوان من SDR إلى HDR
- تسلسلات محتوى SDR وHDR التي تبدأ بمادة عرض HDR
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Tone mapping - Supporting HDR and SDR content\n\nWhen working with Transformer, it is important to consider the compatibility\nbetween HDR and SDR content. HDR displays content with greater color detail,\ncolor and contrast, giving users a better visual experience. However, due to the\ndifference in color ranges between HDR and SDR, combining the two types of\ncontent could lead to compatibility issues.\n\nAs you are building a\n[`Composition`](/reference/androidx/media3/transformer/Composition.Builder),\nyou have the option to [`setHdrMode`](/reference/androidx/media3/transformer/Composition.Builder#setHdrMode(int))\nfor HDR video inputs. By default, Transformer sets this value to\n[`HDR_MODE_KEEP_HDR`](/reference/androidx/media3/transformer/Composition#HDR_MODE_KEEP_HDR()),\nwhich ensures the output is kept in the HDR format. If the device does not\nsupport the HDR format, Transformer automatically attempts to use\n[`HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL`](/reference/androidx/media3/transformer/Composition#HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL()) instead.\n\nIn some cases, you may be combining both HDR and SDR assets. For example, you\nmight have SDR overlays on top of HDR videos and images, or you might have a mix\nof HDR and SDR videos. In this case, you have the following options:\n\n| | Advantages | Disadvantages |\n|--------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [Tone map with MediaCodec](/reference/androidx/media3/transformer/Composition#HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC()) | Best visual quality output if supported on device and API combination. | Only supported on API 31+ on certain devices and on API 33+ for devices with HDR capture support. If not supported, `Transformer` throws an `ExportException`. |\n| [Tone map with OpenGL](/reference/androidx/media3/transformer/Composition#HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL()) | Supported on API 29+, with generally wider support across devices. Produces more consistent results. | May produce mild differences compared to output from using `HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC`. |\n| [Interpret HDR as SDR](/reference/androidx/media3/transformer/Composition#HDR_MODE_EXPERIMENTAL_FORCE_INTERPRET_HDR_AS_SDR()) | Most widely supported option. | Contents will likely have a washed out look and may be displayed incorrectly. |\n\nCurrent limitations\n-------------------\n\nThe following are unsupported for multi-asset compositions:\n\n- SDR to HDR tone mapping\n- SDR and HDR content sequences that start with an HDR asset"]]