از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
از سرویس دوربین اندروید استفاده کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
سرویس دوربین Android شامل مجموعه دوربین های مورد استفاده در دستگاه های خودرو و همچنین در سایر عوامل مانند تلفن های همراه، تبلت ها و تلویزیون ها می شود. برای مشاهده ساختار کلی دوربین، دوربین را ببینید. این صفحه بر موضوعات خاص دستگاه‌های خودرو و کار با Android Camera API تمرکز دارد.
سرویس دوربین اندروید را فعال کنید
برای فعال کردن سرویس دوربین Android در پلتفرم خودرو، فایل سازنده محصول باید ENABLE_CAMERA_SERVICE true مشخص کند.
ویژگی های دوربین خاص خودرو
در زمینه وسایل خودرو، دوربین HAL باید دارای دو ویژگی متمایز خاص برای فاکتور فرم خودرو باشد:
در شرایطی که دوربین‌ها دقیقاً با مکان یا جهت لنز خاصی هماهنگ نیستند (که با وجود *_OTHER در ویژگی‌های android.automotive.location یا android.automotive.lens.facing مشخص می‌شود)، یا زمانی که چندین دوربین مکان و جهت یکسانی را به اشتراک می‌گذارند، HAL دوربین باید ویژگی‌های اضافی را ارائه دهد تا برنامه‌ها بتوانند موقعیت مکانی دوربین را دقیقاً تعیین کنند. این ویژگی ها عبارتند از:
به کاربر سیستم Headless اجازه دسترسی بدهید
برخی از برنامه‌های سیستمی و شخص اول (1P) می‌توانند به عنوان کاربر سیستم بدون سر، که به نام کاربر 0 نیز شناخته می‌شود، به دوربین دسترسی داشته باشند. این ویژگی تضمین می‌کند که برنامه‌های مهم ایمنی، مانند دوربین دید عقب، می‌توانند بدون وقفه به پخش جریانی دوربین بدون توجه به تغییر کاربر در پیش‌زمینه، ادامه دهند. فقط برنامه‌هایی که دارای امضای پلتفرم هستند و مجوز جدید android.permission.CAMERA_HEADLESS_SYSTEM_USER را دارند.CAMERA_HEADLESS_SYSTEM_USER می‌توانند به عنوان کاربر 0 به دوربین دسترسی داشته باشند.
برای برنامه‌هایی که به‌عنوان کاربر 0 به دوربین‌ها دسترسی دارند، داده‌های دوربین باید به صورت محلی مصرف شوند و نباید از دستگاه منتقل شوند، از جمله هر گونه داده به دست آمده از داده‌های دوربین. این برنامه‌ها نیاز دارند که مجوز android.permission.CAMERA از قبل اعطا شده باشد و باید از خط‌مشی مجوز قبل از اعطای مشخص شده در طراحی برای رانندگی برای الزامات GAS پیروی کنند.
لیست مجاز حریم خصوصی دوربین را پیکربندی کنید
سازندگان تجهیزات اصلی (OEM) اکنون می‌توانند برنامه‌های دوربین خاصی را پیکربندی کنند تا در لیست مجاز قرار گیرند که بدون توجه به وضعیت تغییر حریم خصوصی دوربین، به دوربین دسترسی می‌دهد. این ویژگی به کاربران امکان می‌دهد دسترسی به دوربین را برای برنامه‌های سرگرمی، مانند رسانه‌های اجتماعی و کنفرانس ویدیویی غیرفعال کنند، در حالی که به طور همزمان اجازه دسترسی به دوربین را برای برخی از برنامه‌های لیست مجاز می‌دهد.
فقط سیستم‌ها و برنامه‌های دارای امتیاز مجوز android.permission.CAMERA_PRIVACY_ALLOWLIST می‌توانند از این ویژگی استفاده کنند. شرکای Google Automotive Services (GAS) باید برنامه‌های فهرست مجاز خود را برای بررسی ارسال کنند و از خط‌مشی فهرست مجاز حریم خصوصی پیروی کنند. برای کسب اطلاعات بیشتر، Android for Cars را ببینید.
یک برنامه را به لیست مجاز اضافه کنید
در دایرکتوری etc/sysconfig :
نام بسته برنامه را در یک فایل XML پیکربندی سیستم اضافه کنید:
<!-- In an xml file under etc/sysconfig —>
<!--
Allowlisted packages for the camera privacy toggle. Users will not be able to turn the privacy on for these packages as OEM requires camera access for these packages to preserve user safety.
-->
<config>
<camera-privacy-allowlisted-app package="package_name" />
</config>
نشانی اینترنتی افشای خط مشی رازداری برنامه را به AndroidManifest.xml اضافه کنید. نام meta-data باید privacy_policy باشد.
<meta-data android:name="privacy_policy" android:value= privacy policy URL/>
به طور پیش‌فرض، کلید حریم خصوصی دوربین برای برنامه‌های فهرست مجاز یا برنامه‌های مورد نیاز در رابط کاربری تنظیمات حریم خصوصی پنهان است. با این حال، OEM ها می توانند این رفتار را با تنظیم پرچم زیر روی TRUE لغو کنند. این به OEM ها اجازه می دهد تا قابلیت مشاهده کلید حریم خصوصی دوربین را برای برنامه های مورد نیاز بر اساس ترجیحات خود سفارشی کنند.
<!-- Whether to show the toggle to turn on the camera privacy for required apps -->
<bool name="config_show_camera_required_apps_toggle">false</bool>
دسترسی زودهنگام به دوربین داشته باشید
برنامه‌های خاص حساس به زمان و ایمنی می‌توانند قبل از اتمام فرآیند بوت اندروید به دوربین دسترسی داشته باشند. با این حال، این دسترسی منحصراً به مشتریان ممتاز با UID AID_AUTOMOTIVE_EVS اعطا می شود. برای کسب اطلاعات بیشتر در مورد اختصاص یک UID خاص به یک برنامه بومی، به کنترل دسترسی اختیاری (DAC) مراجعه کنید. این دسترسی اولیه به دوربین محدود به دوربین های سیستمی است که در قسمت بیرونی بدنه خودرو قرار دارند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-06-12 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-06-12 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Use the Android Camera Service\n\nThe Android Camera Service comprises the camera stack used in automotive\ndevices, as well as in other form factors such as mobile phones, tablets,\nand TVs. To view the overall camera architecture, see\n[Camera](/docs/core/camera). This page focuses on topics specific to automotive\ndevices, and working with the [Android Camera API](https://developer.android.com/reference/android/hardware/camera2/package-summary).\n\nEnable Android Camera Service\n-----------------------------\n\nTo enable the Android Camera Service on the automotive platform, the product's\nmakefile must specify `ENABLE_CAMERA_SERVICE` as `true`.\n\nAutomotive-specific camera characteristics\n------------------------------------------\n\nIn the context of automotive devices, the camera HAL must include two\ndistinctive characteristics specific to the automotive form factor:\n\n| Name | Description |\n|-------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|\n| [android.automotive.location](https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics#AUTOMOTIVE_LOCATION) | Specifies the positioning of cameras in relation to the vehicle's body frame. |\n| [android.automotive.lens.facing](https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics#AUTOMOTIVE_LENS_FACING) | Indicates which direction a camera lens is facing relative to the vehicle body frame and passenger seats. |\n\nIn situations when cameras don't precisely align with specific location or lens\norientation (indicated by the presence of `*_OTHER` in the\n[`android.automotive.location`](https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics#AUTOMOTIVE_LOCATION) or [`android.automotive.lens.facing`](https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics#AUTOMOTIVE_LENS_FACING)\ncharacteristics), or when multiple cameras share the same location and\ndirection, the camera HAL should provide additional characteristics to enable\napps to accurately determine the camera's location. These characteristics\ninclude:\n\n- [`android.lens.poseReference`](https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics#LENS_POSE_REFERENCE)\n- [`android.lens.poseRotation`](https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics#LENS_POSE_ROTATION)\n- [`android.lens.poseTranslation`](https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics#LENS_POSE_TRANSLATION)\n\nGrant access to the Headless System User\n----------------------------------------\n\nCertain system and first-party (1P) apps can access the camera as the Headless\nSystem User, also known as User 0. This feature ensures that safety-critical\napps, such as the rear-view camera, can continue camera streaming without\ninterruption, regardless of foreground user switching. Only apps that are\nplatform-signed and hold the new permission\n`android.permission.CAMERA_HEADLESS_SYSTEM_USER` can access the camera as\nUser 0.\n\nFor apps accessing cameras as User 0, the camera data MUST be consumed locally\nand MUST not be transmitted off the device, including any data derived from the\ncamera data. These apps require that the `android.permission.CAMERA` permission\nbe pre-granted and must adhere to the pre-grant permission policy outlined in\n[Design for Driving](https://developers.google.com/cars) for GAS requirements.\n\nConfigure a camera privacy allowlist\n------------------------------------\n\nOriginal equipment manufacturers (OEMs) can now configure specific camera apps\nto be included on an allowlist that grants camera access regardless of the\ncamera privacy toggle's status. This feature enables users to disable camera\naccess for entertainment apps, such as social media and video conferencing,\nwhile simultaneously permitting camera access for certain allowlisted apps.\n\nOnly system and privileged apps granted the\n`android.permission.CAMERA_PRIVACY_ALLOWLIST` permission can use this feature.\nGoogle Automotive Services (GAS) partners must submit their allowlisted apps\nfor review and comply with the privacy allowlist policy. To learn more, see\n[Android for Cars](https://developers.google.com/cars).\n\n### Add an app to the allowlist\n\nIn the `etc/sysconfig` directory:\n\n1. Add the app's package name in a system configuration XML file:\n\n \u003c!-- In an xml file under etc/sysconfig ---\u003e\n\n \u003c!--\n Allowlisted packages for the camera privacy toggle. Users will not be able to turn the privacy on for these packages as OEM requires camera access for these packages to preserve user safety.\n --\u003e\n\n \u003cconfig\u003e\n \u003ccamera-privacy-allowlisted-app package=\"package_name\" /\u003e\n \u003c/config\u003e\n\n2. Add the app's URL of privacy policy disclosure to `AndroidManifest.xml`.\n The name of the `meta-data` should be `privacy_policy`.\n\n \u003cmeta-data android:name=\"privacy_policy\" android:value= privacy policy URL/\u003e\n\nBy default, the camera privacy toggle for allowlisted apps or required apps is\nhidden in the **Privacy Settings** UI. However, OEMs can override this behavior\nby setting the following flag to `TRUE`. This allows OEMs to customize the\nvisibility of the camera privacy toggle for the required apps based on their\npreferences. \n\n \u003c!-- Whether to show the toggle to turn on the camera privacy for required apps --\u003e\n\n \u003cbool name=\"config_show_camera_required_apps_toggle\"\u003efalse\u003c/bool\u003e\n\nGet early camera access\n-----------------------\n\nSpecific time-sensitive and safety-oriented apps can access the camera before\nthe Android boot process is finished. However, this access is exclusively\ngranted to privileged clients with the `UID AID_AUTOMOTIVE_EVS`. To learn more\nabout assigning a specific UID to a native app,\nsee [Discretionary access control (DAC)](/docs/core/permissions/filesystem).\nThis early access to the camera is limited to system cameras positioned on the\nexterior of the vehicle's body."]]
