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