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. כברירת מחדל, הטרנספורמר מגדיר את הערך הזה
HDR_MODE_KEEP_HDR,
כדי להבטיח שהפלט יישמר בפורמט HDR. אם המכשיר לא
תומך בפורמט HDR, הטרנספורמר מנסה להשתמש באופן אוטומטי
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL במקום זאת.
במקרים מסוימים, אפשר לשלב גם נכסי HDR וגם נכסי SDR. לדוגמה,
עשויות לכלול שכבות-על של SDR מעל תמונות וסרטונים ב-HDR, או שאולי יש לכם
של סרטוני 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 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","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 (שעון UTC)."],[],[],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"]]
