Android TV مع Google Cast

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

إعداد الجهاز لمرحلة التطوير

1. اضبط إعدادات جهاز Android TV:
   1. وصِّل جهاز Android TV بالشبكة المحلية.
   2. سجِّل الدخول إلى حسابك على Google.
2. من الإعدادات، في صف الجهاز، اختَر لمحة.
3. الانتقال للأسفل والنقر على إنشاء عدة مرات إلى أن يظهر مربّع حوار يحمل الرسالة "أنت الآن مطوّر برامج"
4. إذا كان الخيار "تصحيح أخطاء الجهاز عبر USB":
   1. ثبّت كابل USB، ولكن لا توصل الطرف الرئيسي لكابل USB بجهاز الكمبيوتر حتى الآن.
   2. في صف الإعدادات المفضّلة، اختَر خيارات المطوّرين واختَر تصحيح أخطاء USB ثم تفعيل.
5. انتقل مرة أخرى إلى الشاشة الرئيسية. يجب عليك القيام بذلك لتطبيق الإعدادات التي حددتها للتو. سيستمر تفعيل الإعدادات ما لم تتم إعادة ضبط الجهاز على الإعدادات الأصلية.
6. سجِّل جهاز Android TV على Google Cast SDK Developer Console، كما هو موضّح في تسجيل الأجهزة.

تصحيح الأخطاء

لاختبار تطبيق Web Getr وتصحيح الأخطاء فيه على جهاز Android TV، عليك اتّباع الخطوات التالية:

1. سجِّل جهاز Android TV وتطبيقك على وحدة تحكّم المطوّرين لـ Google Cast SDK. راجع التسجيل للحصول على مزيد من المعلومات حول تسجيل الأجهزة والتطبيقات.
2. شغِّل تطبيق المرسِل وبثّه على جهاز Android TV.
3. اتصِل بجهاز Android TV من خلال ADB، على النحو الموضّح في مقالة استخدام Android Debug Bridge.
4. على جهاز التطوير الذي تستخدمه، افتح نافذة متصفِّح Chrome وانتقِل إلى chrome://inspect.
5. انقر على رابط inspect لجلب "جهاز استقبال الويب" إلى برنامج تصحيح الأخطاء.

6. في وحدة تحكم برنامج تصحيح الأخطاء عن بُعد في Chrome، مكِّن تسجيل تصحيح الأخطاء عن طريق إدخال ما يلي:

   cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
   

راجِع تصحيح الأخطاء للاطّلاع على مزيد من المعلومات.

إرشادات التوافق مع Android TV

يتطلب جعل تطبيق البث متوافقًا مع Android TV القليل من العمل الإضافي. إليك بعض الاقتراحات والمشاكل الشائعة التي يجب تفاديها لضمان توافق التطبيق مع Android TV:

• يُرجى الانتباه إلى أنّ سلسلة وكيل المستخدم تحتوي على كلّ من "Android" و "CrKey"، لأن بعض المواقع الإلكترونية قد تُعيد توجيه المستخدمين إلى موقع إلكتروني متوافق مع الأجهزة الجوّالة فقط لأنّها تكتشف تصنيف "Android". لا تفترض أنّ "Android" في سلسلة وكيل المستخدم يشير دائمًا إلى مستخدِم الجوّال.
• قد تستخدم حزمة وسائط Android ملف GZIP الشفاف لاسترجاع البيانات. تأكَّد من أنّ بيانات الوسائط يمكنها الردّ على Accept-Encoding: gzip.
• يمكن بدء أحداث وسائط HTML5 على Android TV في توقيتات مختلفة عن توقيت Chromecast، وقد يكشف ذلك عن مشاكل كانت مخفية على Chromecast.
• عند تعديل الوسائط، استخدِم الأحداث ذات الصلة بالوسائط التي يتم تنشيطها من خلال عناصر <audio>/<video>، مثل timeupdate وpause وwaiting. تجنَّب استخدام الأحداث ذات الصلة بالشبكات مثل progress وsuspend وstalled، لأنّها غالبًا ما تعتمد على النظام الأساسي.
• عند ضبط شهادات HTTPS للموقع الإلكتروني لأداة استقبال الويب، احرِص على تضمين شهادات CA المتوسطة. راجِع صفحة اختبار طبقة المقابس الآمنة (SSL) في Qualsys للتأكّد مما يلي: إذا كان مسار الشهادة الموثوق بها لموقعك الإلكتروني يتضمّن شهادة CA تحمل التصنيف "تنزيل إضافي"، قد لا يتم تحميلها على الأنظمة الأساسية المستندة إلى Android.
• يعرض جهاز Chromecast صفحة استقبال الويب على مستوى رسومات بدقة 720p، بينما قد تعرض منصات البث الأخرى، بما في ذلك Android TV، الصفحة بدقة تصل إلى 1080p. التأكّد من ضبط حجم صفحة جهاز استقبال الويب على نحو ملائم بدرجات دقة مختلفة

استخدام Android Debug Bridge

يتم عرض نظام Android TV على العديد من أنواع الأجهزة الإلكترونية الاستهلاكية: أجهزة التلفزيون وأجهزة الاستقبال الرقمية ووحدات التحكّم بالألعاب وما إلى ذلك. قد يتم ضبط كل إعداد منهما بشكل مختلف. إذا كنت تواجه صعوبة في الوصول إلى موارد نظام Android TV من خلال واجهة مستخدم الجهاز، يمكنك استخدام Android Debug Bridge (ADB) للحصول على الرقم التسلسلي للجهاز من أجل التسجيل، بالإضافة إلى تصحيح أخطاء تطبيقك. راجع Android Debug Bridge للحصول على مزيد من المعلومات.

استخدام ADB عبر Wi-Fi

للاتصال بجهازك عبر ADB باستخدام اتصال Wi-Fi، اتّبِع الخطوات التالية:

1. على جهاز Android TV، فعِّل خيارات المطوّرين كما هو موضّح في الإعداد للتطوير.
2. احرِص على اتصال جهاز الكمبيوتر بالشبكة نفسها التي يتصل بها جهاز Android TV.

3. افتح وحدة طرفية وأدخِل ما يلي:

   adb connect Android TV device IP address:4321
   

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

   adb logcat

استخدام ADB مع كابل USB

للاتصال بجهازك عبر ADB باستخدام كابل USB:

1. عليك إعداد جهاز Android TV للتطوير، كما هو موضَّح في الإعداد للتطوير.
2. وصِّل الطرف الرئيسي لكابل USB بجهاز الكمبيوتر.
3. في مربع الحوار هل تريد السماح بتصحيح أخطاء USB؟، اختَر السماح دائمًا من هذا الكمبيوتر واختَر حسنًا.

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

   adb logcat

استخدام ADB عبر بروتوكول TCP/IP

يعمل نظام ADB بدون كابل USB، عبر بروتوكول TCP/IP، ولكن يجب عليك أولاً الحصول على عنوان IP لجهاز Android TV. تستمع أجهزة مشكلات المطور إلى اتصالات منفذ ADB تلقائيًا ويمكن توصيلها دون تهيئة المنفذ. لا تستمع أجهزة Android TV العادية للبيع بالتجزئة إلى اتصالات ADB تلقائيًا. وفي هذه الأجهزة، عليك أولاً الاتصال بـ ADB باستخدام كابل USB وإعداد المنفذ.

1. عليك إعداد جهاز Android TV للتطوير، كما هو موضَّح في الإعداد للتطوير.
2. على Android TV، في صف الجهاز، اختَر الشبكة > Wi-Fi، واختَر الشبكة المتصلة.
3. اختَر معلومات الحالة ودوِّن عنوان IP.

4. إذا كان جهازك عبارة عن جهاز Android TV عادي للبيع بالتجزئة، يمكنك اتّباع الخطوات التالية:

   1. اتّبِع الخطوات الواردة في استخدام ADB مع كابل USB.
   2. تأكّد من أنّ جهاز الكمبيوتر متصل بالشبكة نفسها التي يتصل بها جهاز Android TV.

   3. على الكمبيوتر، في طرفية، قم بتهيئة منفذ TCP/IP عن طريق إدخال ما يلي:

      adb tcpip 5555

   4. انزع كابل USB، وأدخِل ما يلي في الوحدة الطرفية:

      adb connect Android TV device IP address:5555
      

5. إذا كان جهازك يعمل بنظام Android TV من إصدار مطوّري البرامج، يُرجى اتّباع الخطوات التالية:

   1. تأكّد من أنّ جهاز الكمبيوتر متصل بالشبكة نفسها التي يتصل بها جهاز Android TV.

   2. افتح وحدة طرفية وأدخِل ما يلي:

      adb connect Android TV device IP address:4321
      

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

   adb logcat