از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
Ultra HDR
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
اندروید 14 از ثبت تصاویر فشرده شده Ultra HDR با استفاده از فرمت تصویر JPEG_R پشتیبانی می کند. این فرمت با تصاویر SDR JPEG سازگار است و از رندر HDR محتوا پشتیبانی می کند. برای جزئیات در مورد مشخصات فرمت Ultra HDR، فرمت تصویر Ultra HDR نسخه 1.0 را ببینید.
پیاده سازی
این بخش نحوه پیاده سازی ویژگی Ultra HDR را شرح می دهد.
پیاده سازی مرجع
چارچوب دوربین و سرویس دوربین AOSP شامل اجرای Ultra HDR مرجع است.
علاوه بر عملکرد مرجع در چارچوب دوربین، می‌توانید Ultra HDR را در HAL دوربین پیاده‌سازی کنید و پشتیبانی از خروجی JPEG_R را مانند سایر جریان‌های خروجی HAL دوربین تبلیغ کنید. در این سناریو، دوربین HAL باید نقشه بازیابی لازم و تصویر نهایی JPEG_R را همانطور که توسط مشخصات Ultra HDR تعریف شده است ایجاد کند. بسته به قابلیت های سخت افزاری و نرم افزاری دستگاه می توانید خروجی نهایی را بهینه سازی و تنظیم کنید.
گزینه های پیاده سازی
سازندگان دستگاه می توانند در مورد سطوح زیر از پشتیبانی Ultra HDR برای دستگاه های خود تصمیم بگیرند:
- Minimal: در این پیکربندی، خروجی Ultra HDR از طریق عملکرد جریان ترکیبی سرویس دوربین به طور پیش فرض غیرفعال است. برای فعال کردن پیاده‌سازی مرجع
JpegRCompositeStream ، ویژگی سیستم ro.camera.enableCompositeAPI0JpegR را روی true تنظیم کنید. از آنجایی که تمام فرآیندها و کدگذاری در نرم افزار انجام می شود، این گزینه می تواند منجر به افزایش تاخیر و کاهش عملکرد شود. - Moderate: با استفاده از این گزینه، پیاده سازی
JpegRCompositeStream از یک فایل SDR JPEG ارائه شده توسط HAL به عنوان تصویر پایه و یک فریم P010 برای محاسبه نقشه بازیابی استفاده می کند. این گزینه شامل پردازش نرم افزار در مسیر داده است، اما در مقایسه با گزینه حداقل، نسبتاً ناچیز است. - گسترده: دوربین HAL جریان خروجی
JPEG_R را مستقیماً تبلیغ و پشتیبانی می کند. این گزینه به سازندگان دستگاه اجازه می‌دهد تا بهینه‌سازی‌های خاص دستگاه را اجرا کنند و می‌تواند کیفیت تصویر قابل توجهی را بهبود بخشد.
برای غیرفعال کردن اجرای JpegRCompositeStream ، ویژگی ساخت ro.camera.disableJpegR را روی true تنظیم کنید. اگر این ویژگی ساخت تنظیم نشده باشد یا روی false تنظیم شده باشد، Ultra HDR به طور پیش‌فرض از طریق JpegRCompositeStream در دستگاه‌هایی که از قابلیت خروجی 10 بیتی و ضبط همزمان 10 و 8 بیتی پشتیبانی می‌کنند، فعال می‌شود.
اعتبار سنجی
برای تأیید اعتبار ویژگی Ultra HDR در دستگاه خود، آزمایش‌های زیر را انجام دهید.
تست های CTS
تست های ITS
تست های دستی
برای انجام آزمایش‌های دستی، از پیاده‌سازی نمونه برای ضبط تصویر Ultra HDR استفاده کنید، که شامل پشتیبانی از پیکربندی و ضبط Ultra HDR با استفاده از فرمت تصویر JPEG_R است.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
