مسیریابی بین دستگاه ها
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
از آنجایی که کاربران تلویزیون‌ها، سیستم‌های سینمای خانگی و پخش‌کننده‌های موسیقی خود را با فناوری‌های بی‌سیم متصل می‌کنند، می‌خواهند محتوای برنامه‌های Android را در این دستگاه‌های بزرگتر و با صدای بلندتر پخش کنند. فعال کردن این نوع پخش می‌تواند برنامه تک‌دستگاهی و یک کاربره شما را به تجربه‌ای مشترک تبدیل کند که چندین کاربر را به وجد می‌آورد و الهام می‌بخشد.
API های مسیریاب رسانه اندروید برای فعال کردن نمایش و پخش رسانه در دستگاه های گیرنده راه دور با استفاده از یک رابط کاربری مشترک طراحی شده اند. توسعه‌دهندگان برنامه‌ای که رابط MediaRouter را پیاده‌سازی می‌کنند، می‌توانند به فریم‌ورک متصل شوند و محتوا را با دستگاه‌هایی که در چارچوب روتر رسانه مشارکت دارند پخش کنند. سازندگان دستگاه‌های پخش رسانه می‌توانند با انتشار MediaRouteProvider در چارچوب شرکت کنند که به برنامه‌های کاربردی دیگر اجازه می‌دهد به دستگاه‌های گیرنده متصل شده و رسانه را پخش کنند. شکل 1 نشان می دهد که چگونه یک برنامه از طریق چارچوب روتر رسانه به دستگاه گیرنده متصل می شود.
شکل 1. بررسی اجمالی نحوه ارتباط کلاس های ارائه دهنده مسیر رسانه از یک برنامه رسانه به یک دستگاه گیرنده.
توجه: اگر می‌خواهید برنامه شما از دستگاه‌های Google Cast پشتیبانی کند، باید از Cast SDK استفاده کنید و برنامه خود را به‌عنوان فرستنده Cast بسازید. به جای استفاده مستقیم از چارچوب MediaRouter، دستورالعمل‌های موجود در مستندات Cast را دنبال کنید.
کتابخانه پشتیبانی MediaRouter
API های مدیاروتر در کتابخانه MediaRouter AndroidX تعریف شده اند. این کتابخانه با دستگاه‌های دارای Android 2.3 (سطح API 9) و بالاتر سازگار است و تجربه‌ای ثابت را در همه آنها تضمین می‌کند. برای اطلاعات دقیق در مورد API های مدیاروتر، بسته androidx.mediarouter.media را در مرجع API ببینید.
- MediaRouter API
- یک برنامه رسانه از
MediaRouter API برای کشف دستگاه های پخش از راه دور موجود و مسیریابی صدا و تصویر به آنها استفاده می کند. - MediaRouteProvider API
-
MediaRouteProvider API قابلیت های یک دستگاه پخش از راه دور را تعریف می کند و آن را برای برنامه هایی که از MediaRouter برای جستجوی مسیرهای رسانه جایگزین استفاده می کنند قابل مشاهده می کند.
سوئیچر خروجی
با شروع Android 11، گزینه های مسیریابی برنامه شما نیز در پخش کننده رسانه سیستم ظاهر می شود. این به کاربر کمک می‌کند هنگام حرکت بین دستگاه‌ها سفری بی‌نظیر داشته باشد، زیرا آنها زمینه‌های مشاهده و گوش دادن خود را تغییر می‌دهند، مانند تماشای ویدیو در آشپزخانه در مقابل تلفن، یا گوش دادن به صدا در خانه یا ماشین.
با فشار دادن دکمه انتخاب مسیر در اعلان رسانه، سوئیچر خروجی با این گزینه ها به طور پیش فرض ظاهر می شود:
- بلندگو در دستگاه فعلی
- همه دستگاه‌های صوتی بلوتوث متصل
برنامه ها همچنین بسته به قابلیت های خود می توانند گزینه های بیشتری مانند Cast ارائه دهند.
برنامه‌ها می‌توانند از MediaRouter API برای سفارشی کردن انتخاب‌های مسیریابی استفاده کنند. می‌توانید دستگاه‌هایی را که پشتیبانی نمی‌کنید حذف کنید (مانند فیلتر کردن Chromecast فقط صوتی اگر در حال تماشای تلویزیون هوشمند Netflix هستید) یا سایر دستگاه‌های ویژه‌ای را که برنامه شما می‌شناسد اضافه کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و 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."]]
