التوجيه بين الأجهزة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مع ربط المستخدمين أجهزة التلفزيون وأنظمة المسرح المنزلي ومشغّلات الموسيقى بتقنيات لاسلكية، أصبحوا يريدون تشغيل المحتوى من تطبيقات Android على هذه الأجهزة الأكبر حجمًا والأعلى صوتًا. يمكن أن يؤدي تفعيل هذا النوع من التشغيل إلى تحويل تطبيقك الذي يتيح استخدام جهاز واحد ومستخدم واحد إلى تجربة مشتركة تسرّ المستخدمين المتعدّدين وتلهمهم.
تم تصميم واجهات برمجة التطبيقات الخاصة بموجّه الوسائط في 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 API
- تحدّد واجهة برمجة التطبيقات
MediaRouteProvider إمكانات جهاز التشغيل عن بُعد وتتيح للتطبيقات التي تستخدم MediaRouter إمكانية البحث عن مسارات وسائط بديلة.
أداة التبديل بين أجهزة التشغيل
بدءًا من Android 11، تظهر خيارات التوجيه في تطبيقك أيضًا في مشغّل الوسائط التابع للنظام. يساعد ذلك في توفير تجربة سلسة للمستخدم عند التنقّل بين الأجهزة أثناء تغيير سياقات المشاهدة والاستماع، مثلاً عند مشاهدة فيديو في المطبخ مقارنةً بمشاهدته على الهاتف، أو عند الاستماع إلى محتوى صوتي في المنزل أو السيارة.
يؤدي الضغط على زر اختيار مسار الصوت في إشعار الوسائط إلى فتح أداة التبديل بين مصادر إخراج الصوت مع هذه الخيارات تلقائيًا:
- مكبّر الصوت على الجهاز الحالي
- جميع الأجهزة الصوتية المتّصلة باستخدام البلوتوث
يمكن للتطبيقات أيضًا توفير المزيد من الخيارات استنادًا إلى إمكاناتها، مثل ميزة "البث".
يمكن للتطبيقات استخدام واجهة برمجة التطبيقات MediaRouter
لتخصيص
خيارات التوجيه. يمكنك استبعاد الأجهزة غير المتوافقة (مثل فلترة أجهزة Chromecast التي تعمل بالصوت فقط إذا كنت تشاهد محتوى على تلفزيون ذكي من Netflix) أو تضمين أجهزة خاصة أخرى يتعرّف عليها تطبيقك.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Routing between devices\n\nAs users connect their televisions, home theater systems, and music players with wireless\ntechnologies, they want to be able to play content from Android apps on these larger,\nlouder devices. Enabling this kind of playback can turn your one-device, one-user app\ninto a shared experience that delights and inspires multiple users.\n\n\u003cbr /\u003e\n\nThe Android media router APIs are designed to enable media display and playback on\nremote receiver devices using a common user interface. App developers that\nimplement a [MediaRouter](/reference/androidx/mediarouter/media/MediaRouter) interface can then connect to the\nframework and play content to devices that participate in the media router framework. Media\nplayback device manufacturers can participate in the framework by publishing a [MediaRouteProvider](/reference/androidx/mediarouter/media/MediaRouteProvider) that allows other applications to connect to and\nplay media on the receiver devices. Figure 1 illustrates how an app connects to a receiver\ndevice through the media router framework.\n\n\u003cbr /\u003e\n\n\n**Figure 1.** Overview of how media route provider classes provide communication\nfrom a media app to a receiver device.\n\n\u003cbr /\u003e\n\n\n**Note:** If you want your app to support\n[Google Cast](https://developers.google.com/cast/) devices,\nyou should use the [Cast SDK](https://developers.google.com/cast/docs/reference/)\nand build your app as a Cast sender. Follow the directions in the\n[Cast documentation](https://developers.google.com/cast/docs/android_sender_setup)\ninstead of using the MediaRouter framework directly.\n\nMediaRouter support library\n---------------------------\n\nThe mediarouter APIs are defined in the\n[AndroidX MediaRouter library](/guide/topics/media/mediarouter).\nThis library is compatible with devices running Android 2.3 (API level 9) and higher and ensures a consistent\nexperience across all of them.\nFor detailed information about the mediarouter APIs, see the [androidx.mediarouter.media](/reference/androidx/mediarouter/media/package-summary)\npackage in the API reference.\n\n**[MediaRouter API](/guide/topics/media/mediarouter)**\n: A media app uses the `MediaRouter` API to discover available remote playback devices and to route audio and video to them.\n\n**[MediaRouteProvider API](/guide/topics/media/mediarouteprovider)**\n: The `MediaRouteProvider` API defines the capabilities of a remote playback device and makes it visible to apps that use a `MediaRouter` to search for alternative media paths.\n\nThe output switcher\n-------------------\n\nStarting with Android 11, your app's routing\noptions also appear in the system media player. This helps to give the user a\nseamless journey when moving between devices as they change their viewing and\nlistening contexts, such as watching video in the kitchen versus on a phone,\nor listening to audio in the home or car.\n\nPressing the route selection button in a media notification brings up the\noutput switcher with these choices by default:\n\n- The speaker on the current device\n- All connected Bluetooth audio devices\n\nApps can also provide more options depending on their capabilities, such as Cast.\n\nApps can use the [`MediaRouter`](/reference/androidx/mediarouter/media/MediaRouter)\nAPI to customize\nthe routing choices. You can exclude devices you don't support (like filtering\nout audio-only Chromecast if you're watching a Netflix smart TV) or include\nother special devices that your app recognizes."]]
