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

على الأجهزة التي تعمل بنظام التشغيل Android 15 أو الإصدارات الأحدث، يتيح 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 نفسه الذي يتضمّن العنصر android.intent.category.LAUNCHER، ولكن يمكن وضعه في فلتر مختلف إذا أردت ذلك.

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

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

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

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

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

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

عند إنشاء تطبيقك واختباره لبرنامج 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 displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)