Media3 Transformer befindet sich derzeit in der Entwicklung und wir würden uns freuen, von Ihnen zu hören. Wir freuen uns über Feedback, Funktionsanfragen und Fehlerberichte im
Issue Tracker. Im
ExoPlayer-Blog finden Sie die neuesten Updates.
Tone Mapping – Unterstützung von HDR- und SDR-Inhalten
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Bei der Arbeit mit dem Transformer ist es wichtig, die Kompatibilität
zwischen HDR und SDR-Inhalten. HDR zeigt Inhalte mit mehr Farbdetails,
Farben und Kontraste dargestellt werden, um das visuelle Erlebnis zu verbessern. Aufgrund der
den Unterschied in den Farbbereichen zwischen HDR und SDR, wobei beide Arten von
zu Kompatibilitätsproblemen führen.
Bei der Erstellung eines
Composition
,
haben Sie die Möglichkeit, setHdrMode
für HDR-Videoeingänge. Standardmäßig legt der Transformer diesen Wert auf
HDR_MODE_KEEP_HDR
,
damit die Ausgabe im HDR-Format erhalten bleibt. Wenn das Gerät nicht
HDR-Format unterstützen, versucht Transformer automatisch,
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL
.
Manchmal kombinierst du möglicherweise sowohl HDR- als auch SDR-Assets. Zum Beispiel haben Sie
HDR-Videos und -Bilder mit SDR-Overlays überlagert
HDR- und SDR-Videos. In diesem Fall haben Sie folgende Möglichkeiten:
|
Vorteile |
Nachteile |
Tone Map mit MediaCodec |
Ausgabe der besten Bildqualität, wenn dies für die Kombination aus Gerät und API unterstützt wird. |
Wird nur bei API 31 und höher auf bestimmten Geräten und auf API 33 und höher für Geräte unterstützt
mit Unterstützung für HDR-Aufnahmen. Wenn sie nicht unterstützt wird, gibt Transformer den Fehler
ExportException . |
Tone Map mit OpenGL |
Wird auf API 29 und höher unterstützt, mit allgemein breiterer Unterstützung auf allen Geräten. Es werden konsistentere Ergebnisse erzielt. |
Kann zu geringfügigen Unterschieden im Vergleich zur Ausgabe der Verwendung von
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC |
HDR als SDR interpretieren |
Am weitesten verbreitete Option. |
Die Inhalte sind wahrscheinlich verwaschen und werden möglicherweise falsch angezeigt. |
Aktuelle Einschränkungen
Folgendes wird für Kompositionen aus mehreren Assets nicht unterstützt:
- Tone Mapping von SDR zu HDR
- SDR- und HDR-Inhaltssequenzen, die mit einem HDR-Asset beginnen
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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"]]