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

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

الإفصاح عن توافق التطبيق مع Android Auto

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

<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 في فلتر الأهداف نفسه المستخدَم لعنصر android.intent.category.LAUNCHER ، ولكن يمكن وضعه في فلتر مختلف إذا كان ذلك مفضّلاً.

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

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

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

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

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

اختبار التوافق مع أحجام الشاشة الأساسية

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

منظر طبيعي صغير

[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