تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض الشاشة الرئيسية في 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، أو
أو لاحقًا عندما يختار المستخدم أي قناة أخرى أنشأها تطبيقك ويضيفها
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Recommend content on the home screen\n\nThe Android TV *home screen* displays recommended content using *channels* and\n*programs*. Channels are displayed as individual rows on the home screen, with\ncards that display all of the available programs for that channel.\n\nYour app should have at least one channel. The first channel your\napp creates becomes its [default channel](/training/tv/discovery/recommendations-channel#default-channel),\nand Android TV displays that channel automatically on the home screen. Your app\ncan offer other channels, but the user must select and approve those channels\nbefore they are added to the home screen.\n\nIf your app features TV shows, movies, or other video content, we recommend that\nyou support [video previews](/training/tv/discovery/preview-videos) and\nintegrate with the [Watch Next channel](/training/tv/discovery/recommendations-channel#watch-next).\nThe Watch Next channel is controlled by the Android system. Your app can add\nuser-related programs to this channel, such as programs that the user marked as\ninteresting, stopped watching in the middle, or that are related to the content\nthe user is watching (like the next episode in a series or next season of a\nshow).\n\nEnsure compatibility\n--------------------\n\nThe home screen displays recommendations two different ways depending on the\nversion of Android:\n\n- In Android 8.0 (API level 26) and later, apps can show recommendations in one or more channels that appear on separate rows. One channel (the default channel) always appears. The user can discover and add the other channels to their home screen. Learn how to create [recommendation channels](/training/tv/discovery/recommendations-channel) on the home screen.\n- Before Android 8.0, Android TV shows all recommendations in a single recommendations row that always appears on the screen. Learn how to create the [recommendation row](/training/tv/discovery/recommendations-row) on the home screen.\n\nTo be able to show recommendations on all versions of Android TV, your app\nshould implement both recommendation APIs. Test the current system API level and\nuse the appropriate API to build the recommendation row or channels. \n\n### Kotlin\n\n```kotlin\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\n### Java\n\n```java\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\nIf your app was compiled using API level 25 or earlier, it can still run on\nAndroid TV in level 26. The old recommendations behavior is forward-compatible,\nbut constrained:\n\n- The recommendations row is automatically converted and appears as a new channel on the home screen.\n- The programs on the converted channel respond to updates from your [recommendation service](/training/tv/discovery/recommendations-row#service), but the user cannot use the TV's UI to manipulate the programs on the channel (add/remove programs, copy programs to the Watch Next channel).\n- If you update the app to API level 26, the converted channel still appears on TVs running API 26. The TV removes the converted channel from the screen the first time your app displays a channel created with the new API. This happens immediately if the app creates a [default channel](/training/tv/discovery/recommendations-channel#the_default_channel), or later when the user selects and adds any other channel created by your app.\n\n| **Note:** This forward-compatible behavior is temporary, it will be removed sometime in the future. To ensure compatibility, the best practice is to implement both APIs, as described above."]]
