استخدام خدمة كاميرا 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 للكاميرا سمات إضافية لتتمكّن التطبيقات من تحديد موقع الكاميرا بدقة. وتشمل هذه الخصائص ما يلي:

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

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

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

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

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

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