การกำหนดเส้นทางระหว่างอุปกรณ์
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เมื่อผู้ใช้เชื่อมต่อโทรทัศน์ ระบบโฮมเธียเตอร์ และเครื่องเล่นเพลงด้วยเทคโนโลยีไร้สาย
ผู้ใช้จะต้องการเล่นเนื้อหาจากแอป Android บนอุปกรณ์ขนาดใหญ่และเสียงดังกว่าเหล่านี้
การเปิดใช้การเล่นประเภทนี้จะเปลี่ยนแอปแบบ 1 อุปกรณ์ 1 ผู้ใช้
ให้กลายเป็นประสบการณ์ที่แชร์ร่วมกันซึ่งสร้างความพึงพอใจและแรงบันดาลใจให้แก่ผู้ใช้หลายคน
API ของเราเตอร์สื่อ Android ได้รับการออกแบบมาเพื่อเปิดใช้การแสดงและการเล่นสื่อใน
อุปกรณ์รับสัญญาณระยะไกลโดยใช้อินเทอร์เฟซผู้ใช้ทั่วไป นักพัฒนาแอปที่ใช้MediaRouterอินเทอร์เฟซจะเชื่อมต่อกับเฟรมเวิร์กและเล่นเนื้อหาไปยังอุปกรณ์ที่เข้าร่วมในเฟรมเวิร์ก Media Router ได้ ผู้ผลิตอุปกรณ์เล่นสื่อ
สามารถเข้าร่วมเฟรมเวิร์กได้โดยการเผยแพร่ MediaRouteProvider ที่อนุญาตให้แอปพลิเคชันอื่นๆ เชื่อมต่อและ
เล่นสื่อบนอุปกรณ์รับสัญญาณ รูปที่ 1 แสดงวิธีที่แอปเชื่อมต่อกับอุปกรณ์ตัวรับ
ผ่านเฟรมเวิร์กเราเตอร์สื่อ
รูปที่ 1 ภาพรวมของวิธีที่คลาสผู้ให้บริการเส้นทางสื่อให้การสื่อสาร
จากแอปสื่อไปยังอุปกรณ์รับ
หมายเหตุ: หากต้องการให้แอปของคุณรองรับอุปกรณ์ Google Cast
คุณควรใช้ Cast SDK
และสร้างแอปเป็นตัวส่ง Cast ทำตามวิธีการในเอกสารประกอบของ Cast
แทนการใช้เฟรมเวิร์ก MediaRouter โดยตรง
ไลบรารีการสนับสนุน MediaRouter
API ของ MediaRouter มีการกำหนดไว้ในไลบรารี AndroidX MediaRouter
ไลบรารีนี้เข้ากันได้กับอุปกรณ์ที่ใช้ Android 2.3 (API ระดับ 9) ขึ้นไป และช่วยให้มั่นใจได้ถึงประสบการณ์การใช้งานที่สอดคล้องกันในอุปกรณ์ทั้งหมด
ดูข้อมูลโดยละเอียดเกี่ยวกับ API ของ MediaRouter ได้ที่androidx.mediarouter.media
แพ็กเกจในข้อมูลอ้างอิง API
- MediaRouter API
- แอปสื่อใช้
MediaRouter API เพื่อค้นหาอุปกรณ์การเล่นระยะไกลที่พร้อมใช้งานและกำหนดเส้นทางเสียงและวิดีโอไปยังอุปกรณ์เหล่านั้น
- MediaRouteProvider API
MediaRouteProvider API จะกำหนดความสามารถของอุปกรณ์การเล่นระยะไกลและทำให้แอปที่ใช้ MediaRouter มองเห็นอุปกรณ์ดังกล่าวเพื่อค้นหาเส้นทางสื่ออื่น
ตัวสลับเอาต์พุต
ตั้งแต่ Android 11 เป็นต้นไป ตัวเลือกการกำหนดเส้นทางของแอปจะปรากฏในมัลติมีเดียเพลเยอร์ของระบบด้วย ซึ่งจะช่วยให้ผู้ใช้ได้รับ
เส้นทางที่ราบรื่นเมื่อเปลี่ยนอุปกรณ์ขณะเปลี่ยนบริบทการดูและ
การฟัง เช่น การดูวิดีโอในครัวเทียบกับการดูบนโทรศัพท์
หรือการฟังเสียงในบ้านหรือรถยนต์
การกดปุ่มเลือกเส้นทางในการแจ้งเตือนสื่อจะแสดงตัวสลับเอาต์พุตพร้อมตัวเลือกต่อไปนี้โดยค่าเริ่มต้น
- ลำโพงในอุปกรณ์ปัจจุบัน
- อุปกรณ์เสียงบลูทูธที่เชื่อมต่อทั้งหมด
นอกจากนี้ แอปยังอาจมีตัวเลือกเพิ่มเติมโดยขึ้นอยู่กับความสามารถของแอป เช่น Cast
แอปสามารถใช้ MediaRouter
API เพื่อปรับแต่ง
ตัวเลือกการกำหนดเส้นทางได้ คุณสามารถยกเว้นอุปกรณ์ที่ไม่รองรับ (เช่น กรอง
Chromecast ที่เล่นได้เฉพาะเสียงออกหากคุณกำลังดู Netflix บนสมาร์ททีวี) หรือรวม
อุปกรณ์พิเศษอื่นๆ ที่แอปของคุณรู้จัก
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-27 UTC
[[["เข้าใจง่าย","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 UTC"],[],[],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."]]
