تلفزيون

  
تزود المطورين بوظيفتي "الكتابة" و"التصميم المتعدد الأبعاد" من أجل كتابة التطبيقات للتلفزيون
آخر تعديل الإصدار المستقر إصدار مرشح الإصدار التجريبي الإصدار الأولي
4 تشرين الأول (أكتوبر) 2023 - - - 1.0.0-alpha10

تعريف التبعيات

لإضافة تبعيات على أساس التلفزيون ومواد التلفزيون، يجب إضافة مستودع Google Maven إلى مشروعك. يمكنك الاطّلاع على مستودع Maven الذي يضم أدوات Google للحصول على مزيد من المعلومات.

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

رائع

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

Kotlin

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

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

ملاحظات

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

إنشاء عدد جديد

راجع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.

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

الإصدار 1.0.0

الإصدار 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)
  • إضافة الملف الشخصي الأساسي إلى مكتبة المؤسسات التلفزيونية. (2b57fd7)
  • أضِف ملفًا شخصيًا مرجعيًا إلى مكتبة مواد التلفزيون. (1711ff5)

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

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

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

  • إصلاح توافق لوحة العرض الدوّارة مع العناصر المجاورة التي تستخدم واجهات برمجة التطبيقات لأداة استعادة التركيز (7b2a7a4)
  • يمكن إيقاف مؤشر التوهج لـ API_LEVEL الأقل من 28 لأنّه غير متوافق مع نظام التشغيل. (6d3616f)
  • يجب إصلاح تعطُّل أخطاء ANR الذي نتج عن موضع العناصر غير الصحيح في الحاويات الكسولة عند الانتقال السريع في الاتجاه العكسي. (642d65c)
  • تمت إزالة المساحة المتروكة في الخلفية في درج التنقل المشروط. (69965b2)
  • إصلاح الحاجب في درج التنقل ليتم رسمه فوق محتوى الخلفية بدلاً من خلفه. (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)
  • مزامنة أداة تأسيس تلفاز مع أساس الإنشاء. (I737c3، b/287011882)
  • تمت إضافة الحمل الزائد LazyLayout، وهو يقبل دالة lambda التي تساوي LazyLayoutItemProvider، وليس كائنًا عاديًا كما كان من قبل. يتم إيقاف التحميل الزائد السابق نهائيًا. (I42a5a)
  • يمكنك إضافة "TvKeyboardAlignment" للسماح للمطوّر بضبط موضع لوحة المفاتيح على الشاشة من خلال "AndroidImeOptions". (Idb772)
  • أضِف rememberCarouselState لتذكُّر CarouselState مع Saver إلى مادة الإنشاء التلفزيوني. (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 على هذه الالتزامات.

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

  • إدخال مكوّنات "الشريحة" في مواد ميزة "الكتابة على التلفزيون" (I86da4)
  • يمكنك إضافة المكوِّن ListItem إلى مادة الإنشاء التلفزيوني. (I3f0b3)
  • أضِف مكوِّنًا DenseListItemإلى مادة "الكتابة التلفزيونية". (I536bf)

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

  • تم وضع علامة على واجهات برمجة التطبيقات العامة لمواد التلفزيون على أنّها تجريبية. (I632e7)
  • تم طرح ميزة "TabRowScope" لمشاركة الحالة من "TabRow" القابل للإنشاء مع خصائص 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)
  • تمت إضافة إمكانية النقر المطوّل للإعلان على سطح مواد التلفزيون والبطاقات والأزرار. (Id2b89)
  • تمت إزالة CarouselItem وCarouselScope. يمكن إنشاء صور متحركة للمحتوى الذي يظهر في المقدمة في الشريحة باستخدام Modifier.animateEnterExit من AnimatedContentScope. (Ic038e)
  • تم دمج المَعلمتَين color وcontentColor كمَعلمة colors لسطح المادة التلفزيونية. (Ie69eb)
  • تم تقديم RadioButton في مادة التلفزيون. (I08690)
  • تم تقديم Switch في مادة التلفزيون. (I45e29)
  • تم تقديم Checkbox في مادة التلفزيون. (I6a45a)
  • تم تقديم سطح غير قابل للتفاعل في مادة التلفزيون. (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 المحسَّنة للتلفزيون.
    • Basic Card (I5b701)
    • ClassicCard وCompactCard وWideClassicCard (I70471)
    • StandardCardLayout وWideCardLayout (I33fae)
  • إضافة عمليات تنفيذ أزرار Material 3 محسَّنة للتلفزيون

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

  • تمت إعادة تسمية 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 على هذه الالتزامات.

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

  • نقدّم لك درج التنقّل الجانبي في tv-material. لمعرفة كيفية استخدام هذا العنصر، يُرجى الاطّلاع على النماذج. (I12c08)
  • تقديم رمز قابل للإنشاء في المادة 3 للتلفزيون (I72db9)
  • نقدّم لك ميزة "سطح المكتب" التي يمكن تركيبها على tv-material مع مؤشرات مثل "الحدود" و"اللمعان" و"المقياس" التي يمكن استخدامها لإنشاء مكوّنات تُبرز بوضوح العنصر الذي يتم التركيز عليه على شاشة التلفزيون. (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)
  • يجب إصلاح تعطُّل ميزة "البحث عن التركيز" عندما يحتوي الحقل "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" الآن كواجهة برمجة تطبيقات تجريبية تسمح للمستخدمين بإضافة أشرطة التنقّل العلوية إلى تطبيقاتهم. بشكل عام، من المتوقّع أن يتم تحميل علامات التبويب على أجهزة التلفزيون عند التركيز على عنوان علامة التبويب في صف علامات التبويب.
  • يتم عرض مؤشرات خاصة بالتلفزيون مثل مؤشر التسطير ومؤشر حبوب اللقاح بشكل غير تقليدي. يمكن العثور على نماذج الاستخدامات في نماذج التلفزيون.

الإصدار 1.0.0-alpha02

تشرين الثاني (نوفمبر) 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 للسماح لحاويات التمرير غير الكسول، مثل الصفوف والعمود والشبكة، بأن يتم تمرير حاوية التمرير في المحتوى كي تظل العناصر التي يتم التركيز عليها في الموضع نفسه على شاشة التلفزيون.
  • إضافة العناصر TvLazyRow وTvLazyColumn وTvLazyHorizontalGrid وTvLazyVerticalGrid لإتاحة إمكانية تمرير حاوية التمرير في المحتوى، لكي يظل العنصر الذي يتم التركيز عليه في الموضع نفسه على شاشة التلفزيون.
  • إضافة لوحة عرض دوّارة مميزة يمكن إنشاؤها للتلفزيون، وتتيح للمستخدم إنشاء لوحة عرض دوّارة يتم عرضها بشكل تلقائي
  • إضافة قائمة جذابة يمكن إنشاؤها للتلفزيون، وتتيح للمستخدم إنشاء صف/عمود/شبكة مجسّمة تغيّر الخلفية بناءً على عنصر القائمة الذي يتم التركيز عليه.

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

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