إضافة ميزة التوافق مع Android Auto إلى تطبيقك المتوقف

على الأجهزة التي تعمل بالإصدار 15 من نظام التشغيل Android أو الإصدارات الأحدث، يتيح Android Auto تشغيل التطبيقات في فئات التطبيقات المتوافقة مع وضع الركن مباشرةً على الوحدة الرئيسية. يمكنك الاطّلاع على التطبيقات المخصَّصة للاستخدام أثناء توقّف السيارة للحصول على مزيد من المعلومات حول تجربة المستخدم للتطبيقات المخصَّصة للاستخدام أثناء توقّف السيارة على Android Auto.

تحديد إمكانية استخدام التطبيق مع Android Auto

للإشارة إلى أنّ تطبيقك متوافق مع Android Auto، يجب تضمين عنصر <category> التالي في intent filter الخاص بنشاط في بيان تطبيقك:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

بشكل عام، يمكن وضع عنصر الفئة android.intent.category.CAR_LAUNCHER في intent filter نفسه الذي يضم العنصر android.intent.category.LAUNCHER، ولكن يمكن وضعه في فلتر مختلف إذا كان ذلك أفضل.

إدخالات البيان الخاصة بالفئة

بالإضافة إلى المتطلبات السابقة، يجب أن تستوفي الألعاب متطلبات إضافية. اطّلِع على مقالة تصنيف تطبيقك على أنّه لعبة.

التوافق مع أحجام شاشات Android Auto الشائعة

لتقديم أفضل تجربة للمستخدم، ننصحك بجعل تطبيقك متوافقًا تمامًا مع أحجام الشاشات المختلفة. لضمان تقديم تجربة عالية الجودة في مجموعة متنوعة من السيارات المتوافقة مع Android Auto، يجب ألا يتم عرض التطبيقات بشكل كبير ضمن إطار أسود على الشاشات الأفقية، وذلك وفقًا DO-2 لإرشادات جودة تطبيقات السيارات.

على سبيل المثال، إذا كان التطبيق يعمل بنسبة عرض إلى ارتفاع عمودية مع إضافة مساحة على الجانبين على شاشة أفقية، سيتم رفضه أثناء مراجعته على "متجر Play". ويُسمح بتشغيل تطبيق بنسبة عرض إلى ارتفاع أفقية مع الحد الأدنى من التعبئة العمودية على شاشة أفقية، كما يُسمح بتشغيل تطبيق بنسبة عرض إلى ارتفاع أفقية مع التعبئة الأفقية على شاشة عمودية.

الاختبار على أحجام الشاشة الأساسية

عند إنشاء تطبيقك واختباره على Android Auto، يمكنك استخدام إعدادات "وحدة رأس سطح المكتب" (DHU) التالية للتأكّد من أنّ تطبيقك يستوفي المتطلبات السابقة:

[general]
resolution = 800x480
dpi = 160
...

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

رصد الاستخدام على Android Auto

إذا أردت رصد وقت استخدام تطبيقك من خلال Android Auto (مثل أغراض الإحصاءات)، يمكنك الاطّلاع على إشارتَين:

• حالة الاتصال التي تعرضها واجهة برمجة التطبيقات CarConnection عند ربط Android Auto، سيظهر الرمز CONNECTION_TYPE_PROJECTION.
• رقم تعريف الشاشة النشطة عندما يتم تشغيل تطبيقك على شاشة عرض غير الشاشة المدمجة، مثلاً عند استخدامه من خلال Android Auto، تكون هذه القيمة مختلفة عن DEFAULT_DISPLAY.

يوضّح المقتطف التالي كيفية دمج هذه الإشارات لرصد الاستخدام من خلال Android Auto:

val connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY