O Media3 Transformer está em desenvolvimento ativo. Queremos saber sua opinião. Seu feedback, solicitações de recursos e relatórios de bugs são bem-vindos no
Issue Tracker. Siga o
blog do ExoPlayer (em inglês) para ver as atualizações mais recentes.
Mapeamento de tons: suporte a conteúdo HDR e SDR
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Ao trabalhar com o Transformer, é importante considerar a compatibilidade
entre conteúdo HDR e SDR. O HDR exibe conteúdo com mais detalhes de cor,
cor e contraste, proporcionando aos usuários uma melhor experiência visual. No entanto, devido à
diferença nos intervalos de cores entre HDR e SDR, combinando os dois tipos de
conteúdo pode levar a problemas de compatibilidade.
À medida que você está construindo um
Composition
,
você tem a opção de setHdrMode
para entradas de vídeo HDR. Por padrão, o transformador define esse valor como
HDR_MODE_KEEP_HDR
,
que garante que a saída seja mantida no formato HDR. Se o dispositivo
oferecem suporte ao formato HDR, o Transformer tenta usar automaticamente
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL
.
Em alguns casos, você pode combinar recursos HDR e SDR. Por exemplo,
podem ter sobreposições de SDR sobre vídeos e imagens HDR, ou um mix
de vídeos HDR e SDR. Nesse caso, você tem as seguintes opções:
|
Vantagens |
Desvantagens |
Mapa de tons com o MediaCodec |
Melhor saída de qualidade visual se compatível com a combinação de dispositivo e API. |
Compatível apenas com o nível 31 da API em alguns dispositivos e com o nível 33 ou mais recente da API em alguns dispositivos
com suporte a captura HDR. Se não houver suporte, Transformer vai gerar uma
ExportException . |
Mapa de tons com o OpenGL |
Tem suporte no nível 29 da API e versões mais recentes, com suporte geral em vários dispositivos. Produz resultados mais consistentes. |
Pode causar pequenas diferenças em comparação com a saída do uso
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC : |
Interpretar HDR como SDR |
Opção com maior compatibilidade. |
Os conteúdos provavelmente terão uma aparência desbotada e podem ser exibidos incorretamente. |
Limitações atuais
Os itens a seguir não são compatíveis com composições de vários recursos:
- Mapeamento de tons SDR para HDR
- Sequências de conteúdo SDR e HDR que começam com um recurso HDR
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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"]]