Ta strona została przetłumaczona przez Cloud Translation API.

Korzystanie z Jetpack Compose na Androidzie TV

Funkcja Compose for TV to nowoczesne podejście do tworzenia aplikacji na Androida TV za pomocą interfejsu API. Tworzenie wiadomości na telewizory daje dostęp do wszystkich zalet Jetpack Compose na Androida aplikacji na telewizory, dzięki czemu możesz tworzyć atrakcyjne i funkcjonalne interfejsy aplikacji. .

Oto niektóre zalety korzystania z funkcji Utwórz na telewizorze:

Elastyczność: za pomocą funkcji tworzenia wiadomości możesz tworzyć dowolny interfejs użytkownika, od układy graficzne po złożone animacje. Komponenty działają od razu, ale mogą też można ją spersonalizować i dostosować do potrzeb aplikacji.
Uproszczone Przyspieszone tworzenie aplikacji: funkcja Compose jest zgodna z z istniejącego kodu i umożliwia programistom bardziej wydajne tworzenie aplikacji czyli prostsza metoda.
Intuicyjna: funkcja tworzenia wiadomości używa składni deklaratywnej, która pozwala na wprowadzanie zmian w interfejsie, debugowanie, analizowanie i sprawdzanie kodu.

Jeśli nie wiesz, jak korzystać z zestawu narzędzi Jetpack Compose, zapoznaj się z Ścieżka tworzenia. Wiele zasad tworzenia aplikacji na komórki mają zastosowanie również w przypadku telewizji. Sprawdź, dlaczego warto to zrobić. Utwórz, by dowiedzieć się więcej Informacje na temat ogólnych zalet deklaratywnej platformy interfejsu. Aby się uczyć Więcej informacji znajdziesz w sekcji Tworzenie wiadomości Repozytorium przykładowych telewizji na GitHubie.

Zgodność

Funkcja tworzenia wiadomości na telewizorze działa na telewizorach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym. Korzystanie z 1.0 usługi Compose for TV wymaga wersji 1.3.0 biblioteki androidx.compose, oraz Kotlin 1.7.10.

Konfiguracja

Korzystanie z Jetpack Compose na Androidzie TV przypomina korzystanie z Jetpack Compose na do innego projektu na Androida. Główna różnica polega na tym, że funkcja Utwórz na telewizorze dodaje biblioteki, które zawierają komponenty zoptymalizowane pod kątem telewizji i ułatwiają tworzenie dostosowane do interfejsów TV. W niektórych przypadkach te komponenty są wspólne na ich nazwy, np. androidx.tv.material3.Button oraz androidx.compose.material3.Button

Zależności zestawu narzędzi Jetpack Compose

Aby korzystać z Compose for TV, dołącz pakiet narzędzi Jetpack Compose w pliku build.gradle aplikacji w ten sposób:

Kotlin

dependencies {
   val composeBom = platform("androidx.compose:compose-bom:2024.06.00")
   implementation(composeBom)

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.9.0")

   implementation("androidx.compose.ui:ui-tooling-preview")
   debugImplementation("androidx.compose.ui:ui-tooling")

   // Compose for TV dependencies.
   implementation("androidx.tv:tv-material:1.0.0-rc01")
}

Odlotowe

dependencies {
   def composeBom = platform('androidx.compose:compose-bom:2024.06.00')
   implementation composeBom

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.9.0'

   implementation 'androidx.compose.ui:ui-tooling-preview'
   debugImplementation 'androidx.compose.ui:ui-tooling'

   // Compose for TV dependencies.
   implementation 'androidx.tv:tv-material:1.0.0-rc01'
}

Co się zmieniło

Materiał, z którego korzysta telewizor, jest zaprojektowany z myślą o salonie wskaźniki i funkcje obsługiwane z użyciem pilota. Szczegółowe informacje Aby dowiedzieć się, jak wykorzystać te konkretne komponenty, przeczytaj przewodniki po projektowaniu UI TV.

**Rysunek 1.** Przykładowe komponenty z biblioteki materiałów telewizyjnych

Tam, gdzie to możliwe, używaj wersji TV interfejsów API, aby korzystać z tych funkcji.

Choć jest technicznie możliwe korzystanie z mobilnej wersji Compose Material, nie jest zoptymalizowana pod kątem unikalnego stylu interakcji na Androidzie TV. W przez połączenie Material Material Design z materiałem Compose Material Tworzenie wiadomości na telewizorze może powodować nieoczekiwane działanie. Przykład: bo każda biblioteka ma własny obiekt MaterialTheme, istnieje możliwość, niespójne kolory, typografia lub kształty w przypadku obu wersji.

W tabeli poniżej podano różnice między telewizorami a Urządzenia mobilne:

Zależności telewizora (androidx.tv.*)	Porównanie	Zależność od urządzeń mobilnych (androidx.compose.*)
androidx.tv:tv-material,	*zamiast*	androidx.compose.material3:materiał3

Dodatkowe materiały

Przewodniki po projektowaniu telewizorów
Omówienie dedykowanych komponentów telewizora do tworzenia interfejsów użytkownika linki do odpowiednich materiałów dla programistów.
Próbka z katalogu materiałów telewizyjnych
Aplikacja z katalogiem, która pokazuje, jak wdrożyć Zasady Material Design w usłudze Compose na telewizorze
Przykład z JetStream
Aplikacja do strumieniowego odtwarzania multimediów, która przedstawia korzystanie z funkcji TV Compose za pomocą typowej aplikacji Material Design i realistycznej architektury.
Wprowadzenie do funkcji tworzenia wiadomości na telewizory
To ćwiczenie w Codelabs pokazuje, jak stworzyć aplikację odtwarzacza wideo w przeglądarce katalogu ekranu i szczegółów.

Więcej materiałów

Zapoznaj się z tymi przewodnikami, aby dowiedzieć się, jak tworzyć doskonałe reklamy z myślą o telewizji dla:

Dalej

Tworzenie przeglądarki katalogu