Android TV

ניווט באמצעות לחצני החיצים ב-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

אם משתמשים ב-composable‏ Player מהספרייה media3-ui-compose-material3, הניווט באמצעות לחצני החיצים נתמך כברירת מחדל. לרכיבים Player ו-PlayerDefaults יש מופע אוטומטי של FocusRequester שמעביר את הרכיבים באמצעות לחצני החיצים, כך שלא צריך קוד נוסף או Modifier.focusRequester כדי לטפל באירועי מיקוד ומקשים:

הלחצנים PlayerDefaults מסודרים במשבצות בחלק העליון, במרכז ובחלק התחתון, כך שהניווט בלחצני החיצים מרגיש אינטואיטיבי. אם מבצעים התאמות אישיות ושינויים במשבצות האלה, חשוב לספק רכיב שקל לנווט בו. הערה: רוב הרכיבים של Compose, כמו Slider או Row שמכילים לחצנים, מנהלים את המיקוד באופן אוטומטי.