اقتراح المحتوى على الشاشة الرئيسية

تعرض الشاشة الرئيسية في Android TV محتوًى مقترَحًا باستخدام القنوات و البرامج. تظهر القنوات كصفوف فردية على الشاشة الرئيسية، مع بطاقات تعرض جميع البرامج المتاحة لتلك القناة.

يجب أن يتضمّن تطبيقك قناة واحدة على الأقل. تصبح القناة الأولى التي ينشئها تطبيق ك هي القناة التلقائية، ويعرضها Android TV تلقائيًا على الشاشة الرئيسية. يمكن أن يقدّم تطبيقك قنوات أخرى، ولكن يجب أن يختار المستخدم هذه القنوات ويوافق عليها قبل إضافتها إلى الشاشة الرئيسية.

إذا كان تطبيقك يعرض برامج تلفزيونية أو أفلامًا أو محتوًى فيديو آخر، ننصحك بأن تدعم معاينات الفيديو و تدمج مع قناة "المشاهدة لاحقًا". يتحكّم نظام Android في قناة "المشاهدة لاحقًا". يمكن لتطبيقك إضافة برامج ذات صلة بالمستخدم إلى هذه القناة، مثل البرامج التي وضع المستخدم علامة عليها بأنّها تثير اهتمامه أو التي توقّف عن مشاهدتها في منتصفها أو التي تتعلّق بالمحتوى الذي يشاهده (مثل الحلقة التالية في مسلسل أو الموسم التالي من برنامج).

ضمان التوافق

تعرض الشاشة الرئيسية الاقتراحات بطريقتَين مختلفتَين حسب إصدار Android:

  • في Android 8.0 (مستوى واجهة برمجة التطبيقات 26) والإصدارات الأحدث، يمكن للتطبيقات عرض الاقتراحات في قناة واحدة أو أكثر تظهر على صفوف منفصلة. تظهر قناة واحدة (القناة التلقائية) دائمًا. يمكن للمستخدم اكتشاف القنوات الأخرى وإضافتها إلى شاشته الرئيسية. تعرّف على كيفية إنشاء قنوات الاقتراحات على الشاشة الرئيسية
  • قبل Android 8.0، يعرض Android TV جميع الاقتراحات في صف اقتراحات واحد يظهر دائمًا على الشاشة. كيفية إنشاء صف الاقتراحات على الشاشة الرئيسية

لكي تتمكّن من عرض الاقتراحات على جميع إصدارات Android TV، يجب أن تنفّذ واجهتَي برمجة تطبيقات الاقتراحات. اختبِر مستوى واجهة برمجة التطبيقات الحالية للنظام واستخدِم واجهة برمجة التطبيقات المناسبة لإنشاء صف الاقتراحات أو القنوات.

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
}

إذا تم تجميع تطبيقك باستخدام المستوى 25 من واجهة برمجة التطبيقات أو مستوى سابق، سيظل بإمكانه التشغيل على Android TV في المستوى 26. يتوافق سلوك الاقتراحات القديم مع الإصدارات الأحدث، ولكنّه مقيّد:

  • يتم تلقائيًا تحويل صف الاقتراحات ويظهر كقناة جديدة على الشاشة الرئيسية.
  • تستجيب البرامج على القناة المحوَّلة للتعديلات من خدمة الاقتراحات ولكن لا يمكن للمستخدم استخدام واجهة مستخدم التلفزيون للتعامل مع البرامج على القناة (إضافة البرامج أو إزالتها أو نسخها إلى قناة "المشاهدة لاحقًا").
  • إذا حدّثت التطبيق إلى المستوى 26 من واجهة برمجة التطبيقات، ستظل القناة المحوَّلة تظهر على أجهزة التلفزيون التي تعمل بواجهة برمجة التطبيقات 26. يزيل التلفزيون القناة المحوَّلة من الشاشة في المرة الأولى التي يعرض فيها تطبيقك قناة تم إنشاؤها باستخدام واجهة برمجة التطبيقات الجديدة. يحدث ذلك على الفور إذا أنشأ التطبيق قناة تلقائية، أو لاحقًا عندما يختار المستخدم أي قناة أخرى أنشأها تطبيقك ويضيفها.