تخصيص الوسائط

تنتمي الوسائط إلى مجموعة من تطبيقات النظام (على سبيل المثال، Dialer وApp Launcher). تشترك هذه التطبيقات في الأنماط والأصول المشتركة المحددة على مستويات مختلفة في بنية AOSP.

• framework/base . يتم تعريف جميع أنماط Android الأساسية هنا.
• packages/services/Car/car_product/overlay . يحتوي على تراكبات وقت البناء التي تعمل على تعديل الإطار القياسي/الموارد الأساسية لإنتاج شكل ومظهر AOSP لنظام التشغيل Android Automotive. قد تختار الشركات المصنعة للمعدات الأصلية استبعاد هذا التراكب واستخدام التراكب الخاص بها.
• packages/apps/Car/libs/car-ui-lib . تحدد هذه المكتبة مكونات وموارد AAOS المشتركة لتطبيقات النظام والتطبيقات غير المجمعة المصممة للتخصيص. لمزيد من التفاصيل، راجع دليل تكامل مكتبة واجهة مستخدم السيارة .
• packages/apps/Car/libs/car_app_common . الألوان والأنماط المشتركة المشتركة بين تطبيقات نظام السيارات. يمكن لمصنعي المعدات الأصلية استخدام التراكبات لتخصيص هذه العناصر (على غرار car_product/overlay الموصوف أعلاه).
• packages/apps/Car/libs/car_media_common . يحتوي على عناصر مشتركة بين الوسائط وواجهات مستخدم الوسائط الأخرى. على سبيل المثال، أداة وسائط الشاشة الرئيسية.

• packages/apps/Car/Media. تستخدم جميع تطبيقات النظام المظهر الخاص بها، والذي يمتد من Theme.CarUi ، كما هو محدد في car-ui-lib .

يوفر Android Automotive AOSP عرضين تقديميين للوسائط.

• واجهة مستخدم الوسائط. يمكّن المستخدمين من تسجيل الدخول وتصفح المحتوى واستخدام عناصر التحكم التفصيلية في التشغيل.
• القطعة وسائل الإعلام الشاشة الرئيسية. لتمكين استخدام ميزات التحكم في تشغيل الوسائط الأساسية على الشاشة الرئيسية.

واجهة مستخدم الوسائط

يصف هذا الشكل بنية واجهة مستخدم الوسائط:

الشكل 1. واجهة مستخدم الوسائط.

للحصول على تفاصيل حول إرشادات تجربة المستخدم وواجهة المستخدم بالإضافة إلى البنية المكانية للمكونات المختلفة للوسائط، راجع النموذج المكاني .

AppBarView: شريط الأدوات

يعد شريط أدوات Media UI مكونًا مشتركًا مع تطبيقات النظام الأخرى، مثل Dialer وRadio. لمعرفة كيفية تخصيص شريط الأدوات، راجع دليل تكامل مكتبة واجهة مستخدم السيارة .

الحد الأقصى لحجم العمل الفني للوسائط

لإعلام تطبيقات الوسائط بالحجم الأقصى للعمل الفني المطلوب جلبه، يمكنك تراكب media_items_bitmap_max_size_px في نظامك. للقيام بذلك، أرسل EXTRA_MEDIA_ART_SIZE_HINT_PIXELS كتلميح جذر. ونتيجة لذلك، ستوفر النطاق الترددي عند تنزيل الصور. لمعرفة المزيد، راجع MediaConstants على Developer.android.com.

تصفح القطعة

يتكون التصفح بشكل أساسي من Car UI RecyclerView ، الذي يتعامل مع موضع شريط التمرير والأسهم والهوامش ويمكنه تصفح عناصر من أنواع مختلفة، مثل الرؤوس وعناصر الشبكة وعناصر شبكة الأيقونات وعناصر القائمة وعناصر قائمة الأيقونات.

ضوابط التشغيل المصغرة

عندما يتم عرض جزء التصفح، وعند تحديد عنصر وسائط، يتم عرض عرض مصغر لعناصر التحكم في التشغيل . ويوضح الشكل التالي بنية هذا العرض:

الشكل 2. ضوابط التشغيل المصغرة.

تصفح القائمة

يمكن للمطورين استخدام مجموعة من تلميحات الأنماط (راجع تطبيق أنماط المحتوى ) لتخصيص العرض التقديمي لمحتوى تصفح الوسائط. يجب على مصنعي المعدات الأصلية الالتزام بهذه الأنماط، وتعديل العرض التقديمي وفقًا لنظام التصميم الخاص بهم.

توجد أنواع العناصر المدعومة والتخطيطات الخاصة بها كما يلي:

• LIST_ITEM ( media_browse_list_item.xml ). يُستخدم بشكل شائع للحلقات الموجودة في البودكاست، مثل عناصر قائمة التشغيل والمفضلة.
• ICON_LIST_ITEM ( media_browse_list_icons_item.xml ). يُستخدم للفئات أو خيارات القائمة، حيث الصورة المضمنة مع عنصر الوسائط ليست صورة الألبوم الفعلية ولكنها رمز.
• GRID_ITEM ( media_browse_grid_item.xml ). يُستخدم بشكل شائع للعناصر القابلة للتشغيل، مثل الأغاني أو قوائم التشغيل.
• ICON_GRID_ITEM ( media_browse_grid_icons_item.xml ). يُستخدم للفئات المشابهة لـ ICON_LIST_ITEM .
• HEADER ( media_browse_header_item.xml ). يستخدم لتنظيم عناصر الوسائط إلى أقسام.

شاشة التشغيل

لعرض هذه الشاشة، قم بتوسيع عناصر التحكم في التشغيل المصغرة:

• يتم حاليًا تشغيل بيانات بيانات الوسائط (بما في ذلك العنوان والعنوان الفرعي).
• ضوابط التشغيل كاملة.
• قائمة انتظار التشغيل (تُستخدم لعرض العناصر التي تم تشغيلها مؤخرًا أو العناصر التالية التي سيتم تشغيلها).

يتم تحديد مكونات شاشة التشغيل في الأشكال أدناه.

الشكل 3. شاشة التشغيل.

لا تشارك شاشة التشغيل شريط الأدوات مع بقية التطبيق. وبدلاً من ذلك، تقوم هذه الشاشة بإدارة العناصر الموجودة أعلى الشاشة بشكل فردي.

إسناد تنسيق الصوت

عندما تقوم التطبيقات بتعيين KEY_CONTENT_FORMAT_TINTABLE_LARGE_ICON_URI أو KEY_CONTENT_FORMAT_TINTABLE_SMALL_ICON_URI في الإضافات الخاصة بعنصر الوسائط الذي يتم تشغيله حاليًا. يجب على مصنعي المعدات الأصلية (OEM) جعل المتجه المناسب قابلاً للرسم كما هو موضح بواسطة URI.

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

روابط التشغيل

عندما تقوم التطبيقات بتعيين KEY_SUBTITLE_LINK_MEDIA_ID أو KEY_DESCRIPTION_LINK_MEDIA_ID ، يجب على مصنعي المعدات الأصلية عرض الترجمة أو الوصف بطريقة توحي بإمكانية النقر عليهم، ثم فتح طريقة العرض "تصفح" لإظهار عنصر الوسائط المرتبط عند نقرة مستخدم.

ضوابط التشغيل

تتضمن شاشة التشغيل مجموعة موسعة من عناصر التحكم في التشغيل، منظمة في صفوف التحكم . يتم عرض الصف الثانوي (المعروض أدناه كصف في الأعلى) فقط إذا كانت المساحة الموجودة في الصف الأول غير كافية لعرض جميع الإجراءات التي أرجعها تطبيق الوسائط من PlaybackStateCompat#getActions() .

الشكل 4. ضوابط التشغيل.

يمكن لمصنعي المعدات الأصلية تخصيص أيقونات الإجراءات القياسية، لكن يجب عليهم تقديم أيقونات إجراءات مخصصة كما توفرها تطبيقات الوسائط.

القطعة وسائل الإعلام الشاشة الرئيسية

يتم تنفيذ هذه الأداة كجزء من car-media-common . يتضمن هذا الجزء نسخة مصغرة من شاشة التشغيل الموضحة أعلاه. تنطبق جميع قواعد وإمكانيات التخصيص نفسها.

الشكل 5. أداة وسائط الشاشة الرئيسية.

يستخدم زر محدد التطبيق المعروض أعلاه وظيفة التبديل الموضحة في تبديل تدفق المستخدم بمصدر الوسائط .

لاستخدام رمز مصدر الوسائط الحالي لزر محدد التطبيق، قم بتراكب علامة use_media_source_logo_for_app_selector المحددة في platform/packages/apps/Car/libs/car-media-common/res/values/bools.xml وقم بتعيينها على true . مع هذا التغيير، سيتم إخفاء أيقونة مصدر الوسائط الموجودة على الجانب الآخر من شريط أدوات التطبيق. ينطبق التخصيص أيضًا على تطبيق Media Center وتطبيق الراديو المرجعي.

الشكل 6. زر تحديد تطبيق الوسائط.

تخطيط زر التشغيل والإيقاف المؤقت والإيقاف

يمكن تخصيص تخطيط زر التشغيل/الإيقاف المؤقت/الإيقاف لـ "التشغيل الآن" وعرض عناصر التحكم في التشغيل المصغر. يتم تعريف كلا التخطيطين في packages/apps/Car/libs/car-media-common/res/layout/ .

لتخصيص تخطيطات الأزرار، قم بتطبيق تراكبات وقت البناء على play_pause_stop_button_layout.xml و minimized_play_pause_stop_button_layout.xml .

قم بتمييز العنصر الحالي في قائمة انتظار التشغيل

يتم تعيين حالة عنصر قائمة انتظار التشغيل الحالي على selected ، بحيث يمكن تخصيصه باستخدام موارد الحالة مثل قوائم حالة اللون (راجع مورد قائمة حالة اللون ) وقائمة الحالة القابلة للرسومات (راجع الموارد القابلة للرسم ). لتطبيق تغييرات التصميم الضرورية، يمكنك تجاوز تخطيط عنصر قائمة الانتظار packages/apps/Car/Media/res/layout/queue_list_item.xml أو منفصل

يمكنك أيضًا إظهار أيقونة بجوار عنصر قائمة انتظار التشغيل الحالي:

• تراكب العلامة المنطقية show_icon_for_now_playing_queue_list_item المحددة في packages/apps/Car/Media/res/layout/queue_list_item.xml ، أو علامة منفصلة

  لإخفاء مؤقت التشغيل، اضبط show_time_for_now_playing_queue_list_item على false .

• استخدم حالة قابلة للرسم، على سبيل المثال، المقدمة أو الخلفية لعرض جذر العنصر (راجع packages/apps/Car/Media/res/layout/queue_list_item.xml أو عرض منفصل في التسلسل الهرمي لعرض العنصر.

الشكل 7. العنصر الحالي المميز في قائمة انتظار التشغيل.