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

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

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

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

ضمان التوافق

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

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

لتتمكّن من عرض الاقتراحات على جميع إصدارات Android TV، يجب أن يتضمّن تطبيقك أن تنفّذ كلاً من واجهتَي برمجة التطبيقات (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
}

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

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