يفترض هذا الدليل أنّ لديك تطبيق وسائط يشغّل الصوت على الهاتف وأنّ تطبيق الوسائط يتوافق مع بنية تطبيقات الوسائط على Android. ستتعرّف أيضًا على ما يحتاج إليه تطبيقك من MediaBrowserService
وMediaSession
ليعمل على Android Auto أو AAOS. بعد إكمال البنية الأساسية للوسائط، يمكنك إضافة توافق تطبيق الوسائط مع Android Auto وAAOS.
المحتويات
توضّح هذه الصفحات كيفية استخدام تطبيقات الوسائط:
- ضبط ملف البيان
- تفعيل عناصر التحكّم في التشغيل
- إتاحة الإجراءات الصوتية
- تنفيذ إجراءات وقائية ضد التشتيت
- التعامل مع الأخطاء
إنشاء تطبيقات وسائط صوتية
إذا كان تطبيقك يركّز على تشغيل الوسائط الصوتية، استخدِم الأدوات الموضّحة هنا. يمكنك إنشاء تطبيقات وسائط للسيارات بإحدى الطريقتَين التاليتَين:
استخدِم
MediaBrowserService
وMediaSession
لإنشاء تطبيق يمكن ربطه بتطبيق Android Auto وAndroid Automotive OS. يتيح ذلك لواجهة شاشة نظام المعلومات والترفيه عرض واجهات المستخدم الخاصة بتصفّح الوسائط وتشغيلها، وهي واجهات محسَّنة للاستخدام داخل السيارة.أو
استخدِم نماذج مكتبة تطبيقات السيارات لإنشاء تطبيقات تتضمّن تجربة مخصّصة لتصفّح الوسائط وتشغيلها، بما في ذلك الإجراءات المخصّصة. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء تطبيق وسائط يستند إلى نماذج.
يفترض هذا الدليل أنّ لديك تطبيق وسائط يشغّل الصوت على الهاتف وأنّ تطبيق الوسائط يتوافق مع بنية تطبيق الوسائط في Android. يوضّح هذا الدليل المكوّنات المطلوبة MediaBrowserService
وMediaSession
التي يحتاجها تطبيقك ليكون متوافقًا مع Android Auto أو Android Automotive OS. بعد إكمال البنية الأساسية لتطبيق الوسائط، يمكنك إضافة إمكانية التشغيل على Android Auto وإضافة إمكانية التشغيل على Android Automotive OS إلى تطبيق الوسائط.
إنشاء تطبيقات وسائط فيديو
إذا كان المحتوى الأساسي الذي يوفّره تطبيقك هو الفيديو، يُرجى الاطّلاع على ما يلي:
قبل البدء
يُرجى الرجوع إلى:
- مستندات حول واجهة برمجة تطبيقات الوسائط في Android
- إرشادات التصميم: إنشاء تطبيقات وسائط
- المصطلحات: المصطلحات والمفاهيم الرئيسية
التعرّف على المصطلحات والمفاهيم الرئيسية
تُستخدَم هذه المصطلحات في ما يتعلق بإنشاء تطبيقات وسائط للسيارات:
- متصفّح الوسائط
- واجهة برمجة تطبيقات تستخدمها تطبيقات الوسائط لاكتشاف خدمات متصفّح الوسائط وعرض محتواها. يستخدم كل من Android Auto وAAOS متصفّح وسائط للعثور على خدمة متصفّح الوسائط في تطبيقك.
- خدمة متصفّح الوسائط
- هي خدمة Android ينفّذها تطبيق الوسائط الخاص بك وتتوافق مع واجهة برمجة التطبيقات
MediaBrowserServiceCompat
. يستخدم تطبيقك هذه الخدمة لعرض المحتوى. نوفّر أيضًا `MediaLibrarySerice'. - ملف وسائط
ينظّم مستعرض الوسائط المحتوى في شجرة من عناصر
MediaItem
. يمكن أن يتضمّن عنصر الوسائط أحد هذين الخيارَين أو كليهما. يعمل عنصر الوسائط الذي يمكن تصفّحه وتشغيله مثل قائمة تشغيل. يمكنك اختيار العنصر لتشغيل جميع العناصر الفرعية، أو يمكنك تصفّح العناصر الفرعية.
يشير الرمز
FLAG_PLAYABLE
إلى أنّ العنصر هو ورقة في شجرة المحتوى. يمثّل العنصر بثًا صوتيًا واحدًا، مثل أغنية في ألبوم أو فصل في كتاب صوتي أو حلقة من برنامج بودكاست.يشير الرمز
FLAG_BROWSABLE
إلى أنّ العنصر هو عقدة في شجرة المحتوى ويتضمّن عناصر فرعية. على سبيل المثال، يمثّل العنصر ألبومًا، والعناصر التابعة له هي الأغاني الموجودة في الألبوم.
الاطّلاع على مراجع إضافية
للحصول على معلومات إضافية، يُرجى الاطّلاع على: