홈 화면에서 콘텐츠 추천

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
    }
    

자바

    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가 화면에서 변환된 채널을 삭제합니다. 이 작업은 앱이 기본 채널을 만들 때 바로 실행되거나 나중에 사용자가 앱에서 생성된 다른 채널을 선택하고 추가할 때 실행됩니다.