Media3 Transformer está en desarrollo y esperamos recibir tus comentarios. Agradecemos tus comentarios, solicitudes de funciones e informes de errores en la
herramienta de seguimiento de errores. Sigue el
blog de ExoPlayer para conocer las actualizaciones más recientes.
Asignación de tono: Compatibilidad con contenido HDR y SDR
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Cuando trabajas con Transformer, es importante tener en cuenta la compatibilidad
entre contenido HDR y SDR. El HDR muestra contenido con más detalles de colores.
el color y el contraste, lo que brinda a los usuarios una mejor experiencia visual. Sin embargo, debido a la
diferencia en los rangos de color entre HDR y SDR, combinando los dos tipos de
podría generar problemas de compatibilidad.
Mientras creas un
Composition,
tienes la opción de setHdrMode
para entradas de video HDR. De forma predeterminada, Transformer establece este valor en
HDR_MODE_KEEP_HDR,
lo que garantiza que la salida se mantenga en formato HDR. Si el dispositivo no
admiten el formato HDR, Transformer intenta usar
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL en su lugar.
En algunos casos, puedes combinar recursos HDR y SDR. Por ejemplo,
puede tener superposiciones SDR sobre imágenes
y videos HDR, o una mezcla
de videos HDR y SDR. En ese caso, tienes las siguientes opciones:
|
Ventajas |
Desventajas |
| Mapa de tonos con MediaCodec |
Resultado de la mejor calidad visual si se admite en la combinación de dispositivo y API |
Solo es compatible con el nivel de API 31 y versiones posteriores en ciertos dispositivos y con el nivel de API 33 y posteriores para dispositivos.
con captura HDR. Si no es compatible, Transformer arroja un
ExportException |
| Mapa de tonos con OpenGL |
Compatible con el nivel de API 29 y versiones posteriores, con compatibilidad generalmente más amplia en todos los dispositivos. Produce resultados más coherentes. |
Puede producir diferencias leves en comparación con el resultado del uso
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC |
| Interpreta HDR como SDR |
La opción más compatible. |
Es probable que el contenido tenga un aspecto descolorido y se muestre incorrectamente. |
Limitaciones actuales
No se admiten los siguientes elementos en las composiciones de varios elementos:
- Asignación de tonos de SDR a HDR
- Secuencias de contenido SDR y HDR que comiencen con un activo HDR
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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"]]
