اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release
بدلاً من aosp-main
لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
نظرة عامة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتضمّن المركبات من الجيل التالي شاشات متعددة، وقد يتم تشغيل بعضها باستخدام نظام التشغيل Android لعرض محتوى غني. توضِّح هذه الصفحة
العناصر الرئيسية لدمج مجموعة العدادات وشاشات العرض الأخرى في نظام IVI لنظام التشغيل Android
Automotive.
الشاشات الخارجية في Android
يستخدم نظام التشغيل Android 10 واجهة برمجة التطبيقات android.app.Presentation للسماح باستخدام الشاشات الخارجية.
العرض التقديمي هو مربّع حوار فريد الغرض منه عرض المحتوى على شاشة
ثانوية. يتم ربط العرض التقديمي بالهدف
الشاشة
في وقت الإنشاء، ويتم ضبط سياقه وإعدادات الموارد وفقًا
لمقاييس الشاشة.
شاشة مجموعة العدادات
تكون واجهة برمجة التطبيقات Presentation API كافية لعرض لوحة العدادات العادية التي تتضمّن التصاريح التالية:
الشكل 1: نموذج لشاشة مجموعة العدادات
لا تحتاج Presentation API إلى ما يلي:
- تركيز صوت منفصل
- لتشغيل النشاط أو التطبيق بأكمله
- لأخذ إدخالات المستخدمين المتزامنة في الاعتبار
- لمعالجة أحداث اللمس
لمزيد من المعلومات حول استخدام شاشات متعددة، يُرجى الاطّلاع على نظرة عامة على الشاشات المتعددة.
شرط أساسي: من المفيد أن تكون على دراية ببعض أساسيات
الإصدارات السابقة من WindowManager في Android.
أنواع المحتوى المتوافقة
قد لا تريد بعض المركبات أن يرسم نظام Android رسومات مجموعة الأدوات
بشكل مباشر، ولكن لا يزال يريد عرض معلومات مثل الإرشادات المفصّلة أو عنوان الموسيقى. يمكن لنظام التشغيل Android إرسال هذه البيانات بعدة طرق. يمكن لجهاز Android
إرسال محتوى لوحة العدادات على النحو التالي:
- الرسائل المستندة إلى البيانات الوصفية، مثل إرسال الرسائل من خلال CAN من خلال
CarVendorExtensionManager
أو VehicleNetworkService
يجب أن ينشئ نظام مجموعات الأدوات الرسومات المناسبة استنادًا إلى
البيانات الوصفية.
- المحتوى المستنِد إلى الرسومات، المعروض على شاشة فعلية أو افتراضية قد تكون الشاشة
شاشة مخصّصة داخل مجموعة المقاييس، أو جزءًا من شاشة مجموعة المقاييس
الرسومية بالكامل.
مثال على بنية الأجهزة لشاشة مجموعة العدادات
المستندة إلى الرسومات:
الشكل 2: شاشة مجموعة العدادات المستندة إلى الرسومات في Android Automotive
قد يكون نظام التشغيل Android والنظام المهم للسلامة (المعني بعرض لوحة العدادات) مضمّنين في وحدة المعالجة المركزية المتعددة النوى نفسها (على سبيل المثال، وحدة Cortex-R المخصّصة لنظام التشغيل في الوقت الفعلي ووحدة Cortex-A لنظام التشغيل Android). يمكن أن تكون الواجهة Ethernet AVB
(Audio Video Bridge) أو LVDS أو HDMI. في نظام التشغيل Android، يمكن توصيل مجموعة أدوات الرسومات
كشاشة افتراضية، ما يؤدي إلى إخفاء بنية الأجهزة التي تستند إليها عملية تنفيذ
Display HAL.
القيود المفروضة على المقاعد الخلفية
بالنسبة إلى ميزة الترفيه في المقاعد الخلفية، تفرض واجهة برمجة التطبيقات لعرض الوسائط
القيود التالية:
- لا يمكن عرض النشاط بأكمله (العرض التقديمي هو مربّع حوار).
- يتوفّر مصدر صوت واحد فقط.
- ما مِن مستخدمين متزامنين.
- لا تتوفّر أحداث لمس مباشرة للشاشة الخارجية (تحتاج إلى عملية حقن
منفصلة).
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Overview\n\nNext-generation vehicles support multiple screens, some of which\nmight be operated by Android to provide rich contents. This page describes the\nkey elements to integrate instrument cluster and other displays into an Android\nAutomotive IVI system.\n\nExternal displays in Android\n----------------------------\n\nAndroid 10 uses the [android.app.Presentation](https://developer.android.com/reference/android/app/Presentation.html) API to support the use of external displays.\nA *presentation* is a unique dialog, its purpose to present content on a secondary\ndisplay. A presentation is associated with the target\n[Display](https://developer.android.com/reference/android/view/Display.html)\nat the time of creation and configures its context and resource configuration according\nto the display metrics.\n\nInstrument cluster display\n--------------------------\n\nThe Presentation API is sufficient for a typical instrument cluster display, which has these\nallowances: \n**Figure 1**. Sample instrument cluster display\n\nThe Presentation API does not need:\n\n- Separate audio focus.\n- To run the entire activity or app.\n- To consider concurrent user input.\n- To handle touch events.\n\nTo learn more about the use of multiple displays, see\n[Multi-display overview](/docs/core/display/multi_display).\n\n**Prerequisite** : Some familiarity with previous\ndevelopments of the Android [WindowManager](https://developer.android.com/reference/android/view/WindowManager) is helpful.\n\n\nSupported content types\n-----------------------\n\nSome vehicles may not want Android to draw instrument cluster graphics\ndirectly, but still want to show information such as turn-by-turn guidance or\nmusic title. Android can send such data in several ways. An Android device can\nsend instrument cluster content as:\n\n- Metadata-based, such as sending messages through CAN through `CarVendorExtensionManager` or `VehicleNetworkService`. The instrumental cluster system must create appropriate graphics based on the metadata.\n- Graphics-based, to physical or virtual display. The display may be a dedicated display inside the gauge cluster, or part of a fully graphical instrument cluster display.\n\nExample hardware architecture for a graphics-based instrument cluster\ndisplay:\n\n\n**Figure 2.** Sample Android Automotive graphics-based instrument cluster display.\n\nThe safety-critical (responsible for rendering instrument cluster) and\nAndroid OS may reside on the same multi-core SoC (for example, dedicate Cortex-R\nfor real-time OS and Cortex-A for Android). The interface can be Ethernet AVB\n(Audio Video Bridge), LVDS, or HDMI. In Android, the Graphics Instrument Cluster\ncould be connected as a Virtual Display, hiding the hardware architecture behind\n[Display HAL](https://developer.android.com/reference/android/hardware/display/VirtualDisplay.html)\nimplementation.\n\nRear seat limitations\n---------------------\n\nFor rear seat entertainment, the presentation API has the following\nlimitations:\n\n- Can't project the entire activity (presentation is a dialog).\n- Only one audio focus available.\n- No concurrent users.\n- No direct touch events for the external display (needs separate injection flow)."]]