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)
}
AndroidTv.kt

Java

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

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

Kotlin

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

Java

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

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

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

ใช้ Composable Player

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

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