Transformator Media3 aktif dalam pengembangan dan kami ingin mendengar pendapat Anda. Kami menantikan masukan, permintaan fitur, dan laporan bug Anda di
Issue Tracker. Ikuti
blog ExoPlayer untuk informasi terbaru.
Pemetaan nada - Mendukung konten HDR dan SDR
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Saat bekerja dengan Transformer, penting untuk mempertimbangkan kompatibilitas
antara konten HDR dan SDR. HDR menampilkan konten dengan detail warna yang lebih baik,
warna dan kontras, memberikan
pengalaman visual yang lebih baik kepada pengguna. Namun, karena
perbedaan rentang warna antara HDR dan SDR, yang menggabungkan dua jenis
dapat menyebabkan masalah kompatibilitas.
Saat Anda membangun
Composition,
Anda memiliki opsi untuk setHdrMode
untuk input video HDR. Secara default, Transformer menetapkan nilai ini ke
HDR_MODE_KEEP_HDR,
yang memastikan output tetap dalam format HDR. Jika perangkat tidak
mendukung format HDR, Transformer otomatis mencoba menggunakan
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL saja.
Dalam beberapa kasus, Anda dapat menggabungkan aset HDR dan SDR. Sebagai contoh, Anda
mungkin memiliki overlay SDR di atas video dan gambar HDR, atau Anda mungkin memiliki campuran
video HDR dan SDR. Dalam kasus ini, Anda memiliki opsi berikut:
|
Kelebihan |
Kekurangan |
| Peta nada dengan MediaCodec |
Output kualitas visual terbaik jika didukung pada kombinasi perangkat dan API. |
Hanya didukung di API 31+ pada perangkat tertentu dan di API 33+ untuk perangkat
dengan dukungan perekaman HDR. Jika tidak didukung, Transformer akan menampilkan
ExportException. |
| Peta warna dengan OpenGL |
Didukung pada API 29+, dengan dukungan yang umumnya lebih luas di seluruh perangkat. Menghasilkan hasil yang lebih konsisten. |
Dapat menghasilkan perbedaan ringan dibandingkan dengan output dari penggunaan
HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC. |
| Menafsirkan HDR sebagai SDR |
Opsi yang didukung secara luas. |
Konten kemungkinan akan memiliki tampilan pudar dan tidak ditampilkan dengan benar. |
Batasan saat ini
Berikut ini tidak didukung untuk komposisi multi-aset:
- Pemetaan nada SDR ke HDR
- Urutan konten SDR dan HDR yang dimulai dengan aset HDR
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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"]]
