Ana ekranda içerik öner

Android TV ana ekranında, kanalları ve programları kullanarak önerilen içerikler gösterilir. Kanallar, ana ekranda söz konusu kanal için kullanılabilir tüm programların gösterildiği kartlarla ayrı ayrı satırlar olarak görüntülenir.

Uygulamanızda en az bir kanal olmalıdır. Uygulamanızın oluşturduğu ilk kanal varsayılan kanal olur ve Android TV bu kanalı otomatik olarak ana ekranda gösterir. Uygulamanız başka kanallar sunabilir, ancak ana ekrana eklenmeden önce kullanıcının bu kanalları seçip onaylaması gerekir.

Uygulamanızda TV programları, filmler veya başka video içerikleri bulunuyorsa video önizlemelerini desteklemenizi ve Sonrakini İzle kanalıyla entegrasyon yapmanızı öneririz. Sonrakini İzle kanalı, Android sistemi tarafından kontrol edilir. Uygulamanız bu kanala, kullanıcının ilgi çekici olarak işaretlediği, ortasında izlemeyi bıraktığı veya izlediği içerikle (bir dizinin bir sonraki bölümü veya bir dizinin sonraki sezonu gibi) ilgili programlar gibi kullanıcılarla ilgili programlar ekleyebilir.

Uyumluluğu sağlama

Ana ekran, Android sürümüne bağlı olarak önerileri iki farklı şekilde görüntüler:

  • Android 8.0 (API düzeyi 26) ve sonraki sürümlerde uygulamalar, önerileri ayrı satırlarda görünen bir veya daha fazla kanalda gösterebilir. Her zaman bir kanal (varsayılan kanal) gösterilir. Kullanıcı diğer kanalları keşfedip ana ekranına ekleyebilir. Ana ekranda öneri kanallarının nasıl oluşturulacağını öğrenin.
  • Android 8.0'dan önce Android TV, tüm önerileri her zaman ekranda görünen tek bir öneri satırında gösteriyordu. Ana ekranda öneri satırının nasıl oluşturulacağını öğrenin.

Android TV'nin tüm sürümlerinde öneri gösterebilmek için uygulamanızın her iki öneri API'sini de uygulaması gerekir. Mevcut sistem API düzeyini test edin ve öneri satırını veya kanallarını oluşturmak için uygun API'yi kullanın.

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
}

Uygulamanız API düzeyi 25 veya önceki sürümler kullanılarak derlenmişse Android 26. seviyedeki Android TV'de çalışmaya devam edebilir. Eski öneri davranışı ileriye dönük olarak uyumlu olsa da sınırlıdır:

  • Öneriler satırı otomatik olarak dönüştürülür ve ana ekranda yeni bir kanal olarak görünür.
  • Dönüştürülen kanaldaki programlar, öneri hizmetinizin güncellemelerine yanıt verir ancak kullanıcı kanaldaki programları değiştirmek için TV'nin kullanıcı arayüzünü kullanamaz (programları ekleme/kaldırma, programları Sonrakini İzle kanalına kopyalama).
  • Uygulamayı API düzeyi 26'ya güncellerseniz dönüştürülen kanal API 26 çalıştıran TV'lerde görünmeye devam eder. Uygulamanız yeni API ile oluşturulan bir kanalı ilk kez görüntülediğinde, TV dönüştürülmüş kanalı ekrandan kaldırır. Bu işlem, uygulama bir varsayılan kanal oluşturursa hemen veya daha sonra, kullanıcı uygulamanız tarafından oluşturulan başka bir kanalı seçip eklediğinde gerçekleşir.