اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release
بدلاً من aosp-main
لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
نظرة عامة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوفّر الوسائط منصة لإنشاء تطبيقات وسائط توفّر تجارب ترفيه ومعلومات آمنة
وسلسة ومتصلة في كل سيارة متوافقة مع Android.
"الوسائط" هو تطبيق نظام Android مصمّم لتوفير تجربة تشغيل
محسَّنة للتركيز (DO)
وتصفح تطبيقات الوسائط. يتم تضمين تنفيذ كامل الوظائف لواجهة برمجة التطبيقات Media مع
مشروع مفتوح المصدر لنظام Android (AOSP).
الشكل 1: أمثلة على عمليات تنفيذ شاشة الوسائط
للتعرّف على الوسائط، اطّلِع على الصفحات التالية:
- مكونات النظام ومسارات المستخدِمين:
اطّلِع على مزيد من المعلومات عن المكوّنات التي تتفاعل مع "الوسائط"، بالإضافة إلى مسارات المستخدمين الأكثر شيوعًا.
- استخدام الوسائط مع الراديو:
اطّلِع على كيفية دمج واجهة مستخدم "الراديو" مع الوسائط لتمكين المستخدمين من التفاعل مع مصادر الوسائط
والراديو كما لو كانا تطبيقًا واحدًا.
- تخصيص الوسائط:
تعرَّف على كيفية العمل مع الأنماط والمواد التي تم تحديدها على مستويات مختلفة في بنية AOSP.
- استخدام بطاقة وسائط:
يمكنك استخدام بطاقة وسائط لعرض البيانات الوصفية للوسائط، مثل العناوين وصور الألبومات وغير ذلك. يمكن أن تعرض بطاقة الوسائط
أيضًا قائمة انتظار لعناصر الوسائط، مثل قائمة تشغيل.
المصطلحات
يتم استخدام هذه المصطلحات في هذا القسم.
مصدر الوسائط
تطبيق Android ينفِّذ واجهة برمجة التطبيقات
MediaBrowserService API
لتوفير إمكانية التحكّم في التشغيل وتصفُّح كتالوج عناصر الوسائط
ملف وسائط
عنصر في كتالوج "مصدر الوسائط" يمكن أن تكون ملفات الوسائط:
- عناصر الوسائط القابلة للتشغيل مقاطع صوتية يمكن لنظام
التشغيل تشغيلها، مثل الأغاني والفصول من الكتب وحلقات البودكاست
- عناصر الوسائط القابلة للتصفح العناصر التنظيمية المستخدَمة لتجميع
العناصر القابلة للتشغيل أو العناصر الأخرى القابلة للتصفّح، مثل فئات الأغاني ومجلد الأغاني الأخيرة، بالإضافة إلى
ملفات البودكاست والعناصر القابلة للتشغيل التي تم ترتيبها حسب الفنان أو المؤلف أو الجمهور
توفّر الوسائط هذه الميزات.
أثناء القيادة |
أثناء إيقاف السيارة |
---|
عناصر التحكّم في التشغيل
-
عرض عنصر الوسائط الذي يتم تشغيله حاليًا (مثل أغنية)، بما في ذلك العنوان
وصورة الألبوم والمدة والوصف ومكان التشغيل الحالي
-
تنفيذ إجراءات الوسائط العادية (مثل التشغيل والإيقاف المؤقت والتقديم والتخطّي
إلى الأمام)
-
تنفيذ إجراءات الوسائط المخصّصة (الإجراءات المخصّصة التي يوفّرها كل مصدر وسائط)
-
عرض قائمة المحتوى التالي، إذا كان تطبيق الوسائط يوفّرها
تصفُّح الكتالوج
-
عرض فئات المستوى الأعلى
-
التوغّل في عناصر الوسائط القابلة للتصفّح (مثل المجلدات)
-
مجموعة من عناصر الوسائط القابلة للتشغيل (مثل الأغاني)، بما في ذلك العنوان وصورة الألبوم وعلامات
المحتوى على سبيل المثال، المحتوى الفاضح والمحتوى الذي تم تنزيله
|
كل ما هو مُدرَج ضمن أثناء القيادة بالإضافة إلى:
-
سجِّل الدخول. بالنسبة إلى مصادر الوسائط التي تتطلّب تسجيل الدخول، يجب
أن يكون من الممكن بدء عملية تسجيل الدخول مباشرةً من "الوسائط".
-
الإعدادات. يمكن لمصدر الوسائط عرض واجهة مستخدم للإعدادات.
-
البحث باستخدام لوحة المفاتيح يمكن للمستخدمين إجراء بحث نصي في "الوسائط".
|
مهام Google
يوضّح هذا الجدول مهام كل طرف.
صانعو المركبات (vOEM) |
Google |
مطوّرو التطبيقات |
---|
- أنشئ نظامًا متّسقًا تمامًا مع مستند Android CDD
للترفيه والمعلومات باستخدام Android Automotive.
- تلبية جميع توقعات MediaSession وBrowser API والتشغيل التفاعلي مع
الوسائط:
- يجب مراعاة بنية التصفّح.
- يجب مراعاة الإجراءات المخصّصة.
- تفويض التطبيق بتسجيل الدخول والإعدادات وما إلى ذلك
- يجب مراعاة عناصر الهوية البصرية للتطبيق المتوافقة صراحةً مع واجهات برمجة التطبيقات. على سبيل المثال،
اسم التطبيق.
|
- تحديد Media APIs وتطويرها
- توفير تنفيذ الوسائط في AOSP
- تحديد عملية مراجعة التطبيقات لنشر تطبيقات الوسائط على "متجر Play"
- تقديم مستندات لعناصر مثل واجهات برمجة التطبيقات والتخصيصات والمراجعة
وعمليات الاعتماد
|
- تنفيذ واجهات برمجة التطبيقات Media API:
- يجب توفير بنية عامة لتصفّح الوسائط مع المحتوى المناسب.
- قدِّم إجراءات مخصّصة حسب الحاجة.
- إتاحة حالات التشغيل للنظام
- قدِّم عناصر العلامة التجارية، مثل اسم التطبيق.
- نفِّذ عمليات تسجيل الدخول والاشتراك والإعدادات وحلّ الأخطاء حسب الحاجة.
- إنشاء حِزم APK للسيارات ونشرها على "متجر Play"
|
إرشادات التخصيص
يستخدم تنفيذ الوسائط المضمّن في AOSP
مكتبة واجهة المستخدم في السيارة لتفعيل
التخصيص، كما يوفّر مظهرًا أساسيًا وبنية يمكن استخدامهما كما هما أو تعديلهما
وفقًا للقيود التالية. يوضّح الجدول التالي مسؤوليات المصنّعين الأصليّين للأجهزة
بشأن تخصيص الوسائط.
تخصيص الوسائط |
الوصف |
---|
يجب |
يمكنك ضبط المظهر العام والتصميم، بما في ذلك لوحة الألوان وحجم العناصر. |
أيار (مايو) |
تعديل البنية العالية المستوى للوسائط (على سبيل المثال، موضع علامة التبويب) |
يجب عدم |
تعديل عقود Media API، بما في ذلك عناصر هوية التطبيق:
- إمكانية التشغيل التفاعلي بين MediaSession وMediaBrowser
- اسم مصدر الوسائط ورمزه
تعديل بنية المعلومات في ما يلي:
|
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ 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\n*Media* provides a platform on which to build media apps that provide safe,\nseamless, and connected infotainment experiences in every Android-enabled car.\nMedia is an Android system application designed to provide a\n[Distraction Optimized (DO)](/docs/automotive/driver_distraction/guidelines) playback\nand browse experience for media apps. A fully functional implementation of Media is included with\n[Android Open Source Project (AOSP)](/).\n\n\n\u003cbr /\u003e\n\n\n**Figure 1.** Media screen sample implementations.\n\nTo learn about Media, see the following pages:\n\n- **[System components and user flows](/docs/automotive/hmi/media/technical_details).** Learn more about the components that interact with Media, as well as the most common user flows.\n- **[Implement radio with media](/docs/automotive/hmi/media/radio).** Read how to integrate the Radio UI with Media to provide enable users to interact with media sources and radio as if they were a single application.\n- **[Customize media](/docs/automotive/hmi/media/customization).** Learn how to work with styles and assets defined at different levels in the AOSP structure.\n- **[Implement a media card](/docs/automotive/hmi/media/media-card).** Implement a media card to display media metadata such as titles, album art, and more. A media card can also display a queue of media items, such as a playlist.\n\nTerminology\n-----------\n\nThese terms are used in this section.\nMedia Source An Android app that implements the Android [MediaBrowserService API](https://developer.android.com/guide/topics/media-apps/audio-app/building-an-audio-app) to expose playback control and browsing of its catalog of media items. Media Item An element in the Media Source catalog. Media items can be either:\n\n- Playable Media items. Audio segments that can be played by the system such as songs, chapters of books, and episodes of podcasts\n- Browsable Media items. Organizational elements used to group playable or other browseable media items such as song categories, a recent songs folder, as well as podcasts and playable media items sorted by artist, author, or audience.\n\nMedia features\n--------------\n\nMedia provides these features.\n\n| While driving | While parked |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Playback control. - Presentation of currently playing media item (for example, a song), including title, album art, duration, description, and current play position. - Execution of standard media actions (for example, play, stop, pause, and skip forward). - Execution of custom media actions (custom actions provided by each media source). - Presentation of the playback queue, if provided by the media app. Catalog browse. - Display of top-level categories. - Drill down into browse-able media items (for example, folders). - Selection of playable media items (for example, songs) including title, album art, and indicators. For example, explicit content and downloaded content. | Everything listed under *While Driving* as well as: - Sign-in. For those media sources that require sign-in, it should be possible to start the sign in flow directly from Media. - Settings. Media source can display a settings UI. - Search, with keyboard. Users can perform a text search on Media. |\n\nTasks\n-----\n\nThis table describes the tasks of each party.\n\n| Vehicle makers (vOEMs) | Google | App developers |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| - Build a fully-compliant [Android CDD](/docs/compatibility/10/android-10-cdd) infotainment system with Android Automotive. - Fulfill all expectations of MediaSession and Browser APIs and the interoperability with Media: - Respect browse structure. - Respect custom actions. - Delegate to the app for sign-in, settings, and so on. - Respect the app branding elements explicitly supported by the APIs. For example, the app name. | - Define and evolve Media APIs. - Provide Media implementation in AOSP. - Define app review process for publishing of media apps on Play Store. - Provide documentation for elements such as APIs, customizations, review, and certification processes | - Implement Media APIs: - Provide overall media browse structure with appropriate content. - Provide custom actions as appropriate. - Make playback states available to the system. - Provide branding elements, such as app name. - Implement the sign-in, sign-up, settings, and error resolution flows, as needed. - Build and publish car APKs to the Play Store. |\n\nCustomization guidelines\n------------------------\n\nThe Media implementation included in AOSP uses\n[Car UI Library](/docs/automotive/hmi/car_ui) to enable\ncustomization and provides a base theme and structure that can be adopted as is or modified\naccording to the following restrictions. The following table describes OEM responsibilities\nregarding Media customization.\n\n| Media customization | Description |\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| SHOULD | Adjust overall theme and styling, including color pallette and sizing. |\n| MAY | Modify the high-level structure of Media (for example, tab placement). |\n| MUST NOT | Modify Media API contracts, including app branding: - MediaSession and MediaBrowser interoperability - Media source name, icon Modify information architecture of: - Playback - Browse - Search |"]]