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

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

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

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

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

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

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

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

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

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

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

إعداد قائمة السماح بخصوصية الكاميرا

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

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

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

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

1. أضِف اسم حزمة التطبيق في ملف XML لإعداد النظام:

   <!-- In an xml file under etc/sysconfig ->
   
   <!--
   Allowlisted packages for the camera privacy toggle. Users can't turn on
   privacy 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. لمزيد من المعلومات عن تعيين UID معيّن لتطبيق نظام، يُرجى الاطّلاع على مقالة التحكّم في الوصول التقديري (DAC). يقتصر هذا الإذن المبكر بالوصول إلى الكاميرا على كاميرات النظام الموضوعة على الجزء الخارجي من هيكل السيارة.