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

تعرض الشاشة الرئيسية لـ 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 من واجهة برمجة التطبيقات. يزيل التلفزيون القناة التي تم تحويلها من الشاشة في المرّة الأولى التي يعرض فيها التطبيق قناة تم إنشاؤها باستخدام واجهة برمجة التطبيقات الجديدة. ويحدث ذلك فورًا إذا أنشأ التطبيق قناة تلقائية، أو في وقت لاحق عندما يختار المستخدم أي قناة أخرى أنشأها تطبيقك ويضيفها.

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