از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
دوربین های سیستم
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
در دستگاه‌هایی که دارای Android 11 یا بالاتر هستند، چارچوب Android از دوربین‌های سیستم پشتیبانی می‌کند، که دستگاه‌های دوربینی هستند که فقط برای پردازش‌های دارای مجوز android.permission.SYSTEM_CAMERA و مجوزهای معمولی دوربین قابل مشاهده هستند. مجوز android.permission.SYSTEM_CAMERA که در Android 11 معرفی شده است، دارای سطح حفاظتی از system|signature است. این بدان معناست که فقط برنامه‌هایی که روی پارتیشن سیستم نصب شده‌اند یا با گواهینامه مشابه سیستم امضا شده‌اند می‌توانند این مجوز را دریافت کنند. برنامه های عمومی شخص ثالث نمی توانند به دوربین های سیستم دسترسی داشته باشند.
دوربین‌های سیستم برای سازندگان دستگاه‌هایی که می‌خواهند ویژگی‌هایی را پیاده‌سازی کنند که نیاز به دسترسی به دوربین دارند، اما به برنامه‌های ممتاز یا سیستمی نیز محدود می‌شوند، مفید هستند.
از آنجا که برنامه‌های سیستمی که مجوز android.permission.SYSTEM_CAMERA را دریافت می‌کنند باید مجوز android.permission.CAMERA را نیز داشته باشند، کاربران می‌توانند برای جلوگیری از دسترسی چنین برنامه‌ای به دوربین‌های دستگاه، مجوزهای معمولی CAMERA را لغو کنند.
پیاده سازی
برای اینکه یک دستگاه دوربین خاص به یک دوربین سیستم تبدیل شود، دوربین HAL باید ANDROID_REQUEST_AVAILABLE_CAPABILITIES_SYSTEM_CAMERA در لیست قابلیت های خود تبلیغ کند.
برای ایجاد برنامه‌ای که به دوربین سیستم دسترسی دارد، برنامه باید در فایل privapp-permissions.xml مخصوص دستگاه، که برنامه‌هایی را که مجوز android.permission.SYSTEM_CAMERA باید به آن‌ها اعطا شود، مشخص می‌کند.
اعتبار سنجی
برای تأیید اینکه هیچ دوربین سیستمی در دستگاه توسط یک برنامه عمومی قابل شناسایی نیست، آزمایش android.permission.cts.Camera2PermissionTest.testSystemCameraDiscovery CTS را اجرا کنید.
تمام تست های CTS دوربین روی دستگاه های دوربین سیستم اجرا می شود.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و 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,["# System cameras\n\nOn devices running Android 11 or higher, the Android\nframework supports system\ncameras, which are camera devices that are visible only to processes with the\n`android.permission.SYSTEM_CAMERA` permission and regular camera permissions.\nThe `android.permission.SYSTEM_CAMERA` permission, introduced in\nAndroid 11, has\na protection level of `system|signature`. This means that only apps installed on\nthe system partition with or signed with the same certificate as the system can\nbe granted this permission. Third-party public apps can't access system cameras.\n\nSystem cameras are useful for device manufacturers that want to implement\nfeatures that require access to a camera but are also restricted to privileged\nor system apps.\n\nBecause systems apps that are granted the\n`android.permission.SYSTEM_CAMERA` permission must also have the\n[`android.permission.CAMERA`](https://developer.android.com/reference/android/Manifest.permission#CAMERA)\npermission, users can choose to revoke normal `CAMERA` permissions to prevent\nsuch an app from accessing the cameras on the device.\n\nImplementation\n--------------\n\nTo make a particular camera device a system camera, the camera HAL must\nadvertise\n[`ANDROID_REQUEST_AVAILABLE_CAPABILITIES_SYSTEM_CAMERA`](https://android.googlesource.com/platform/hardware/interfaces/+/refs/heads/android16-release/camera/metadata/3.5/types.hal#120)\nin its capabilities list.\n\nTo create an app that has access to a system camera, the app must be allowlisted\nin the device-specific `privapp-permissions.xml` file, which specifies the apps\nthat the\n[`android.permission.SYSTEM_CAMERA`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/core/res/AndroidManifest.xml#1312)\npermission must be granted to.\n\nValidation\n----------\n\nTo verify that no system cameras on the device can be discovered by a public\napp, run the\n`android.permission.cts.Camera2PermissionTest.testSystemCameraDiscovery` CTS\ntest.\n\nAll\n[camera CTS tests](/docs/compatibility/cts/camera-hal#cts_tests)\nrun on system camera devices."]]
