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 },
)

ใช้คอมโพสได้ Player

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

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