استخدام خدمة "كاميرا Android"

تتألف خدمة كاميرا Android من حِزم الكاميرا المستخدَمة في الأجهزة المخصّصة للسيارات، بالإضافة إلى أشكال الأجهزة الأخرى، مثل الهواتف الجوّالة والأجهزة اللوحية والتلفزيونات. للاطّلاع على بنية الكاميرا بشكل عام، يُرجى الانتقال إلى الكاميرا. تركّز هذه الصفحة على مواضيع تتعلّق بالأجهزة المخصّصة للسيارات واستخدام Android Camera API.

تفعيل خدمة كاميرا Android

لتفعيل خدمة كاميرا Android على منصة السيارات، يجب أن يحدّدملف ENABLE_CAMERA_SERVICEmakefile الخاص بالتطبيق ENABLE_CAMERA_SERVICE على أنّه true.

خصائص الكاميرا المخصّصة للمركبات

في سياق الأجهزة المخصّصة للسيارات، يجب أن يتضمّن HAL للكاميرا سمتَين مميّزتين خاصتَين بتصميم الأجهزة المخصّصة للسيارات:

الاسم	الوصف
android.automotive.location	تحدّد هذه السمة وضع الكاميرات بالنسبة إلى إطار هيكل المركبة.
android.automotive.lens.facing	يشير إلى الاتجاه الذي تواجهه عدسة الكاميرا بالنسبة إلى قاعدة جسم المركبة ومقعدَي الركاب.

في الحالات التي لا تتوافق فيها الكاميرات بدقة مع موقع جغرافي أو اتجاه عدسة معيّنَين (يُشار إلى ذلك من خلال توفّر *_OTHER في سمات android.automotive.location أو android.automotive.lens.facing)، أو عندما تتشارك كاميرات متعدّدة الموقع الجغرافي والاتجاه نفسهَين، يجب أن يوفّر HAL للكاميرا سمات إضافية لتتمكّن التطبيقات من تحديد موقع الكاميرا بدقة. وتشمل هذه الخصائص ما يلي:

• android.lens.poseReference
• android.lens.poseRotation
• android.lens.poseTranslation

منح إذن الوصول إلى "مستخدِم النظام بلا واجهة مستخدم رسومية"

يمكن لبعض تطبيقات النظام والتطبيقات التابعة للطرف الأول (الطرف الأول) الوصول إلى الكاميرا باسم "مستخدم النظام بلا واجهة مستخدم رسومية"، والذي يُعرف أيضًا باسم "المستخدم 0". وتضمن هذه الميزة السماح للتطبيقات المهمة للسلامة، مثل كاميرا الرؤية الخلفية، بمواصلة بث الكاميرا بدون مقاطعة، بغض النظر عن تبديل المستخدم في المقدّمة. يمكن فقط للتطبيقات الموقَّعة من النظام الأساسي والتي تحمل الإذن الجديد "android.permission.CAMERA_HEADLESS_SYSTEM_USER" الوصول إلى الكاميرا بصفة المستخدم 0.

بالنسبة إلى التطبيقات التي تصل إلى الكاميرات بصفتها "المستخدم 0"، يجب استخدام بيانات الكاميرا محليًا ويجب عدم نقلها خارج الجهاز، بما في ذلك أي بيانات مستمَدة من بيانات الكاميرا. تتطلّب هذه التطبيقات منح الإذن android.permission.CAMERA مسبقًا، ويجب أن تلتزم بسياسة منح الأذونات مسبقًا الموضّحة في التصميم للقيادة لمتطلبات GAS.

ضبط القائمة المسموح بها لخصوصية الكاميرا

يمكن الآن للمصنّعين الأصليين للأجهزة ضبط تطبيقات كاميرا معيّنة لتضمينها في قائمة مسموح بها تمنح إذن الوصول إلى الكاميرا بغض النظر عن حالة مفتاح التبديل الخاص بالخصوصية في الكاميرا. وتتيح هذه الميزة للمستخدمين إيقاف وصول التطبيقات الترفيهية إلى الكاميرا، مثل وسائل التواصل الاجتماعي ومؤتمرات الفيديو، مع السماح في الوقت نفسه لبعض التطبيقات المُدرَجة في القائمة المسموح بها بالوصول إلى الكاميرا.

لا يمكن استخدام هذه الميزة إلا من خلال النظام والتطبيقات الحاصلة على إذن "android.permission.CAMERA_PRIVACY_ALLOWLIST". على شركاء "خدمات Google Automotive" إرسال التطبيقات المدرَجة في القائمة المسموح بها لمراجعتها والالتزام بسياسة القائمة المسموح بها للخصوصية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة Android للسيارات.

إضافة تطبيق إلى القائمة المسموح بها

في الدليل etc/sysconfig:

1. أضِف اسم حزمة التطبيق في ملف 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>
   

2. يُرجى إضافة عنوان URL الخاص بالإفصاح عن سياسة الخصوصية للتطبيق إلى AndroidManifest.xml. يجب أن يكون اسم meta-data هو privacy_policy.

   <meta-data android:name="privacy_policy" android:value= privacy policy URL/>
   

يكون زر إيقاف/تفعيل خصوصية الكاميرا للتطبيقات المسموح بها أو التطبيقات المطلوبة مخفيًا تلقائيًا في واجهة مستخدم إعدادات الخصوصية. ويمكن للمصنّعين الأصليين للأجهزة إلغاء هذا السلوك من خلال ضبط العلامة التالية على TRUE. يتيح ذلك لمصنّعي الأجهزة الأصليين تخصيص مستوى ظهور مفتاح الخصوصية للكاميرا للتطبيقات المطلوبة استنادًا إلى إعداداتهم المفضّلة.

<!-- Whether to show the toggle to turn on the camera privacy for required apps -->

<bool name="config_show_camera_required_apps_toggle">false</bool>

استخدام الكاميرا قبل إطلاقها

يمكن لبعض التطبيقات المحدّدة الحساسة للوقت والمتعلقة بالسلامة الوصول إلى الكاميرا قبل اكتمال عملية تشغيل Android. ومع ذلك، يتم منح إذن الوصول هذا حصريًا للعملاء المميّزين الذين لديهم UID AID_AUTOMOTIVE_EVS. لمزيد من المعلومات عن منح رقم تعريف مستخدم معيّن لتطبيق أصلي، اطّلِع على التحكّم في الوصول التقديري (DAC). ويقتصر استخدام الكاميرا قبل إطلاقها على كاميرات النظام الموضوعة في الجزء الخارجي من هيكل المركبة.