Media3 Transformer is actively under development and we are looking to hear from you! We welcome your feedback, feature requests and bug reports in the
issue tracker. Follow the
ExoPlayer blog for the latest updates.
نگاشت آهنگ - پشتیبانی از محتوای HDR و SDR
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
هنگام کار با Transformer، مهم است که سازگاری بین محتوای HDR و SDR را در نظر بگیرید. HDR محتوا را با جزئیات بیشتر رنگ، رنگ و کنتراست نمایش می دهد و به کاربران تجربه بصری بهتری می دهد. با این حال، به دلیل تفاوت در محدوده رنگ بین HDR و SDR، ترکیب این دو نوع محتوا می تواند منجر به مشکلات سازگاری شود.
همانطور که در حال ساخت یک Composition هستید، این گزینه را دارید که setHdrMode برای ورودی های ویدیوی HDR تنظیم کنید. به‌طور پیش‌فرض، Transformer این مقدار را روی HDR_MODE_KEEP_HDR تنظیم می‌کند، که تضمین می‌کند خروجی در فرمت HDR باقی می‌ماند. اگر دستگاه از فرمت HDR پشتیبانی نمی کند، Transformer به طور خودکار سعی می کند به جای آن از HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL استفاده کند.
در برخی موارد، ممکن است هر دو دارایی HDR و SDR را با هم ترکیب کنید. به عنوان مثال، ممکن است در بالای ویدیوها و تصاویر HDR پوشش SDR داشته باشید، یا ممکن است ترکیبی از ویدیوهای HDR و SDR داشته باشید. در این مورد، شما گزینه های زیر را دارید:
| مزایا | معایب |
|---|
| نقشه تن با MediaCodec | بهترین خروجی با کیفیت بصری اگر در دستگاه و ترکیب API پشتیبانی شود. | فقط در API 31+ در دستگاه‌های خاص و در API 33+ برای دستگاه‌هایی با پشتیبانی از ضبط HDR پشتیبانی می‌شود. اگر پشتیبانی نشود، Transformer یک ExportException را پرتاب می کند. |
| نقشه تن با OpenGL | در API 29+ پشتیبانی می‌شود و معمولاً از همه دستگاه‌ها پشتیبانی می‌کند. نتایج منسجم تری ایجاد می کند. | ممکن است در مقایسه با خروجی استفاده از HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC تفاوت های ملایمی ایجاد کند. |
| HDR را به عنوان SDR تفسیر کنید | گسترده ترین گزینه پشتیبانی می شود. | محتویات احتمالاً ظاهری از بین رفته و ممکن است نادرست نمایش داده شوند. |
محدودیت های فعلی
موارد زیر برای ترکیب‌های چند دارایی پشتیبانی نمی‌شوند:
- نگاشت تون SDR به HDR
- توالی محتوای SDR و HDR که با یک دارایی HDR شروع می شود
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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"]]
