بدء استخدام تطبيقات التلفزيون

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• عليك تحديث أدوات حزمة تطوير البرامج (SDK) إلى الإصدار 24.0.0 أو إصدار أحدث.
  تتيح لك أدوات حزمة تطوير البرامج (SDK) المعدَّلة إنشاء تطبيقات واختبارها للتلفزيون.
• تحديث حزمة SDK بالإصدار Android 5.0 (API 21) أو إصدار أحدث
  يوفّر الإصدار المعدَّل من النظام الأساسي واجهات برمجة تطبيقات جديدة لتطبيقات البث التلفزيوني.
• إنشاء مشروع تطبيقك أو تعديله:
  للوصول إلى واجهات برمجة التطبيقات الجديدة لأجهزة التلفزيون، يجب إنشاء مشروع أو تعديل مشروع حالي يستهدف الإصدار Android 5.0 (المستوى 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 Play. يوضّح مثال الرمز البرمجي التالي كيفية تضمين بيان البيان هذا:

<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 بكسل. يجب أن يكون النصّ ضمن الصورة إذا كان تطبيقك متاحًا بأكثر من لغة واحدة، يجب توفير نُسخ منفصلة من إعلان البانر مع تضمين نص لكل لغة متاحة.

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

تنبيه: في الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث، لا تتوفّر الصور المتحركة المخصّصة لشاشة البداية والتي تم إنشاؤها باستخدام واجهة برمجة التطبيقات للنظام الأساسي 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 الأساسية، توفّر مكتبات ComposeAllowed المخصّصة للبرامج التلفزيونية مكوّنات مخصّصة تم تصميمها خصيصًا للشاشة الكبيرة:

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

تعرَّف على كيفية إنشاء تطبيق تلفزيون باستخدام أداة ComposeAllowed للتلفزيون في مقالة استخدام 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"، اختَر مشروعك وانقر على تشغيل من شريط الأدوات.
2. في نافذة اختيار هدف النشر، اختَر جهاز التلفزيون وانقر على حسنًا.

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

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

لإنشاء جهاز تلفزيون افتراضي، يُرجى اتّباع الخطوات التالية:

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

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

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

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

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

تفعيل تطبيق التلفزيون ليعمل في الوقت الفعلي

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

لإعداد تطبيق YouTube TV لتشغيله كتطبيق فوري على جهاز 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>

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

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

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