Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.
Ultra HDR
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Android 14 unterstützt die Aufnahme von komprimierten Ultra-HDR-Bildern im Bildformat JPEG_R. Dieses Format ist abwärtskompatibel mit SDR-JPEG-Bildern und unterstützt das HDR-Rendering von Inhalten.
Weitere Informationen zur Ultra-HDR-Format-Spezifikation finden Sie unter Ultra-HDR-Bildformat v1.0.
Implementierung
In diesem Abschnitt wird beschrieben, wie du die Ultra-HDR-Funktion implementierst.
Referenzimplementierung
Das AOSP-Kamera-Framework und der Kameradienst enthalten eine Referenzimplementierung für Ultra-HDR.
Zusätzlich zu den Referenzfunktionen im Kamera-Framework können Sie Ultra-HDR in der Kamera-HAL implementieren und die Unterstützung für die JPEG_R-Ausgabe auf die gleiche Weise wie bei anderen Kamera-HAL-Ausgabestreams angeben. In diesem Szenario muss die HAL der Kamera die erforderliche Wiederherstellungskarte und das endgültige JPEG_R-Bild gemäß der Ultra-HDR-Spezifikation generieren.
Sie können die endgültige Ausgabe je nach Hardware- und Softwarefunktionen des Geräts optimieren und anpassen.
Implementierungsmöglichkeiten
Gerätehersteller können für ihre Geräte die folgenden Ultra-HDR-Unterstützungsstufen auswählen:
- Minimal:In dieser Konfiguration ist die Ultra-HDR-Ausgabe über die Funktion „Composite Stream“ des Kameradiensts standardmäßig deaktiviert. Wenn Sie die Referenzimplementierung für
JpegRCompositeStream aktivieren möchten, legen Sie die Systemeigenschaft ro.camera.enableCompositeAPI0JpegR auf true fest. Da alle Prozesse und die Codierung in der Software ausgeführt werden, kann diese Option zu einer erhöhten Latenz und einer geringeren Leistung führen.
- Mäßig:Bei dieser Option verwendet die
JpegRCompositeStream-Implementierung eine von HAL bereitgestellte SDR-JPEG-Datei als Basisbild und einen P010-Frame, um eine Wiederherstellungskarte zu berechnen. Bei dieser Option wird Software innerhalb des Datenpfads verarbeitet, was im Vergleich zur minimalen Option jedoch relativ gering ist.
- Umfassend:Die Kamera-HAL bewirbt und unterstützt den
JPEG_R-Ausgabestream direkt. Mit dieser Option können Gerätehersteller gerätespezifische Optimierungen implementieren und die Bildqualität erheblich verbessern.
Wenn Sie die JpegRCompositeStream-Implementierung deaktivieren möchten, legen Sie die Build-Eigenschaft ro.camera.disableJpegR auf true fest. Wenn diese Build-Property nicht festgelegt oder auf false gesetzt ist, wird Ultra HDR standardmäßig über JpegRCompositeStream auf Geräten aktiviert, die 10-Bit-Ausgabe und gleichzeitige 10- und 8-Bit-Aufzeichnung unterstützen.
Zertifizierungsstufe
Führen Sie die folgenden Tests aus, um die Ultra-HDR-Funktion auf Ihrem Gerät zu prüfen.
CTS-Tests
ITS-Tests
Manuelle Tests
Verwenden Sie zum Ausführen manueller Tests die Beispielimplementierung für die Ultra-HDR-Bildaufnahme. Sie unterstützt die Konfiguration und Aufnahme von Ultra-HDR mit dem Bildformat JPEG_R.
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-26 (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-26 (UTC)."],[],[],null,["# Ultra HDR\n\nAndroid 14 provides support for capturing Ultra HDR\ncompressed images using the\n[`JPEG_R`](https://developer.android.com/reference/kotlin/android/graphics/ImageFormat#jpeg_r)\nimage format. This format is backward compatible with SDR JPEG images and\nsupports HDR rendering of content.\nFor details about the Ultra HDR format specification, see\n[Ultra HDR Image Format v1.0](https://developer.android.com/guide/topics/media/hdr-image-format).\n\nImplementation\n--------------\n\nThis section describes how to implement the Ultra HDR feature.\n\n### Reference implementation\n\nThe AOSP camera framework and camera service includes a reference Ultra HDR\nimplementation.\n\nIn addition to the reference functionality in the camera framework, you can\nimplement Ultra HDR within the camera HAL and advertise support for `JPEG_R`\noutput in the same way as other camera HAL output streams. In this scenario,\nthe camera HAL must generate the necessary recovery map and the final `JPEG_R`\nimage as defined by the\n[Ultra HDR specification](https://developer.android.com/guide/topics/media/hdr-image-format#introduction).\nYou can optimize and tune the final output depending on the device hardware\nand software capabilities.\n\n### Implementation options\n\nDevice manufacturers can decide on the following levels of Ultra HDR support for\ntheir devices:\n\n- **Minimal:** In this configuration, Ultra HDR output through the camera service composite stream functionality is disabled by default. To enable the `JpegRCompositeStream` reference implementation, set the `ro.camera.enableCompositeAPI0JpegR` system property to `true`. Because all processes and encoding is performed in software, this option can result in increased latency and decreased performance.\n- **Moderate:** With this option, the `JpegRCompositeStream` implementation uses a HAL-provided SDR JPEG file as a base image and a P010 frame to calculate a recovery map. This option involves software processing within the data path but is relatively minor compared to the minimal option.\n- **Extensive:** The camera HAL advertises and supports the `JPEG_R` output stream directly. This option lets device manufacturers implement device-specific optimizations and can provide significant image quality improvements.\n\nTo disable the `JpegRCompositeStream` implementation, set the\n`ro.camera.disableJpegR` build property to `true`. If this build property isn't\nset or is set to `false`, Ultra HDR is enabled by default through\n`JpegRCompositeStream` on devices supporting\n[10-bit output capability](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT)\nand\n[concurrent 10 and 8-bit capture](https://developer.android.com/reference/android/hardware/camera2/params/DynamicRangeProfiles#getProfileCaptureRequestConstraints(long)).\n\nValidation\n----------\n\nTo validate the Ultra HDR feature on your device, run the following tests.\n\n### CTS tests\n\n- [`ImageReaderTest.java#testImageReaderBuilderWithBLOBAndJpegR`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/ImageReaderTest.java#815)\n- [`ImageReaderTest.java#testJpegR`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/ImageReaderTest.java#503)\n- [`ImageReaderTest.java#testJpegRDisplayP3`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/ImageReaderTest.java#526)\n- [`PerformanceTest.java#testSingleCapture`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/PerformanceTest.java#313)\n- [`StillCaptureTest.java# testJpegRCapture`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/tests/camera/src/android/hardware/camera2/cts/StillCaptureTest.java#192)\n\n### ITS tests\n\n- [`scene4#test_aspect_ratio_and_crop`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/apps/CameraITS/tests/scene4/test_aspect_ratio_and_crop.py)\n\n### Manual tests\n\nTo perform manual tests, use the\n[sample implementation for Ultra HDR image capture](https://github.com/android/platform-samples/pull/56),\nwhich includes support for the configuration and capture of Ultra HDR using the\n`JPEG_R` image format."]]
