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

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

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

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

التأكّد من التوافق

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

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

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

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // Use the home screen recommendation channels API.
} else {
    // Use the recommendations row API.
}
Recommendations.kt

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

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

ملاحظة: هذا السلوك المتوافق مع الإصدارات المستقبلية مؤقت، وستتم إزالته في وقت ما في المستقبل. لضمان التوافق، من الأفضل تنفيذ كلتا واجهتَي برمجة التطبيقات، كما هو موضّح في هذا القسم.