تلفزيون

  
تزويد المطوّرين بوظائف Compose وMaterial Design من أجل كتابة تطبيقات للتلفزيون
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫11 مارس 2026 1.0.1 - 1.1.0-beta01 -

تحديد الاعتماديات

لإضافة تبعيات على tv-foundation وtv-material، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

Groovy

dependencies {
    implementation "androidx.tv:tv-foundation:1.0.0-beta01"
    implementation "androidx.tv:tv-material:1.1.0-beta01"
}

Kotlin

dependencies {
    implementation("androidx.tv:tv-foundation:1.0.0-beta01")
    implementation("androidx.tv:tv-material:1.1.0-beta01")
}

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

الملاحظات

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

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

لا تتوفّر ملاحظات إصدار لهذا العنصر.

Tv-Material Version 1.1

الإصدار 1.1.0-beta01

‫11 مارس 2026

تم طرح androidx.tv:tv-material:1.1.0-beta01. يتضمّن الإصدار 1.1.0-beta01 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5، b/344563182)

المساهمة الخارجية

  • تم إيقاف نوع الاسم المستعار androidx.compose.ui.graphics.NativePaint نهائيًا، استخدِم android.graphics.Paint مباشرةً بدلاً من ذلك (I6303c، b/477394763)
  • استبدال الإضافة Paint.asFrameworkPaint() بالإضافة Paint.nativePaint لتجنُّب عرض نوع النظام الأساسي في مجموعة المصادر commonMain من خلال typealias (I6303c، b/477394763)

الإصدار ‎1.1.0-alpha01

‫15 يناير 2025

تم طرح androidx.tv:tv-material:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تغيير FocusEnterExitScope.cancelFocus() إلى cancelFocusChange()(I89959)
  • تم استبدال FocusProperties.enter وFocusProperties.exit بـ onEnter وonExit على التوالي، وذلك باستخدام نطاق جهاز استقبال بدلاً من المَعلمة FocusDirection. (I6e667)

إصلاح الأخطاء

  • تم نقل CompositingStrategy.OffScreen من "السطح" إلى "النص" لإصلاح مشكلة اهتزاز النص أثناء تغيير حجمه. (I92b15f17)
  • إصلاح مشكلة إدارة التركيز في لوحة العرض الدوّارة (Ie508b721375)
  • يتم تنفيذ Surface (غير التفاعلي) بطريقة مبسطة مقارنةً بالعناصر التفاعلية. (I7ea545150)

Tv-Material Version 1.0

الإصدار 1.0.1

‫16 يوليو 2025

تم طرح androidx.tv:tv-material:1.0.1. يتضمّن الإصدار 1.0.1 هذه التعديلات.

إصلاح الأخطاء

  • تم تعديل ارتفاع NavigationDrawerItem ليتطابق مع المواصفات. (cf9a3ce)
  • تم نقل إعدادات استراتيجية التركيب من العنصر المركّب Surface إلى العنصر المركّب Text. يؤدي ذلك إلى إصلاح الخطأ الذي لم يكن يعرض فيه ExoPlayer على عناصر Surface القابلة للإنشاء في إصدارات Android الأقدم من واجهة برمجة التطبيقات. (9858ffb)

الإصدار 1.0.0

‫21 أغسطس 2024

تم طرح androidx.tv:tv-material:1.0.0. الإصدار 1.0.0 هو أول إصدار ثابت من androidx.tv:tv-material.

الإصدار ‎1.0.0-rc02

‫7 أغسطس 2024

تم طرح androidx.tv:tv-material:1.0.0-rc02. يتضمّن الإصدار 1.0.0-rc02 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة عدم ثبات الحركة في النص في Surface composable. (3163319)

الإصدار ‎1.0.0-rc01

‫10 يوليو 2024

تم طرح androidx.tv:tv-material:1.0.0-rc01. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

الإصدار ‎1.0.0-beta01

‫1 مايو 2024

تم طرح androidx.tv:tv-material:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • أصبح ColorScheme ووظائفه المساعدة ثابتًا الآن. (If34fa)
  • أصبحت LocalContentColor الآن إصدارًا ثابتًا (I60ee2)
  • أصبحت واجهة برمجة التطبيقات Typography مستقرة الآن (I088d6)
  • أصبحت واجهات برمجة التطبيقات الخاصة بالأشكال ثابتة الآن (I0f5f4)
  • أصبحت واجهة Border API ثابتة الآن (I69281)
  • أصبحت Glow API الآن إصدارًا ثابتًا (Iea5f1)
  • أصبح مكوّن الرمز ثابتًا الآن (I62c2d)
  • LocalTextStyles أصبحت واجهة برمجة التطبيقات مستقرة الآن (Iaded8)
  • MaterialTheme أصبحت واجهة برمجة التطبيقات ثابتة الآن (I2f541)
  • أصبح مكوّن النص ثابتًا الآن (Ib9e31)
  • أصبح المكوّن RadioButton ثابتًا الآن (Ia03c8)
  • أصبح مكوّن "مفتاح التحكّم" ثابتًا الآن (I6cea3)
  • أصبحت مكوّنات Checkbox ثابتة الآن (I7eafc)
  • أصبحت مكوّنات واجهة العرض ثابتة الآن (I58758 وI04aca)
  • تمت إعادة تسمية NonInteractiveSurfaceDefaults إلى SurfaceDefaults وNonInteractiveSurfaceColors إلى SurfaceColors (I0812e)
  • تستخدم "مساحة العرض القابلة للتحديد" الآن مصطلح "اختيار" بدلاً من "وضع علامة" لأنّ لكلّ منهما دلالة مختلفة (I5a206).
  • أصبح الإصداران NavigationDrawer وNavigationDrawerScope ثابتَين الآن (I249c1)
  • أصبح مكوّن NavigationDrawerItem ثابتًا الآن (Id6986)
  • أصبحت مكوّنات علامة التبويب وTabRow ثابتة الآن (I92d92)
  • أصبحت المكوّنات Button وOutlinedButton وIconButton وOutlinedIconButton وWideButton ثابتة الآن (Ib4de8)
  • أصبحت المكوّنات Card وClassicCard وCompactCard وWideClassicCard وStandardCardContainer وWideCardContainer ثابتة الآن (I34390)
  • تمت إعادة تسمية StandardCardLayout إلى StandardCardContainer وWideCardLayout إلى WideCardContainer (I08883)
  • تمت إزالة CardContainerDefaults.ImageCard وإعادة تسمية CardDefaults.ContainerGradient إلى CardDefaults.ScrimBrush (I6adfe). يمكنك استخدام Card بدلاً من CardContainerDefaults.ImageCard في حاويات البطاقات.
  • أصبح الإصداران ListItem وDenseListItem ثابتَين الآن (Idebd9)
  • أصبحت قنوات "ListItemDefaults.ListItemShape" و"ListItemDefaults.FocusedDisabledBorder" و"ListItemDefaults.SelectedContainerColorOpacity" خاصة الآن (I5d533)
  • تمت إعادة ترتيب مَعلمات ListItem وإعادة تسمية ListItemDefaults.ListItemElevation إلى ListItemDefaults.TonalElevation (Id6841). تم نقل المَعلمة headlineContent إلى أعلى العنصر القابل للإنشاء. في السابق، كان بإمكانك استخدام بناء جملة lambda اللاحقة في Kotlin لتمرير headlineContent. الآن، عليك استخدام بنية المَعلمات المسماة لتوفير headlineContent.
  • ‫LocalAbsoluteTonalElevation أصبح الآن داخليًا (Ibfc65)
  • تمت إزالة المكوّن ImmersiveList. يمكنك الاطّلاع على هذا المثال لمعرفة كيفية إنشائه بنفسك. (Id48da)
  • تم تعديل مكوّنات tv-material التي تعرض MutableInteractionSource في واجهة برمجة التطبيقات لتصبح تعرض الآن MutableInteractionSource قابلاً للقيم الفارغة، والقيمة التلقائية هي null. لا توجد تغييرات دلالية هنا: يعني تمرير قيمة فارغة أنّك لا تريد نقل MutableInteractionSource إلى الأعلى، وسيتم إنشاؤه داخل المكوّن إذا لزم الأمر. يسمح التغيير إلى قيمة فارغة لبعض المكوّنات بعدم تخصيص MutableInteractionSource مطلقًا، ويسمح لمكوّنات أخرى بإنشاء مثيل عند الحاجة فقط، ما يحسّن الأداء في جميع هذه المكوّنات. إذا كنت لا تستخدم MutableInteractionSource الذي تمرّره إلى هذه المكوّنات، ننصحك بتمرير قيمة فارغة بدلاً من ذلك. يُنصح أيضًا بإجراء تغييرات مماثلة في مكوّناتك. (I309b4، b/298048146)
  • أصبحت قيمة المَعلمة TextAlign لمكوّن "النص على التلفزيون" غير فارغة (Ib73b1، b/299490814)
  • تم تقديم قيمة خاصة "غير محدّد" للحقول TextAlign وTextDirection وHyphens وLineBreak في ParagraphTextStyle لاستبدالها (I4197e وb/299490814)

التغييرات في السلوك

  • تم تغيير القيمة التلقائية للمَعلمة shape للحدث غير التفاعلي Surface إلى RectangleShape (I1b859cb)
  • تمت إزالة بعض ميزات لوحة العرض الدوّارة لإطلاق الإصدار التجريبي بسبب أنّ واجهات برمجة التطبيقات الضرورية تجريبية (I0e755d4)
  • لم يعُد تغيير contentColor في Surface يؤدي إلى إنشاء صورة متحركة بين الحالات (I436e794f)

الإصدار 1.0.0

الإصدار ‎1.0.0-beta01

‫11 مارس 2026

تم طرح androidx.tv:tv-foundation:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5، b/344563182)

الإصدار ‎1.0.0-alpha12

‫15 يناير 2025

تم طرح androidx.tv:tv-foundation:1.0.0-alpha12. يتضمّن الإصدار ‎1.0.0-alpha12 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • إزالة التصاميم الكسولة من tv-foundation راجِع ملاحظات الإصدار 1.0.0-alpha11 لنقل البيانات من تنسيقات tv-foundation الكسولة. (I2fdd3، b/358913893)

الإصدار ‎1.0.0-alpha11

‫10 يوليو 2024

تم طرح androidx.tv:tv-foundation:1.0.0-alpha11. يتضمّن الإصدار ‎1.0.0-alpha11 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تم إيقاف Tv Lazy Layouts نهائيًا من مكتبة tv-foundation. راجِع هذه البطاقة لمعرفة كيفية نقل البيانات من تنسيقات العرض البطيء على التلفزيون. (I0855f، b/332674072)
  • أصبح PlatformImeOptions الآن فئة ملموسة بدلاً من واجهة. (If40a4)

الإصدار ‎1.0.0-alpha10

‫4 أكتوبر 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha10 وandroidx.tv:tv-material:1.0.0-alpha10. يتضمّن الإصدار 1.0.0-alpha10 هذه التعديلات.

الميزات الجديدة

  • تم تقديم NavigationDrawerItem لاستخدامه ضمن NavigationDrawer وModalNavigationDrawer. (I4b491)
  • إضافة ملف تعريف خط الأساس إلى مكتبة tv-foundation (2b57fd7)
  • إضافة ملف تعريف أساسي إلى مكتبة tv-material (1711ff5)

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تسمية "NavigationDrawerScope.doesTabRowHaveFocus" إلى "NavigationDrawerScope.hasFocus". (I8286b)
  • تمت إعادة تسمية "TabRowScope.isActivated" إلى "TabRowScope.hasFocus". (Ic4273)

إصلاح الأخطاء

  • إصلاح توافق "لوحة العرض الدوّارة" مع العناصر المجاورة التي تستخدم واجهات برمجة تطبيقات استعادة التركيز (7b2a7a4)
  • إيقاف مؤشر التوهّج لإصدارات API_LEVEL الأقل من 28 لأنّ نظام التشغيل لا يتيحها (6d3616f)
  • تم إصلاح عُطل ANR الناتج عن وضع العناصر بشكل غير صحيح في الحاويات الكسولة عند التمرير السريع في الاتجاه المعاكس. (642d65c)
  • تمت إزالة مساحة متروكة في الخلفية في "درج التنقّل" الخاص بالنافذة المشروطة. (69965b2)
  • إصلاح Scrim في "لوحة التنقّل" ليتم رسمه فوق محتوى الخلفية بدلاً من خلفه (d4bbefb)

الإصدار ‎1.0.0-alpha09

‫6 سبتمبر 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha09 وandroidx.tv:tv-material:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • إضافة واجهة ReusableComposition لإدارة دورة الحياة وإعادة استخدام الأغاني الفرعية (I812d1، b/252846775)
  • مزامنة نسخة tv-foundation مع compose-foundation (I737c3، b/287011882)
  • تمت إضافة تحميل زائد للدالة LazyLayout، وهي تقبل تعبير lambda من LazyLayoutItemProvider، وليس كائنًا عاديًا كما كان من قبل. تم إيقاف التحميل الزائد السابق نهائيًا. (I42a5a)
  • أضِف TvKeyboardAlignment للسماح للمطوّر بضبط موضع لوحة المفاتيح على الشاشة من خلال AndroidImeOptions. (Idb772)
  • أضِف rememberCarouselState لتذكُّر CarouselState باستخدام Saver إلى مكتبة TV Compose Material. (Id7275)
  • تغيير المَعلمة scrimColor: Color إلى المَعلمة scrimBrush:Brush للسماح للمستخدمين بإضافة تدرّجات إلى طبقة التعتيم (I254d4)

الإصدار ‎1.0.0-alpha08

‫26 يوليو 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha08 وandroidx.tv:tv-material:1.0.0-alpha08. يتضمّن الإصدار 1.0.0-alpha08 هذه التعديلات.

الميزات الجديدة

  • تقديم مكوّنات Chip لـ Compose for TV (I86da4)
  • إضافة مكوّن ListItem إلى مكتبة TV Compose Material (I3f0b3)
  • أضِف DenseListItemمكوّنًا إلى Material Design في TV Compose. (I536bf)

تغييرات واجهة برمجة التطبيقات

  • تم تصنيف واجهات برمجة التطبيقات العلنية الخاصة بمواد التلفزيون على أنّها تجريبية. (I632e7)
  • تمت إضافة TabRowScope لمشاركة الحالة من الدالة البرمجية القابلة للإنشاء TabRow مع الدالة البرمجية القابلة للإنشاء Tab، وتمت إعادة تسمية خصائص TabColors. (Ief587)

الإصدار ‎1.0.0-alpha07

‫7 يونيو 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha07 وandroidx.tv:tv-material:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تتضمّن مؤشرات مقياس المكونات الآن الخيار "بلا" لإيقاف تغيير الحجم. (I50df5)
  • تمت إضافة إمكانية النقر مع الاستمرار على "الواجهة المستندة إلى Material" والبطاقات والأزرار على التلفزيون. (Id2b89)
  • تمت إزالة CarouselItem وCarouselScope. يمكن تحقيق حركة المحتوى في المقدّمة في الشريحة باستخدام Modifier.animateEnterExit من AnimatedContentScope. (Ic038e)
  • تم دمج المَعلمتَين color وcontentColor في المَعلمة colors لمساحة عرض مواد التلفزيون. (Ie69eb)
  • تم تقديم العنصر القابل للإنشاء RadioButton في مكتبة TV Material. (I08690)
  • تم تقديم العنصر القابل للإنشاء Switch في مكتبة TV Material. (I45e29)
  • تم تقديم العنصر القابل للإنشاء Checkbox في مكتبة TV Material. (I6a45a)
  • تم تقديم Surface غير تفاعلي في TV Material. (Ic5f85)
  • إبقاء المؤشرات داخلية (Ibff82)

الإصدار ‎1.0.0-alpha06

‫19 أبريل 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha06 وandroidx.tv:tv-material:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

الميزات الجديدة

  • إضافة عمليات تنفيذ "بطاقة Material 3" المحسّنة للتلفزيون
    • البطاقة الأساسية (I5b701)
    • ‫ClassicCard وCompactCard وWideClassicCard (I70471)
    • ‫StandardCardLayout وWideCardLayout (I33fae)
  • إضافة عمليات تنفيذ زر Material 3 محسّنة للتلفزيون
    • زر أساسي (I69c11)
    • ‫IconButton وOutlinedIconButton (Ib504c)
    • WideButton (I4cecf)

تغييرات واجهة برمجة التطبيقات

  • تمت إعادة تسمية CarouselSlide وslideCount في Carousel إلى CarouselItem وitemCount. (Ie554c)
  • تمت إعادة تسمية forward وbackward ContentTransforms إلى StartToEnd وEndToStart. (Ie554c)

إصلاح الأخطاء

  • التعامل مع زر لوحة الاتجاهات الخلفي عندما يكون التركيز على NavigationDrawer (d654f4)

الإصدار ‎1.0.0-alpha05

‫22 مارس 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha05 وandroidx.tv:tv-material:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • نقدّم لك العنصر القابل للإنشاء Side Navigation Drawer في tv-material. لمعرفة كيفية استخدام هذا العنصر القابل للإنشاء، يُرجى الرجوع إلى الأمثلة. (I12c08)
  • إضافة دالة Icon قابلة للإنشاء في TV Material 3 (I72db9)
  • نقدّم لك Surface composable إلى tv-material مع مؤشرات مثل Border وGlow وScale، والتي يمكن استخدامها لإنشاء مكوّنات تسلّط الضوء بوضوح على العنصر الذي تم التركيز عليه على شاشة التلفزيون. (I4a6d8)، (Iceea1)، (Iee4d4)، (I79edf)، (Icb376)
  • تعديل CarouselItem إلى CarouselSlide لتتطابق مع اسم المَعلمة slideCount في واجهة برمجة التطبيقات "منصّة العرض الدوّارة" (Ic4299)

الإصدار ‎1.0.0-alpha04

‫8 شباط (فبراير) 2023

تم طرح androidx.tv:tv-foundation:1.0.0-alpha04 وandroidx.tv:tv-material:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

الميزات الجديدة

  • في الصفوف والأعمدة والجداول الكسولة، يتم تجاهل نقطة الارتكاز، إذا لزم الأمر، لضمان عرض العنصر بأكمله. (11d7e40)
  • إضافة خيار تخصيص ألوان علامات التبويب في حالات مختلفة (21b2925)
  • تقبل الآن لوحة العرض الدوّارة صورًا متحركة مخصّصة للتمرير اليدوي للأمام والخلف. (431494a)

تغييرات واجهة برمجة التطبيقات

  • إعادة تسمية androidx.tv.material إلى androidx.tv.material3 وتسوية بنية الحزمة ضِمن androidx.tv.material3 (I6ca52)
  • أصبح المؤشر ضمن صف "مؤشر اللوحة الدوّارة" الآن خانة يمكن للمطوّر تخصيصها. (268af2a)
  • تمت إعادة تسمية "focusableItem" إلى "immersiveListItem". على المستخدمين إضافة المعدِّل focusable() أو clickable() يدويًا مع immersiveListItem (5dd5078)(b/263061052)
  • تمت إعادة تسمية timeToDisplayMillis إلى autoScrollDurationMillis في مكوّن "الإعلان الدوّار". (431494a)
  • يقتصر استخدام "CarouselItem" الآن على Carousel. (431494a)
  • تقبل لوحة العرض الدوّارة الآن ContentTransforms كتعريف للرسوم المتحركة بدلاً من EnterTransition وExitTransitions. (431494a)
  • تم تقديم واجهة برمجة التطبيقات PinnableContainer التي يتم نشرها من خلال القوائم الكسولة عبر تركيبة محلية تتيح تثبيت العنصر الحالي. (Ib8881، b/259274257، b/195049010)
  • تمت إضافة السمة mainAxisItemSpacing إلى TvLazyListLayoutInfo وTvLazyGridLayoutInfo (I37765)

إصلاح الأخطاء

  • تعديل صف علامات التبويب لضمان التعامل مع عدد علامات التبويب 0 أو 1 بشكلٍ صحيح (I44009)، (1c01525)، (b/264018028)
  • إصلاح عُطل focus-search عندما يحتوي TvLazyColumn على TvLazyRow فارغ (e11b4fe)، (b/260299091)
  • يعمل المعدِّل clickable الآن مع ImmersiveList. (5dd5078)، (b/263061052)
  • تمّت معالجة مفتاح الرجوع ويُستخدَم الآن للخروج من "الإعلانات الدوّارة المقترَحة". (84c138c)
  • لا تفقد لوحة العرض الدوّارة التركيز عند الضغط على المفاتيح بسرعة عدة مرات. (799489f)
  • لا تفقد لوحة العرض والتدوير التركيز عند الضغط مع الاستمرار على المفاتيح. (b2cf37e)
  • تم إصلاح الأعطال التي تحدث عند تغيير عدد الشرائح في لوحة العرض الدوّارة. (b261247)

الإصدار ‎1.0.0-alpha03

‫7 كانون الأول (ديسمبر) 2022

تم طرح androidx.tv:tv-foundation:1.0.0-alpha03 وandroidx.tv:tv-material:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

الميزات الجديدة

  • تتوفّر TabRow الآن كواجهة برمجة تطبيقات تجريبية تتيح للمستخدمين إضافة أشرطة تنقّل علوية إلى تطبيقاتهم. بشكل عام، تتوقّع أجهزة التلفزيون تحميل علامات التبويب عند التركيز على عنوان علامة التبويب في صف علامات التبويب.
  • تتوفّر مؤشرات خاصة بالتلفزيون، مثل مؤشر التسطير ومؤشر الحبة، بدون الحاجة إلى أي إعدادات إضافية. يمكن العثور على أمثلة على الاستخدام في tv-samples

الإصدار ‎1.0.0-alpha02

‫9 نوفمبر 2022

تم طرح androidx.tv:tv-foundation:1.0.0-alpha02 وandroidx.tv:tv-material:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

إصلاح الأخطاء

  • تحسين أداء التمرير عند التمرير خلال مجموعة من TvLazyRows/TvLazyColumns من خلال تقليل مساحة البحث عن التركيز (I723a3)

الإصدار ‎1.0.0-alpha01

‫5 أكتوبر 2022

تم طرح androidx.tv:tv-foundation:1.0.0-alpha01 وandroidx.tv:tv-material:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

الميزات الجديدة

تحتوي الإصدارات الأولى من الإصدار الأوّلي على معاينات مبكرة لتنفيذ المكوّنات لحالات استخدام التلفزيون، بما في ذلك:

  • إضافة المعدِّل scrollableWithPivot للسماح للحاويات غير الكسولة التي يمكن التمرير فيها، مثل Row وColumn وGrid، بتمرير المحتوى حتى يظل العنصر الذي يتم التركيز عليه في الموضع نفسه على شاشة التلفزيون
  • إضافة عناصر قابلة للإنشاء TvLazyRow وTvLazyColumn وTvLazyHorizontalGrid وTvLazyVerticalGrid لجعل الحاوية القابلة للتمرير تمرّر المحتوى ليبقى العنصر الذي يتم التركيز عليه في الموضع نفسه على شاشة التلفزيون
  • إضافة أداة Featured Carousel القابلة للإنشاء للتلفزيون، ما يتيح للمستخدم إنشاء لوحة عرض دوّارة للبانر يتم تمريرها تلقائيًا
  • إضافة عنصر Immersive List القابل للإنشاء على التلفزيون والذي يتيح للمستخدم إنشاء صف أو عمود أو شبكة Immersive تتغيّر خلفيتها استنادًا إلى عنصر القائمة محل التركيز

المشاكل المعروفة

  • عندما يكتسب الحاوية القابلة للتمرير التركيز، لا يكتسب العنصر الأول التركيز تلقائيًا.
  • لا يؤدي التركيز على TextField دائمًا إلى فتح لوحة المفاتيح أو قد يمنع التركيز من الانتقال إلى حقول أخرى.
  • يكون أداء التمرير عموديًا في LazyColumn يحتوي على LazyRows ضعيفًا.