Media3 Transformer est activement en développement et votre avis nous intéresse. N'hésitez pas à nous faire part de vos commentaires, de vos demandes de fonctionnalités et de vos rapports de bugs dans
Issue Tracker. Suivez le
blog ExoPlayer pour obtenir les dernières informations.
Mise en correspondance des tons : prise en charge des contenus HDR et SDR
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Lorsque vous travaillez avec Transformer, il est important de tenir compte de la compatibilité
entre les contenus HDR et SDR. Le format HDR affiche le contenu avec plus de détails,
la couleur et le contraste, ce qui offre
une meilleure expérience visuelle aux utilisateurs. Toutefois, en raison du
entre les plages de couleurs HDR et SDR, en combinant les deux types de
peut entraîner des problèmes de compatibilité.
Pendant que vous construisez
Composition
,
vous avez la possibilité de setHdrMode
pour les entrées vidéo HDR. Par défaut, le transformateur définit cette valeur sur
HDR_MODE_KEEP_HDR
,
ce qui garantit que la sortie est conservée au format HDR. Si l'appareil ne
compatibles avec le format HDR, Transformer tente automatiquement d'utiliser
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL
à la place.
Dans certains cas, vous pouvez combiner des éléments HDR et SDR. Par exemple :
des superpositions SDR peuvent s'afficher sur les vidéos et les images HDR, ou vous pouvez combiner
des vidéos HDR et SDR. Dans ce cas, vous disposez des options suivantes:
|
Avantages |
Inconvénients |
Carte des tons avec MediaCodec |
Qualité visuelle la plus élevée, si compatible avec la combinaison appareil/API. |
Uniquement disponible à partir du niveau d'API 31 sur certains appareils et à partir du niveau d'API 33 pour les appareils.
compatible avec la capture HDR. S'il n'est pas pris en charge, Transformer génère une
ExportException |
Carte des tons avec OpenGL |
Prise en charge à partir du niveau d'API 29, avec une compatibilité générale plus large sur tous les appareils. Génère des résultats plus cohérents. |
Peut produire de légères différences par rapport au résultat de l'utilisation
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC |
Interpréter le HDR en tant que SDR |
Option la plus largement acceptée. |
Le contenu aura probablement un aspect pâle et ne s'affichera peut-être pas correctement. |
Limites actuelles
Les éléments suivants ne sont pas compatibles avec les compositions multi-éléments:
- Mappage des tons SDR vers HDR
- Séquences de contenus SDR et HDR commençant par un élément HDR
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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"]]