Android TV

ניווט באמצעות כפתורי החיצים (D-pad) ב-Android TV

לשלט הרחוק של Android TV יש לחצני ניווט ששולחים פקודות שמגיעות כאירועים מרכזיים אל 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, הניווט באמצעות כפתורי החיצים (D-pad) נתמך כברירת מחדל. לרכיבים Player ו-PlayerDefaults יש מופע אוטומטי של FocusRequester שמעביר את הרכיבים באמצעות כפתורי החיצים (D-pad), כך שלא צריך קוד נוסף או Modifier.focusRequester כדי לטפל באירועי מיקוד ומקשים:

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