إنشاء تطبيق تلفزيون وتشغيله

تستخدم تطبيقات التلفزيون البنية نفسها التي تستخدمها تطبيقات الهواتف والأجهزة اللوحية. يعني هذا التشابه أنه يمكنك تعديل تطبيقاتك الحالية لتشغيلها أيضًا على أجهزة التلفزيون أو إنشاء تطبيقات جديدة بناءً على ما سبق عن إنشاء التطبيقات لنظام Android.

ملاحظة مُهمّة: يجب أن يستوفي تطبيقك متطلبات محدّدة ليكون تطبيق Android TV على Google Play. لمزيد من المعلومات، يُرجى الاطّلاع على المتطلبات المذكورة. في جودة تطبيقات البث التلفزيوني.

يصف هذا الدليل كيفية تجهيز بيئة التطوير لإنشاء تطبيقات التلفزيون الحد الأدنى من التغييرات المطلوبة لتفعيل تشغيل تطبيق على أجهزة التلفزيون.

للحصول على معلومات حول تصميم تطبيقات للتلفزيون، راجع تصميم التلفزيون يمكنك الاطّلاع أيضًا على نماذج التطبيقات في مستودع GitHub لـ Android TV.

تحديد توافق تنسيق الوسائط

راجع الوثائق التالية للحصول على معلومات حول برامج الترميز والبروتوكولات والتنسيقات متوافق مع Android TV:

• تنسيقات الوسائط المتوافقة
• إدارة الحقوق الرقمية
• android.drm
• ExoPlayer
• android.media.MediaPlayer

إعداد مشروع تلفزيوني

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

هناك مكوّنان أساسيان يتم استخدامهما عند إنشاء تطبيق يعمل على أجهزة التلفزيون:

• النشاط على التلفزيون: في بيان التطبيق، الإعلان عن نشاط يهدف إلى تشغيله على أجهزة التلفزيون.
• مكتبات التلفزيون: يمكنك اختياريًا تضمين واحد أو أكثر من مكتبات androidx لأجهزة التلفزيون المدرجة في قسم آخر من هذا الدليل. توفر هذه المكتبات أدوات لإنشاء واجهات المستخدم.

المتطلّبات الأساسية

قبل البدء في إنشاء تطبيق للتلفزيون، يجب اتخاذ الخطوات التالية:

• تحديث أدوات حزمة تطوير البرامج (SDK) إلى الإصدار 24.0.0 أو إصدار أحدث
  تتيح لك أدوات حزمة تطوير البرامج (SDK) المحدَّثة إنشاء تطبيقات للتلفزيون واختبارها.
• تحديث حزمة تطوير البرامج (SDK) لاستخدام الإصدار Android 5.0 (API 21) أو الإصدارات الأحدث
  يوفّر إصدار النظام الأساسي المحدَّث واجهات برمجة تطبيقات جديدة لتطبيقات التلفزيون.
• أنشِئ مشروع تطبيقك أو عدِّله.
  للوصول إلى واجهات برمجة تطبيقات جديدة لأجهزة التلفزيون، يمكنك إنشاء مشروع أو تعديل مشروع حالي. مشروعك يستهدف الإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.

الإفصاح عن نشاط تلفزيوني

يجب أن يعلن التطبيق المعدّ للتشغيل على أجهزة التلفزيون عن نشاط مشغّل التطبيقات للتلفزيون في بيانه. يستخدم هدف CATEGORY_LEANBACK_LAUNCHER التصفية للقيام بذلك. يحدد هذا الفلتر تطبيقك على أنه مفعَّل للتلفزيون ويتيح يحدّده Google Play على أنّه تطبيق تلفزيون. عندما يختار أحد المستخدمين تطبيقك على شاشة التلفزيون الرئيسية، هذا الغرض يحدد النشاط الذي سيتم إطلاقه.

يعرض مقتطف الرمز التالي كيفية تضمين فلتر الأهداف هذا في البيان:

<application
  android:banner="@drawable/banner" >
  ...
  <activity
    android:name="com.example.android.MainActivity"
    android:label="@string/app_name" >

    <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
  </activity>

  <activity
    android:name="com.example.android.TvActivity"
    android:label="@string/app_name"
    android:theme="@style/Theme.Leanback">

    <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
    </intent-filter>

  </activity>
</application>

ويحدد الإدخال الثاني في بيان النشاط في هذا المثال أن النشاط على جهاز تلفزيون.

تنبيه: إذا لم يتم تضمين الإدخال فلتر أهداف واحد (CATEGORY_LEANBACK_LAUNCHER) في لن يظهر تطبيقك لمستخدمي Google Play على أجهزة التلفزيون. أيضًا، إذا كان فلا يحتوي التطبيق على هذا الفلتر عند استخدام أدوات المطوّرين لتحميله على جهاز تلفزيون، فإن التطبيق لا يظهر في واجهة مستخدم التلفزيون.

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

إعلان توافق جهاز التلفزيون

يمكنك توضيح أنّ تطبيقك مخصَّص لنظام Android TV من خلال توضيح ميزة "android.software.leanback"

إذا كان تطبيقك يعمل على كلّ من الأجهزة الجوّالة والتلفزيون، اضبط قيمة السمة required على false إذا ضبطت قيمة سمة required على true، لن يتيح Google Play تطبيقك إلا على نظام التشغيل Android TV.

<manifest>
    <uses-feature android:name="android.software.leanback"
        android:required="false" />
    ...
</manifest>

يُرجى توضيح أنّ الشاشة التي تعمل باللمس غير مطلوبة

ولا تعتمد التطبيقات المصمّمة للتشغيل على أجهزة التلفزيون على الشاشات التي تعمل باللمس في الإدخال. للتوضيح، يجب أن يذكر بيان تطبيق التلفزيون أنّ ميزة android.hardware.touchscreen غير مطلوبة. يحدِّد هذا الإعداد أنّ تطبيقك أن يعمل على جهاز تلفزيون، وهو مطلوب حتى يُعتبر تطبيقك تطبيق تلفزيون في Google اللعب. يوضّح مثال الرمز التالي كيفية تضمين تعريف البيان هذا:

<manifest>
    <uses-feature android:name="android.hardware.touchscreen"
              android:required="false" />
    ...
</manifest>

تنبيه: في بيان التطبيق، عليك توضيح أنّ الشاشة التي تعمل باللمس غير مطلوبة، كما هو موضح في مثال التعليمة البرمجية هذا. وفي حال عدم ظهوره، لن يظهر تطبيقك في "Google Play على التلفزيون". الأجهزة.

توفير رمز للشاشة الرئيسية وبانر

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

لإضافة هذه العناصر إلى تطبيقك، يُرجى وصف الرمز والبانر في البيان على النحو التالي:

<application
    ...
    android:icon="@mipmap/ic_launcher"
    android:banner="@drawable/banner" >
    ...
</application>

رمز الشاشة الرئيسية

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

بانر الشاشة الرئيسية

استخدام android:banner التي تتضمّن <application> أو لتقديم بانر افتراضي لجميع أنشطة التطبيق، أو مع <activity> لتقديم بانر لنشاط معين.

بالنسبة إلى إعلان البانر، استخدِم مورد xhdpi بحجم 320 × 180 بكسل. يجب تضمين النص في . إذا كان تطبيقك متاحًا بأكثر من لغة، عليك توفير إصدارات منفصلة من بانر يحتوي على نص لكل لغة متاحة

تغيير لون مشغّل التطبيقات

تنبيه: في Android 12 والإصدارات الأحدث، يتم إنشاء صور متحركة مخصّصة لشاشة البداية باستخدام لا يمكن استخدام واجهة برمجة تطبيقات نظام SplashScreen الأساسي لتطبيقات Android TV.

عند تشغيل تطبيق تلفزيون، يعرض النظام صورة متحركة تشبه لقطة موسّعة معبأة دَائِرَة. لتخصيص لون هذه الصورة المتحركة، عليك ضبط android:colorPrimary. الخاص بتطبيق التلفزيون أو نشاطك على التلفزيون إلى لون معيّن. أيضًا، قم بتعيين اثنين نقل سمات متداخلة إلى true كما هو موضح في المقتطف التالي من ملف XML لمورد المظهر:

<resources>
    <style ... >
      <item name="android:colorPrimary">@color/primary</item>
      <item name="android:windowAllowReturnTransitionOverlap">true</item>
      <item name="android:windowAllowEnterTransitionOverlap">true</item>
    </style>
</resources>

لمزيد من المعلومات حول التعامل مع المظاهر والأنماط، راجع الأنماط والمظاهر:

إنشاء تطبيق متوافق مع نظام التشغيل Android TV

يشتمل Jetpack على مكتبات حزم androidx لاستخدامها مع تطبيقات التلفزيون.

إنشاء رسالة للتلفزيون

إنّ ميزة "إنشاء" هي الطريقة التي يُنصح بها لإنشاء التطبيقات المتوافقة مع نظام التشغيل Android TV. إلى جانب عنصر Compose الأساسي مكتبات Compose for TV، توفر مكونات مخصصة مصممة خصيصًا الشاشة الكبيرة:

• androidx.tv.foundation
• androidx.tv.material

تعرَّف على كيفية إنشاء تطبيق تلفزيون باستخدام ميزة "إنشاء على التلفزيون" من خلال استخدام Jetpack Compose على Android TV.

مجموعة أدوات واجهة مستخدم Leanback

توفر مجموعة أدوات واجهة مستخدم Leanback واجهات برمجة التطبيقات والتطبيقات المصغّرة لواجهة المستخدم لأجهزة التلفزيون:

• androidx.leanback.app
• androidx.leanback.database
• androidx.leanback.graphics
• androidx.leanback.media
• androidx.leanback.preference
• androidx.leanback.system
• androidx.leanback.widget
• androidx.leanback.widget.picker

اكتشاف كيفية إنشاء تطبيق تلفزيون باستخدام مجموعة أدوات واجهة مستخدم Leanback في إنشاء تطبيقات تشغيل على التلفزيون

تشغيل تطبيقات التلفزيون

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

الركض على جهاز فعلي

يمكنك إعداد جهاز التلفزيون على النحو التالي:

1. استخدِم كابل USB لتوصيل جهاز التلفزيون بجهاز التطوير. إذا لزم الأمر، يمكنك الرجوع إلى المستندات التي تقدّمها الشركة المصنّعة للجهاز.
2. انتقِل إلى الإعدادات على جهاز التلفزيون.
3. في صف الجهاز، اختَر لمحة.
4. انتقِل إلى إنشاء واختَر إنشاء عدة مرات إلى أن تصلك الرسالة. "لقد أصبحت الآن مطور برامج".
5. ارجع إلى الإعدادات. في صف الإعدادات المفضّلة، اختَر خيارات المطوّرين.
6. حدد تصحيح الأخطاء > تصحيح أخطاء USB واختيار تفعيل.
7. انتقِل مجددًا إلى شاشة التلفزيون الرئيسية.

لاختبار التطبيق على جهاز التلفزيون:

1. في Android Studio، حدد مشروعك وانقر على تشغيل من شريط الأدوات.
2. في نافذة اختيار هدف النشر، اختَر جهاز التلفزيون وانقر على حسنًا.

التشغيل على جهاز افتراضي

مدير AVD في Android توفّر حزمة SDK تعريفات الأجهزة التي تتيح لك إنشاء أجهزة تلفزيون افتراضية لتشغيلها لاختبار تطبيقاتك.

لإنشاء جهاز تلفزيون افتراضي:

1. شغِّل "مدير AVD". لمزيد من المعلومات، يُرجى مراجعة إنشاء الأجهزة الافتراضية وإدارتها
2. في مربّع الحوار AVD Manager، انقر على علامة التبويب تعريفات الأجهزة.
3. اختَر أحد تعريفات جهاز Android TV وانقر على إنشاء متوسّط مدة المشاهدة.
4. حدِّد خيارات المحاكي وانقر على حسنًا لإنشاء متوسّط مدة المشاهدة.

   ملاحظة: للحصول على أفضل أداء لجهاز محاكي التلفزيون، يمكنك استخدام المحاكي x86. وفعِّل الخيار استخدام وحدة معالجة الرسومات للمضيف. ويمكنك أيضًا استخدام ميزة "تسريع الأجهزة الافتراضية" عندما المتوفرة. لمزيد من المعلومات حول تسريع الأجهزة للمحاكي، يمكنك الاطلاع على تهيئة تسريع الأجهزة محاكي Android

لاختبار تطبيقك على جهاز التلفزيون الافتراضي:

1. في Android Studio، حدد مشروعك وانقر على تشغيل من شريط الأدوات.
2. في نافذة اختيار هدف النشر، اختَر جهاز التلفزيون الافتراضي وانقر على حسنًا.

لمزيد من المعلومات عن استخدام أدوات المحاكاة، راجع ويمكنك تشغيل التطبيقات على محاكي Android. لمزيد من المعلومات حول نشر التطبيقات من "استوديو Android" إلى التطبيقات الافتراضية يُرجى الاطّلاع على تصحيح أخطاء تطبيقك.

تفعيل تطبيق التلفزيون ليعمل كتجربة فورية

تسهِّل التجارب الفورية على المستخدمين ذلك. لتجربة تطبيق البث التلفزيوني ويمكن أن يساعد في زيادة الاستخدام.

لإعداد تطبيق التلفزيون لتشغيله كتطبيق فوري على جهاز أو محاكي Android TV، يُرجى اتّباع الخطوات التالية: اتبع أولاً التعليمات إنشاء حِزمة تطبيق تم تفعيل ميزة التطبيقات الفورية فيها

والآن، في intent-filter الخاصة بتطبيق التلفزيون MainActivity، تأكد من أن كل من LAUNCHER يتم الإعلان عن LEANBACK_LAUNCHER في AndroidManifest.xml:

<activity
    android:name="com.example.android.MainActivity"
    android:label="@string/app_name" >

    <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
      <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
    </intent-filter>
  </activity>

تم إعداد تطبيق البث التلفزيوني الآن ليتم تشغيله كتجربة فورية.

تحضير تطبيقك التلفزيوني للنشر

يمكنك مراجعة قائمة التحقّق لتطبيقات التلفزيون للاطّلاع على الخطوات التالية. لإعداد تطبيقك التلفزيوني للنشر والتوزيع.