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

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

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

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

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

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

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

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

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

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

بالنسبة إلى التطبيقات التي تصل إلى الكاميرات بصفتها "المستخدم 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). يقتصر الوصول المبكر إلى الكاميرا على كاميرات النظام المثبّتة على الجزء الخارجي من هيكل المركبة.