Android TV 홈 화면에는 채널 및
프로그램에 관해 자세히 알아보세요. 채널은 홈 화면에 개별 행으로 표시되며,
해당 채널에서 제공하는 모든 프로그램이 표시된 카드를 볼 수 있습니다.
앱에는 하나 이상의 채널이 있어야 하며 첫 번째 채널은
앱에서 만든 기본 채널이 됩니다.
Android TV는 그 채널을 홈 화면에 자동으로 표시합니다. 내 앱
다른 채널을 제공할 수 있지만 사용자가 이러한 채널을 선택하고 승인해야 합니다.
홈 화면에 추가되기 전에 확인할 수 있습니다.
앱이 TV 프로그램, 영화 또는 기타 동영상 콘텐츠를 제공하는 경우
동영상 미리보기 및
다음 볼만한 동영상 채널과 통합할 수 있습니다.
다음 동영상 보기 채널은 Android 시스템에서 제어합니다. 앱에서
이 채널에 사용자 관련 프로그램(예: 사용자가 표시한 프로그램)
시청을 중단했거나
콘텐츠와 관련이 있는 콘텐츠를 말합니다
(예: 시리즈의 다음 에피소드 또는 콘텐츠의 다음 시즌)
표시됩니다.
호환성 확보
홈 화면에는
Android 버전:
Android 8.0 (API 수준 26) 이상에서 앱은
별도의 행에 표시되는 더 많은 채널을 볼 수 있습니다. 채널 1개 (기본 채널)
항상 표시됩니다. 사용자가 다른 채널을 찾아 홈에 추가할 수 있습니다.
화면 추천 채널을 만드는 방법 알아보기
을 클릭합니다.
Android 8.0 이전에는 Android TV에서 모든 추천을 단일
추천 행이 항상 화면에 표시됩니다.
홈의 추천 행
화면
앱에서 모든 버전의 Android TV에 추천 콘텐츠를 표시하려면
두 추천 API를 모두 구현해야 합니다 현재 시스템 API 수준을 테스트하고
적절한 API를 사용하여 하나 이상의 추천 행을 만듭니다.
Kotlin
if(android.os.Build.VERSION.SDK_INT>=Build.VERSION_CODES.O){// Use the home screen recommendation channels API}else{// Use the recommendations row API}
자바
if(android.os.Build.VERSION.SDK_INT>=Build.VERSION_CODES.O){// Use the home screen recommendation channels API}else{// Use the recommendations row API}
앱이 API 수준 25 이하를 사용하여 컴파일된 경우
Android TV 레벨 26 기존 추천 동작은 향후 버전과 호환되며
제한:
추천 행이 자동으로 변환되어 새 행으로 표시됩니다.
채널을 찾을 수 있습니다.
변환된 채널의 프로그램은
추천 서비스를
사용자가 TV의 UI를 사용하여 채널의 프로그램을 조작할 수는 없습니다.
(프로그램 추가/제거, 다음 볼만한 동영상 채널에 프로그램 복사)
앱을 API 수준 26으로 업데이트하면 전환된 채널은
API 26을 실행하는 TV에는 계속 표시됩니다. TV가 변환된 채널을
새 API로 만든 채널을 앱이 처음 표시할 때의 화면
이는 앱에서
기본 채널
또는 나중에 사용자가 앱에서 만든 다른 채널을 선택하고 추가할 때 생성됩니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Recommend content on the home screen\n\nThe Android TV *home screen* displays recommended content using *channels* and\n*programs*. Channels are displayed as individual rows on the home screen, with\ncards that display all of the available programs for that channel.\n\nYour app should have at least one channel. The first channel your\napp creates becomes its [default channel](/training/tv/discovery/recommendations-channel#default-channel),\nand Android TV displays that channel automatically on the home screen. Your app\ncan offer other channels, but the user must select and approve those channels\nbefore they are added to the home screen.\n\nIf your app features TV shows, movies, or other video content, we recommend that\nyou support [video previews](/training/tv/discovery/preview-videos) and\nintegrate with the [Watch Next channel](/training/tv/discovery/recommendations-channel#watch-next).\nThe Watch Next channel is controlled by the Android system. Your app can add\nuser-related programs to this channel, such as programs that the user marked as\ninteresting, stopped watching in the middle, or that are related to the content\nthe user is watching (like the next episode in a series or next season of a\nshow).\n\nEnsure compatibility\n--------------------\n\nThe home screen displays recommendations two different ways depending on the\nversion of Android:\n\n- In Android 8.0 (API level 26) and later, apps can show recommendations in one or more channels that appear on separate rows. One channel (the default channel) always appears. The user can discover and add the other channels to their home screen. Learn how to create [recommendation channels](/training/tv/discovery/recommendations-channel) on the home screen.\n- Before Android 8.0, Android TV shows all recommendations in a single recommendations row that always appears on the screen. Learn how to create the [recommendation row](/training/tv/discovery/recommendations-row) on the home screen.\n\nTo be able to show recommendations on all versions of Android TV, your app\nshould implement both recommendation APIs. Test the current system API level and\nuse the appropriate API to build the recommendation row or channels. \n\n### Kotlin\n\n```kotlin\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\n### Java\n\n```java\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\nIf your app was compiled using API level 25 or earlier, it can still run on\nAndroid TV in level 26. The old recommendations behavior is forward-compatible,\nbut constrained:\n\n- The recommendations row is automatically converted and appears as a new channel on the home screen.\n- The programs on the converted channel respond to updates from your [recommendation service](/training/tv/discovery/recommendations-row#service), but the user cannot use the TV's UI to manipulate the programs on the channel (add/remove programs, copy programs to the Watch Next channel).\n- If you update the app to API level 26, the converted channel still appears on TVs running API 26. The TV removes the converted channel from the screen the first time your app displays a channel created with the new API. This happens immediately if the app creates a [default channel](/training/tv/discovery/recommendations-channel#the_default_channel), or later when the user selects and adds any other channel created by your app.\n\n| **Note:** This forward-compatible behavior is temporary, it will be removed sometime in the future. To ensure compatibility, the best practice is to implement both APIs, as described above."]]