홈 화면에서 콘텐츠 추천

Android TV 홈 화면에는 채널프로그램을 사용하여 추천 콘텐츠가 표시됩니다. 채널은 해당 채널에 사용 가능한 모든 프로그램을 표시하는 카드와 함께 홈 화면에 개별 행으로 표시됩니다.

앱에는 하나 이상의 채널이 있어야 하며 앱에서 만든 첫 번째 채널이 기본 채널이 되고 Android TV가 이 채널을 홈 화면에 자동으로 표시합니다. 앱에서 다른 채널을 제공할 수 있지만 홈 화면에 추가하기 전에 사용자가 이러한 채널을 선택하고 승인해야 합니다.

앱이 TV 프로그램, 영화 또는 기타 동영상 콘텐츠를 제공하는 경우 동영상 미리보기를 지원하고 다음 볼만한 동영상 채널과 통합하는 것이 좋습니다. 다음 동영상 보기 채널은 Android 시스템에서 제어합니다. 앱은 이 채널에 사용자가 재미있다고 표시했거나 중간에 시청을 중단했거나 시청 중인 콘텐츠와 관련된 프로그램 (예: 시리즈의 다음 에피소드 또는 프로그램의 다음 시즌)과 같은 사용자 관련 프로그램을 이 채널에 추가할 수 있습니다.

호환성 확보

홈 화면에는 Android 버전에 따라 두 가지 방법으로 추천이 표시됩니다.

  • Android 8.0 (API 수준 26) 이상에서는 앱이 별도의 행에 표시되는 하나 이상의 채널에 추천을 표시할 수 있습니다. 하나의 채널 (기본 채널)은 항상 표시됩니다. 사용자는 다른 채널을 검색하여 홈 화면에 추가할 수 있습니다. 홈 화면에 추천 채널을 만드는 방법을 알아보세요.
  • 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
}

Java

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 이하를 사용하여 컴파일된 경우 수준 26의 Android TV에서 계속 실행할 수 있습니다. 이전 추천 동작은 향후 버전과 호환되지만 제한적입니다.

  • 추천 행이 자동으로 변환되어 홈 화면에 새 채널로 표시됩니다.
  • 변환된 채널의 프로그램은 추천 서비스의 업데이트에 응답하지만 사용자는 TV의 UI를 사용하여 채널의 프로그램을 조작(프로그램 추가/삭제, 프로그램을 다음 볼만한 동영상 채널에 복사)할 수 없습니다.
  • 앱을 API 수준 26으로 업데이트해도 변환된 채널은 API 26을 실행하는 TV에 계속 표시됩니다. 앱이 새 API로 만든 채널을 처음 표시할 때 TV가 변환된 채널을 화면에서 삭제합니다. 이 작업은 앱이 기본 채널을 만드는 경우 즉시 발생하거나 나중에 사용자가 앱에서 만든 다른 채널을 선택하여 추가할 때 발생합니다.