از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
ضبط وسعت گسترده
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برای دستگاه‌هایی که اندروید 14 یا بالاتر دارند، Android از تصویربرداری با گستره وسیع Display P3 پشتیبانی می‌کند. دستگاه ها می توانند با استفاده از کلاس ImageReader بدون استفاده از HDR 10 بیتی، تصاویر رنگی گسترده ای را در قالب JPEG ثبت کنند. این ویژگی به دستگاه‌ها اجازه می‌دهد تا از طریق پارامتر setColorSpace در SessionConfiguration ، عکسبرداری دوربین را در یک فضای رنگی گسترده به چارچوب Camera2 درخواست کنند.
الزامات
برای پشتیبانی از عکسبرداری با وسعت گسترده، دستگاه باید به دوربینی با قابلیت های طیف گسترده رنگ دسترسی داشته باشد.
پیاده سازی
برای پشتیبانی از درخواست‌های تصویربرداری وسعت نمایش P3، موارد زیر را انجام دهید:
- قسمت
colorSpace را در Stream.aidl بخوانید و آن را در جریان خروجی اعمال کنید. - ورودی فراداده
android.request.availableColorSpaceProfilesMap را پیاده سازی کنید. - قابلیت
COLOR_SPACE_PROFILES را در android.request.availableCapabilities گزارش دهید.
برای اجرای مرجع دوربین HAL که از ضبط وسعت P3 پشتیبانی می کند، موارد زیر را در /hardware/google/camera/devices/EmulatedCamera/hwl/ configs/emu_camera_back.json ببینید:
برای جزئیات بیشتر در مورد ضبط وسعت گسترده در دوربین HAL، مقادیر زیر را در metadata_definitions.xml ببینید:
API ها
برای دستگاه‌های دارای Android 14 یا بالاتر با پشتیبانی از تصویربرداری گسترده، مشتریان دوربین می‌توانند از APIهای عمومی زیر استفاده کنند:
مقادیر مورد انتظار برای پارامتر ColorSpace از کلاس ColorSpace.Named مشتق شده است. در Android 14، SRGB ، DISPLAY_P3 ، و BT2020_HLG پشتیبانی می‌شوند.
اعتبار سنجی
برای تأیید اجرای پشتیبانی از تصویربرداری گسترده Display P3، آزمایش‌های زیر را اجرا کنید.
سی تی اس
-
android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test8BitColorSpaceOutputCharacteristics -
android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test10BitColorSpaceOutputCharacteristics -
android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#testColorSpaceProfileMap -
android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Jpeg -
android.hardware.camera2.cts.ImageReaderTest#testDisplayP3JpegRepeating -
android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Heic -
android.hardware.camera2.cts.ImageReaderTest#testDisplayP3HeicRepeating
ITS
تست های مجموعه تست تصویر دوربین (ITS) را برای تایید موارد زیر اجرا کنید:
- وجود نمایه ICC با مختصات رنگی صحیح
- تصویر حاوی داده‌های پیکسلی خارج از محدوده sRGB است
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و 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,["# Wide gamut capture\n\nFor devices running Android 14 or higher, Android\nprovides support for Display P3 wide gamut capture. Devices can capture wide\ngamut color images in JPEG format with the `ImageReader` class without\nusing [10-bit HDR](/docs/core/camera/10-bit-camera-output). This feature lets\ndevices\nrequest camera capture in a wide gamut color space to the Camera2 framework\nthrough the [`setColorSpace`](https://developer.android.com/reference/android/hardware/camera2/params/SessionConfiguration#setColorSpace(android.graphics.ColorSpace.Named)) parameter in `SessionConfiguration`.\n\nRequirements\n------------\n\nTo support wide gamut capture, the device must have access to a camera with wide\ngamut color capabilities.\n\nImplementation\n--------------\n\nTo support Display P3 wide gamut capture requests, do the following:\n\n- Read the `colorSpace` field in [`Stream.aidl`](https://android.googlesource.com/platform/hardware/interfaces/+/refs/heads/android16-release/camera/device/aidl/android/hardware/camera/device/Stream.aidl) and apply it to the output stream.\n- Implement the `android.request.availableColorSpaceProfilesMap` metadata entry.\n- Report the `COLOR_SPACE_PROFILES` capability in `android.request.availableCapabilities`.\n\nFor a reference Camera HAL implementation supporting P3 wide gamut capture,\nsee the following in `/hardware/google/camera/devices/EmulatedCamera/hwl/\nconfigs/emu_camera_back.json`:\n\n- [`android.request.availableCapabilities`](https://android.googlesource.com/platform/hardware/google/camera/+/refs/heads/android16-release/devices/EmulatedCamera/hwl/configs/emu_camera_back.json#183)\n- [`android.request.availableColorSpaceProfilesMap`](https://android.googlesource.com/platform/hardware/google/camera/+/refs/heads/android16-release/devices/EmulatedCamera/hwl/configs/emu_camera_back.json#211)\n\nFor further details on wide gamut capture in the Camera HAL, see the following\nvalues in `metadata_definitions.xml`:\n\n- [`availableColorSpaceProfiles`](https://android.googlesource.com/platform/system/media/+/refs/heads/android16-release/camera/docs/metadata_definitions.xml#7163)\n- [`availableColorSpaceProfilesMap`](https://android.googlesource.com/platform/system/media/+/refs/heads/android16-release/camera/docs/metadata_definitions.xml#7184)\n- [`COLOR_SPACE_PROFILES`](https://android.googlesource.com/platform/system/media/+/refs/heads/android16-release/camera/docs/metadata_definitions.xml#6610)\n\n### APIs\n\nFor devices running Android 14 or higher with support\nfor wide gamut capture, camera clients can use the following public APIs:\n\n- [`ColorSpaceProfiles`](https://developer.android.com/reference/android/hardware/camera2/params/ColorSpaceProfiles)\n- [`setColorSpace`](https://developer.android.com/reference/android/hardware/camera2/params/SessionConfiguration#setColorSpace(android.graphics.ColorSpace.Named))\n\nThe expected values for the `ColorSpace` parameter are derived from the\n[`ColorSpace.Named`](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.Named)\nclass. In Android 14, `SRGB`, `DISPLAY_P3`,\nand `BT2020_HLG` are supported.\n\nValidation\n----------\n\nTo validate your implementation of Display P3 wide gamut capture support, run\nthe following tests.\n\n### CTS\n\n- `android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test8BitColorSpaceOutputCharacteristics`\n- `android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test10BitColorSpaceOutputCharacteristics`\n- `android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#testColorSpaceProfileMap`\n- `android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Jpeg`\n- `android.hardware.camera2.cts.ImageReaderTest#testDisplayP3JpegRepeating`\n- `android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Heic`\n- `android.hardware.camera2.cts.ImageReaderTest#testDisplayP3HeicRepeating`\n\n### ITS\n\nRun the\n[Camera Image Test Suite (ITS)](/docs/compatibility/cts/camera-its)\ntests to validate the following:\n\n- Presence of an ICC profile with correct chromaticity coordinates\n- Image contains pixel data outside the sRGB gamut"]]
