As users connect their televisions, home theater systems, and music players with wireless technologies, they want to be able to play content from Android apps on these larger, louder devices. من خلال تفعيل هذا النوع من التشغيل، يمكنك تحويل تطبيقك المخصّص لجهاز واحد ومستخدم واحد إلى تجربة مشتركة تسعد وتلهم العديد من المستخدمين.
تم تصميم واجهات برمجة التطبيقات لموجّه الوسائط في Android لإتاحة عرض الوسائط وتشغيلها على أجهزة الاستقبال عن بُعد باستخدام واجهة مستخدم مشتركة. ويمكن لمطوّري التطبيقات الذين يستخدمون واجهة MediaRouter الاتصال بإطار العمل وتشغيل المحتوى على الأجهزة التي تشارك في إطار عمل موجّه الوسائط. يمكن للشركات المصنّعة لأجهزة تشغيل الوسائط المشاركة في إطار العمل من خلال نشر MediaRouteProvider يسمح للتطبيقات الأخرى بالاتصال بأجهزة الاستقبال وتشغيل الوسائط عليها. يوضّح الشكل 1 كيفية اتصال أحد التطبيقات بجهاز استقبال
من خلال إطار عمل جهاز توجيه الوسائط.
الشكل 1: نظرة عامة على كيفية توفير فئات موفِّر مسار الوسائط للاتصال من تطبيق وسائط إلى جهاز استقبال
ملاحظة: إذا أردت أن يكون تطبيقك متوافقًا مع أجهزة Google Cast، عليك استخدام حزمة تطوير البرامج (SDK) لتطبيق Cast وإنشاء تطبيقك كجهاز إرسال Cast. اتّبِع التوجيهات الواردة في مستندات Cast بدلاً من استخدام إطار عمل MediaRouter مباشرةً.
مكتبة دعم MediaRouter
يتم تحديد واجهات برمجة التطبيقات mediarouter في
مكتبة AndroidX MediaRouter.
تتوافق هذه المكتبة مع الأجهزة التي تعمل بنظام التشغيل Android 2.3 (مستوى واجهة برمجة التطبيقات 9) والإصدارات الأحدث، وتضمن توفير تجربة متّسقة على جميع هذه الأجهزة.
للحصول على معلومات تفصيلية حول واجهات برمجة التطبيقات الخاصة بـ mediarouter، يُرجى الاطّلاع على حزمة androidx.mediarouter.media في مرجع واجهة برمجة التطبيقات.
- MediaRouter API
- يستخدم تطبيق الموسيقى واجهة برمجة التطبيقات
MediaRouterلاكتشاف أجهزة التشغيل عن بُعد المتاحة وتوجيه الصوت والفيديو إليها. - واجهة برمجة التطبيقات MediaRouteProvider
- تحدّد واجهة برمجة التطبيقات
MediaRouteProviderإمكانات جهاز التشغيل عن بُعد وتجعله مرئيًا للتطبيقات التي تستخدمMediaRouterللبحث عن مسارات وسائط بديلة.
أداة التبديل بين أجهزة التشغيل
بدءًا من الإصدار Android 11، تظهر أيضًا خيارات توجيه تطبيقك في مشغّل الوسائط الخاص بالنظام. يساعد ذلك في توفير تجربة سلسة للمستخدم عند التنقّل بين الأجهزة أثناء تغيير سياقات المشاهدة والاستماع، مثل مشاهدة فيديو في المطبخ مقارنةً بمشاهدته على الهاتف، أو الاستماع إلى محتوى صوتي في المنزل أو السيارة.
يؤدي الضغط على زر اختيار المسار في إشعار الوسائط إلى عرض "أداة تبديل مصدر الصوت" مع الخيارات التالية تلقائيًا:
- مكبّر الصوت على الجهاز الحالي
- جميع الأجهزة الصوتية المتصلة عبر البلوتوث
يمكن أن توفّر التطبيقات أيضًا المزيد من الخيارات بناءً على إمكاناتها، مثل ميزة "البث".
يمكن للتطبيقات استخدام واجهة برمجة التطبيقات MediaRouter لتخصيص خيارات التوجيه. يمكنك استبعاد الأجهزة التي لا تدعمها (مثل تصفية
Chromecast الصوتي فقط إذا كنت تشاهد تلفزيون Netflix الذكي) أو تضمين
أجهزة خاصة أخرى يتعرف عليها تطبيقك.