Android TV

การไปยังส่วนต่างๆ ด้วย D-pad บน Android TV

รีโมตคอนโทรลของ Android TV มีการควบคุม D-pad ที่ส่งคำสั่งซึ่ง มาถึงเป็นเหตุการณ์สำคัญที่ dispatchKeyEvent(KeyEvent) ของ Activity คุณต้องมอบสิทธิ์ต่อไปนี้ให้แก่ PlayerView

Kotlin

override fun dispatchKeyEvent(event: KeyEvent?): Boolean {
  return playerView.dispatchKeyEvent(event!!) || super.dispatchKeyEvent(event)
}

Java

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
  return playerView.dispatchKeyEvent(event) || super.dispatchKeyEvent(event);
}

การขอโฟกัสสำหรับ PlayerView มีความสำคัญต่อการไปยังส่วนควบคุมการเล่น และข้ามโฆษณา ลองขอให้โฟกัสที่ onCreate ของ Activity

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView.requestFocus()
  // ...
}

Java

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  // ...
  playerView.requestFocus();
  // ...
}

หากใช้ Compose ใน Android TV คุณต้องทำให้ AndroidView โฟกัสได้และมอบสิทธิ์เหตุการณ์โดยส่งพารามิเตอร์ตัวแก้ไขไปยัง AndroidView ตามนั้น

AndroidView(
  modifier = modifier.focusable().onKeyEvent { playerView.dispatchKeyEvent(it.nativeKeyEvent) },
  factory = { playerView },
)

ใช้ Composable Player

หากคุณใช้ Player ที่ประกอบได้จากไลบรารี media3-ui-compose-material3 ระบบจะรองรับการนำทางด้วย D-pad โดยค่าเริ่มต้น คอมโพเนนต์ Player และ PlayerDefaults มีอินสแตนซ์ FocusRequester อัตโนมัติที่ เคลื่อนที่ผ่านคอมโพเนนต์ด้วย D-pad คุณจึงไม่จำเป็นต้องมีโค้ดเพิ่มเติมหรือ Modifier.focusRequester เพื่อจัดการเหตุการณ์โฟกัสและเหตุการณ์คีย์

PlayerDefaults จะจัดเรียงในช่องด้านบน ตรงกลาง และด้านล่างเพื่อให้การนำทางด้วย D-pad ใช้งานง่าย สำหรับการปรับแต่งและการลบล้างช่องเหล่านั้น โปรดตรวจสอบว่าคุณได้ระบุคอมโพเนนต์ที่นำทางได้ดี โปรดทราบว่าคอมโพเนนต์ Compose ส่วนใหญ่ เช่น Slider หรือ Row ที่มีปุ่ม จะจัดการโฟกัส ได้ทันที