Android TV مع Google Cast

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

ملاحظة: يفترض هذا المستند أنك طورت تطبيقًا من قبل على جهاز Chromecast، حيث يمثل ذلك خطوة أولى إلزامية نحو تطبيق Google Cast الذي يعمل على 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 كـ كما هو موضح في تسجيل الأجهزة.

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

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

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

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

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

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

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

يتطلب جعل تطبيق Cast متوافقًا مع 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 التحقق: إذا كان مسار الشهادة الموثوق بها لموقعك يتضمن مرجعًا تصديقًا شهادة تحمل اسم "تنزيل إضافي"، فقد لا يتم تحميلها على أجهزة 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. جهاز تلفزيون

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، ولكن يجب عليك أولاً الحصول على جهاز Android عنوان IP لجهاز التلفزيون. معالجة الأجهزة التي تواجه المطوّر لاتصالات منفذ ADB تلقائيًا ويمكن توصيلها دون تهيئة المنفذ. عادي لا تستجيب أجهزة Android TV للبيع بالتجزئة إلى اتصالات ADB تلقائيًا. حيث هذه الأجهزة، يجب أولاً الاتصال بـ ADB باستخدام كابل USB وتهيئة المنفذ.

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

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

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

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

      adb tcpip 5555

   4. أزِل كابل USB، وأدخِل ما يلي في الطرف الكهربائي:

      adb connect Android TV device IP address:5555
      

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

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

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

      adb connect Android TV device IP address:4321
      

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

   adb logcat