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

ตัวควบคุมสื่อจะโต้ตอบกับเซสชันสื่อเพื่อค้นหาและควบคุมการเล่นของแอปสื่อ ใน 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.Listener ลงในตัวควบคุมเพื่อรอฟังการเปลี่ยนแปลงในสถานะ Player ดูรายละเอียดเพิ่มเติมเกี่ยวกับการใช้ Player.Listener ได้จากคู่มือเหตุการณ์ของผู้เล่น อินเทอร์เฟซ MediaController.Listener จะกำหนดการเรียกกลับเพิ่มเติมสำหรับเหตุการณ์และคำสั่งขาเข้าจาก MediaSession ที่เชื่อมต่อ เช่น onAvailableSessionCommandsChanged() สำหรับกรณีที่เซสชันสื่อเปลี่ยนคำสั่งเซสชันที่ใช้ได้ และ onDisconnected() สำหรับกรณีที่ตัวควบคุมถูกตัดการเชื่อมต่อจากเซสชัน

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

Kotlin

MediaController.releaseFuture(controllerFuture)

Java

MediaController.releaseFuture(controllerFuture);

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

สร้างและใช้ MediaBrowser

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

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());

หากต้องการเริ่มเรียกดูคลังเนื้อหาของแอปสื่อ ให้ดึงข้อมูลโหนดรูทก่อน ด้วย 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());