مراحل نشاط خدمة متصفّح الوسائط
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا القسم كيفية تفاعل نظام التشغيل Android Automotive (AAOS) وAndroid Auto مع خدمة متصفّح الوسائط أثناء سير عمل نموذجي للمستخدم:
يبدأ المستخدم تشغيل تطبيقك على Android Auto أو Android Automotive OS.
يربط التطبيق المضيف بخدمة متصفّح الوسائط، والتي يبدأ نظام التشغيل تشغيلها إذا لم تكن قيد التشغيل. في عملية تنفيذ طريقة onCreate()،
عليك إنشاء عنصر MediaSessionCompat وتسجيله،
بالإضافة إلى عنصر معاودة الاتصال. لمزيد من المعلومات، يُرجى الاطّلاع على تسجيل جلسة وسائط.
تستدعي AAOS أو Android Auto طريقة onGetRoot في خدمتك لاسترداد الجذر في التسلسل الهرمي للمحتوى. لا يتم عرض الجذر.
بدلاً من ذلك، تسترجع المزيد من المحتوى من تطبيقك في الخطوات اللاحقة.
تستدعي AAOS أو Android Auto طريقة onLoadChildren() في خدمتك من أجل استرداد العناصر الفرعية لعنصر الوسائط الجذر. تعرض AAOS وAndroid Auto عناصر الوسائط هذه كأعلى مستوى من عناصر المحتوى. يمكنك الاطّلاع على بنية القائمة الجذر لمعرفة المزيد حول ما يتوقّعه النظام.
عندما يختار المستخدم عنصر وسائط قابلاً للتصفّح، يتم استدعاء طريقة onLoadChildren() في خدمتك مرة أخرى.
إذا اختار المستخدم عنصر وسائط قابلاً للتشغيل، يستدعي AAOS أو Android Auto طريقة معاودة الاتصال المناسبة لجلسة الوسائط لتنفيذ الإجراء.
وإذا كان تطبيقك يتيح ذلك، يمكن للمستخدم أيضًا البحث في المحتوى. في هذه الحالة، تتصل AAOS أو Android Auto بطريقة onSearch() في خدمتك.
لمزيد من المعلومات، يُرجى الاطّلاع على عرض نتائج البحث القابلة للتصفّح.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Media browser service lifecycle\n\nThis section describes how Android Automotive OS (AAOS) and Android Auto\ninteract with your media browser service during a typical user workflow:\n\n1. The user launches your app on AAOS or Android Auto.\n\n2. The host app binds to your media browser service, which the OS starts if it\n isn't already running. In your implementation of the `onCreate()` method,\n you must create and register a [`MediaSessionCompat`](/reference/android/support/v4/media/session/MediaSessionCompat) object and its\n callback object. To learn more, see [Register a media session](/training/cars/media/enable-playback#registering_mediasession).\n\n3. AAOS or Android Auto calls your service's [`onGetRoot`](/training/cars/media/content-hierarchy#onGetRoot) method to\n retrieve the root in your content hierarchy. The root is not displayed.\n Instead, it retrieves more content from your app in subsequent steps.\n\n4. AAOS or Android Auto calls your service's [`onLoadChildren()`](/reference/androidx/media/MediaBrowserServiceCompat#onLoadChildren(java.lang.String,androidx.media.MediaBrowserServiceCompat.Result%3Cjava.util.List%3Candroid.support.v4.media.MediaBrowserCompat.MediaItem%3E%3E)%5D) method to\n retrieve the descendants of the root media item. AAOS and Android Auto\n display these media items as the top level of content items. See\n [Structure the root menu](/training/cars/media/content-media-browser/content-hierarchy#root-menu-structure) to learn more about what the system expects.\n\n5. When the user selects a **browsable** media item, your service's\n `onLoadChildren()` method is called again.\n\n6. If the user selects a **playable** media item, AAOS or Android Auto calls\n the appropriate media session callback method to perform the action.\n\n7. If supported by your app, the user can also search your content. In this\n case, AAOS or Android Auto call your service's [`onSearch()`](/reference/androidx/media/MediaBrowserServiceCompat#onSearch(java.lang.String,android.os.Bundle,androidx.media.MediaBrowserServiceCompat.Result%3Cjava.util.List%3Candroid.support.v4.media.MediaBrowserCompat.MediaItem%3E%3E)) method.\n To learn more, see [Display browsable search results](/training/cars/media/create-media-browser/browsable-search)."]]
