عندما يربط المستخدمون أجهزة التلفزيون وأنظمة المسرح المنزلي ومشغّلات الموسيقى بتقنيات لاسلكية، يريدون أن يتمكّنوا من تشغيل المحتوى من تطبيقات Android على هذه الأجهزة ذات الحجم الأكبر والصوت. يمكن أن يؤدي تفعيل هذا النوع من التشغيل إلى تحويل التطبيق المخصّص لمستخدم واحد إلى تجربة مشتركة تُسعد العديد من المستخدمين وتلهمهم.
تم تصميم واجهات برمجة التطبيقات لأجهزة توجيه الوسائط لنظام التشغيل Android لإتاحة عرض الوسائط وتشغيلها على أجهزة الاستقبال عن بُعد باستخدام واجهة مستخدم مشتركة. يمكن لمطوّري التطبيقات الذين ينفّذون واجهة MediaRouter
الاتصال بإطار العمل وتشغيل المحتوى على الأجهزة التي تشارك في إطار عمل جهاز توجيه الوسائط. ويمكن للشركات المصنّعة لأجهزة تشغيل الوسائط المشاركة في إطار العمل من خلال نشر MediaRouteProvider
تسمح للتطبيقات الأخرى بالاتصال
بالوسائط وتشغيلها على أجهزة الاستقبال. يوضّح الشكل 1 كيفية توصيل تطبيق بجهاز استقبال من خلال إطار عمل جهاز توجيه الوسائط.
ملاحظة: إذا كنت تريد أن يتوافق تطبيقك مع أجهزة Google Cast، يجب استخدام حزمة تطوير البرامج (SDK) الخاصة بالبثّ وإنشاء تطبيقك كمُرسِل يعمل بتكنولوجيا Google Cast. اتّبِع الإرشادات الواردة في مستندات البث بدلاً من استخدام إطار عمل MediaRouter مباشرةً.
مكتبة دعم MediaRouter
يتم تحديد واجهات برمجة تطبيقات Mediarouter في مكتبة MediaRouter Android.
هذه المكتبة متوافقة مع الأجهزة التي تعمل بالإصدار 2.3 من نظام التشغيل Android (المستوى 9 لواجهة برمجة التطبيقات) والإصدارات الأحدث، وتضمن هذه المكتبة الحصول على تجربة متّسقة في جميع الأجهزة.
للحصول على معلومات تفصيلية حول واجهات برمجة تطبيقات Mediarouter، يمكنك الاطّلاع على الحزمة androidx.mediarouter.media
في مرجع واجهة برمجة التطبيقات.
- MediaRouter API
- يستخدم تطبيق وسائط واجهة برمجة التطبيقات
MediaRouter
لاكتشاف أجهزة التشغيل عن بُعد المتاحة وتوجيه الصوت والفيديو إليها. - واجهة برمجة تطبيقات MediaRouteProvider
- تحدِّد واجهة برمجة التطبيقات
MediaRouteProvider
إمكانات جهاز التشغيل عن بُعد وتجعله مرئيًا للتطبيقات التي تستخدمMediaRouter
للبحث عن مسارات وسائط بديلة.
مبدِّل الإخراج
بدءًا من نظام التشغيل Android 11، تظهر خيارات التوجيه في تطبيقك أيضًا في مشغّل وسائط النظام. يساعد هذا في منح المستخدم رحلة سلسة عند التنقل بين الأجهزة أثناء تغيير سياقات المشاهدة والاستماع، مثل مشاهدة الفيديو في المطبخ مقابل استخدام الهاتف، أو الاستماع إلى الصوت في المنزل أو السيارة.
يؤدي الضغط على زر تحديد المسار في إشعار الوسائط إلى إظهار مبدِّل الإخراج مع هذه الخيارات تلقائيًا:
- مكبّر الصوت في الجهاز الحالي
- جميع الأجهزة السماعية المتصلة التي تتضمّن بلوتوث
يمكن أن توفر التطبيقات أيضًا المزيد من الخيارات بناءً على إمكاناتها، مثل البث.
يمكن للتطبيقات استخدام واجهة برمجة التطبيقات MediaRouter
لتخصيص خيارات التوجيه. يمكنك استبعاد الأجهزة غير المتوافقة (مثل فلترة Chromecast للصوت فقط إذا كنت تشاهد تلفزيون Netflix الذكي) أو تضمين
الأجهزة الخاصة الأخرى التي يتعرف عليها تطبيقك.