เชื่อมต่อกับแอปสื่อ

การเชื่อมต่อกับแอปสื่อทำได้ 2 วิธีดังนี้

1. MediaController
2. MediaBrowser

MediaController

ตัวควบคุมสื่อจะโต้ตอบกับเซสชันสื่อเพื่อค้นหาและควบคุมการเล่นของแอปสื่อ ใน Media3 MediaController API จะใช้Playerอินเทอร์เฟซ ตัวอย่างแอปไคลเอ็นต์ที่ใช้ตัวควบคุมสื่อมีดังนี้

• การควบคุมสื่อของระบบ Android
• แอปที่ใช้ร่วมกับ Android Wear OS
• Android Auto และ Automotive OS
• ผู้ช่วยแบบเสียง เช่น Google Assistant
• แอปทดสอบตัวควบคุมสื่อ

ตัวควบคุมสื่อยังมีประโยชน์ภายในแอปสื่อด้วย เช่น หากเพลเยอร์และเซสชันสื่ออยู่ใน Service แยกจาก Activity หรือ Fragment ที่มี UI

สร้าง MediaController

หากต้องการสร้าง MediaController ให้เริ่มด้วยการสร้าง SessionToken สำหรับ MediaSession ที่เกี่ยวข้อง onStart() วิธีการของ Activity หรือ Fragment อาจเป็นจุดเริ่มต้นที่ดี

Kotlin

val sessionToken =
  SessionToken(context, ComponentName(context, PlaybackService::class.java))

Java

SessionToken sessionToken =
  new SessionToken(context, new ComponentName(context, PlaybackService.class));

การใช้ SessionToken นี้เพื่อสร้าง MediaController จะเชื่อมต่อ คอนโทรลเลอร์กับเซสชันที่ระบุ การดำเนินการนี้จะเกิดขึ้นแบบไม่พร้อมกัน ดังนั้นคุณควร รอฟังผลลัพธ์และใช้เมื่อพร้อมใช้งาน

Kotlin

val controllerFuture =
  MediaController.Builder(context, sessionToken).buildAsync()
controllerFuture.addListener({
  // MediaController is available here with controllerFuture.get()
}, MoreExecutors.directExecutor())

Java

ListenableFuture<MediaController> controllerFuture =
  new MediaController.Builder(context, sessionToken).buildAsync();
controllerFuture.addListener(() -> {
  // MediaController is available here with controllerFuture.get()
}, MoreExecutors.directExecutor());

หมายเหตุ: ใช้ ContextCompat.getMainExecutor() แทน MoreExecutors.directExecutor() ในกรณีที่คุณเรียกใช้บริการในกระบวนการอื่นที่ไม่ใช่ UI

หมายเหตุ: แอปที่กำหนดเป้าหมายเป็น SDK ระดับ 30 ขึ้นไปต้องมีองค์ประกอบ <queries> ในไฟล์ Manifest เพื่อเชื่อมต่อกับ MediaSessionService ของแอปอื่น (หรือ คอมโพเนนต์ที่คล้ายกัน) ดูรายละเอียดเพิ่มเติมได้ในคำแนะนำเกี่ยวกับระดับการมองเห็นของแพ็กเกจ

ใช้ MediaController

MediaController ใช้อินเทอร์เฟซ Player คุณจึงสามารถใช้คำสั่งที่กำหนดไว้ในอินเทอร์เฟซเพื่อควบคุมการเล่นของ MediaSession ที่เชื่อมต่อ กล่าวคือ การเรียกใช้ play() ใน MediaController จะส่งคำสั่งไปยัง MediaSession ที่เชื่อมต่ออยู่ ซึ่งจากนั้นจะมอบสิทธิ์คำสั่งไปยัง Player ที่อยู่เบื้องหลัง

เคล็ดลับ: ตัวควบคุมสื่อจะใช้อินเทอร์เฟซ Player และคุณจึงใช้ตัวควบคุมสื่อภายใน UI เป็น Player ได้

คุณเพิ่ม Player.Listener ลงในตัวควบคุมเพื่อฟังการเปลี่ยนแปลงในสถานะ Player ได้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับการใช้ Player.Listenerได้ในคู่มือเหตุการณ์ของผู้เล่น

อินเทอร์เฟซ MediaController.Listener จะกำหนดการเรียกกลับเพิ่มเติมสำหรับเหตุการณ์ และคำสั่งที่กำหนดเองจาก MediaSession ที่เชื่อมต่อ ตัวอย่างเช่น onCustomCommand() เมื่อเซสชันส่งคำสั่งที่กำหนดเอง onAvailableSessionCommandsChanged() เมื่อเซสชันเปลี่ยนคำสั่งเซสชันที่ใช้ได้ หรือ onDisconnected() เมื่อตัวควบคุมถูกตัดการเชื่อมต่อ จากเซสชัน

คุณตั้งค่า MediaController.Listener ได้เมื่อสร้างตัวควบคุมด้วย Builder ดังนี้

Kotlin

MediaController.Builder(context, sessionToken)
    .setListener(
      object : MediaController.Listener {
        override fun onCustomCommand(
          controller: MediaController,
          command: SessionCommand,
          args: Bundle,
        ): ListenableFuture<SessionResult> {
          // Handle custom command.
          return Futures.immediateFuture(SessionResult(SessionResult.RESULT_SUCCESS))
        }

        override fun onDisconnected(controller: MediaController) {
          // Handle disconnection.
        }
      }
    )
    .buildAsync()

Java

new MediaController.Builder(context, sessionToken)
    .setListener(
        new MediaController.Listener() {
          @Override
          public ListenableFuture<SessionResult> onCustomCommand(
              MediaController controller, SessionCommand command, Bundle args) {
            // Handle custom command.
            return Futures.immediateFuture(new SessionResult(SessionResult.RESULT_SUCCESS));
          }

          @Override
          public void onDisconnected(MediaController controller) {
            // Handle disconnection.
          }
        })
    .buildAsync();

เช่นเดียวกับคอมโพเนนต์อื่นๆ อย่าลืมปล่อย MediaController เมื่อไม่จำเป็นต้องใช้แล้ว เช่น ในเมธอด onStop() ของ Activity หรือ Fragment

Kotlin

MediaController.releaseFuture(controllerFuture)

Java

MediaController.releaseFuture(controllerFuture);

การปล่อยตัวควบคุมจะยังคงส่งคำสั่งที่รอดำเนินการทั้งหมดที่ส่งไปยังเซสชัน และจะยกเลิกการเชื่อมโยงจากบริการเซสชันเมื่อมีการจัดการคำสั่งเหล่านี้หรือหลังจากระยะหมดเวลา แล้วแต่ว่ากรณีใดจะเกิดขึ้นก่อน

MediaBrowser

MediaBrowser สร้างขึ้นจากความสามารถที่ MediaController มีอยู่เพื่อเปิดใช้การเรียกดูคลังสื่อที่ MediaLibraryService ของแอปสื่อนำเสนอด้วย

สร้าง MediaBrowser

Kotlin

val browserFuture = MediaBrowser.Builder(context, sessionToken).buildAsync()
browserFuture.addListener({
  // MediaBrowser is available here with browserFuture.get()
}, MoreExecutors.directExecutor())

Java

ListenableFuture<MediaBrowser> browserFuture =
  new MediaBrowser.Builder(context, sessionToken).buildAsync();
browserFuture.addListener(() -> {
  // MediaBrowser is available here with browserFuture.get()
}, MoreExecutors.directExecutor());

ใช้ MediaBrowser

หากต้องการเริ่มเรียกดูคลังเนื้อหาของแอปสื่อ ให้เรียกข้อมูลโหนดรูทก่อน ด้วย getLibraryRoot():

Kotlin

// Get the library root to start browsing the library tree.
val rootFuture = mediaBrowser.getLibraryRoot(/* params= */ null)
rootFuture.addListener({
  // Root node MediaItem is available here with rootFuture.get().value
}, MoreExecutors.directExecutor())

Java

// Get the library root to start browsing the library tree.
ListenableFuture<LibraryResult<MediaItem>> rootFuture =
  mediaBrowser.getLibraryRoot(/* params= */ null);
rootFuture.addListener(() -> {
  // Root node MediaItem is available here with rootFuture.get().value
}, MoreExecutors.directExecutor());

จากนั้นคุณจะไปยังส่วนต่างๆ ของคลังสื่อได้โดยการดึงข้อมูลรายการย่อยของ MediaItem ในคลังด้วย getChildren() เช่น หากต้องการดึงข้อมูล โหนดลูกของโหนดรูท MediaItem ให้ทำดังนี้

Kotlin

// Get the library root to start browsing the library tree.
val childrenFuture = 
  mediaBrowser.getChildren(rootMediaItem.mediaId, 0, Int.MAX_VALUE, null)
childrenFuture.addListener({
  // List of children MediaItem nodes is available here with
  // childrenFuture.get().value
}, MoreExecutors.directExecutor())

Java

ListenableFuture<LibraryResult<ImmutableList<MediaItem>>> childrenFuture =
  mediaBrowser.getChildren(rootMediaItem.mediaId, 0, Integer.MAX_VALUE, null);
childrenFuture.addListener(() -> {
  // List of children MediaItem nodes is available here with
  // childrenFuture.get().value
}, MoreExecutors.directExecutor());

แสดงตัวควบคุมการเล่นสำหรับแอปสื่ออื่น

เมื่อแสดงตัวควบคุม UI พร้อมปุ่มสำหรับแอปสื่ออื่น คุณต้องทำตามค่ากำหนดของปุ่มสื่อที่ประกาศไว้ของแอปนั้น

วิธีที่ดีที่สุดในการแก้ปัญหาค่ากำหนดของแอปและข้อจำกัดและข้อกำหนดของ UI คือการใช้ CommandButton.DisplayConstraints คุณสามารถ กำหนดขีดจำกัดและข้อจำกัดของสิ่งที่ UI ทำได้ และเมธอด resolve จะแสดงรายการปุ่มที่แน่นอนเพื่อ แสดงพร้อมไอคอน ตำแหน่ง และการดำเนินการที่ต้องการ