Android TV با Google Cast

با انتشار اندروید 5.0 اندروید تی وی که از Google Cast پشتیبانی می کند، عرضه می شود. این سند آنچه را که برای راه‌اندازی و آزمایش در Android TV هنگام توسعه برنامه‌های Cast باید انجام دهید، توضیح می‌دهد. برنامه Cast موجود شما در Android TV بدون هیچ تلاش اضافی اجرا می شود. اگر برای اولین بار است که یک برنامه Cast ایجاد می‌کنید، اسناد Google Cast را مرور کنید و قبل از توسعه و آزمایش با Android TV، برنامه Cast خود را برای اجرا در دستگاه Chromecast توسعه دهید.

توجه: این سند فرض می‌کند که شما قبلاً برنامه‌ای را توسعه داده‌اید که روی دستگاه Chromecast اجرا می‌شود، زیرا این اولین قدم اجباری برای اجرای برنامه Cast شما در Android TV است.

راه اندازی برای توسعه

1. دستگاه Android TV خود را راه اندازی کنید:
   1. دستگاه Android TV را به شبکه محلی وصل کنید.
   2. وارد حساب گوگل خود شوید
2. از تنظیمات ، در ردیف دستگاه ، درباره را انتخاب کنید.
3. به پایین بروید و چندین بار روی Build کلیک کنید تا زمانی که یک گفتگو با پیام "You are now a developer" ظاهر شود.
4. در صورت اشکال زدایی USB:
   1. کابل USB را نصب کنید، اما انتهای اصلی کابل USB را هنوز به رایانه خود وصل نکنید.
   2. در ردیف Preferences ، Developer options را انتخاب کنید، USB debugging را انتخاب کنید و On را انتخاب کنید.
5. به صفحه اصلی برگردید. برای اعمال تنظیماتی که انتخاب کرده اید باید این کار را انجام دهید. تنظیمات باقی خواهند ماند مگر اینکه بازنشانی کارخانه ای انجام دهید.
6. همانطور که در ثبت دستگاه توضیح داده شده است، دستگاه Android TV خود را در کنسول برنامه‌نویس Google Cast SDK ثبت کنید.

اشکال زدایی

برای آزمایش و رفع اشکال برنامه Web Receiver خود در دستگاه Android TV خود، موارد زیر را انجام دهید:

1. دستگاه Android TV و برنامه خود را در کنسول برنامه‌نویس Google Cast SDK ثبت کنید. برای اطلاعات بیشتر در مورد ثبت دستگاه ها و برنامه ها به ثبت مراجعه کنید.
2. برنامه فرستنده خود را راه اندازی کنید و به دستگاه Android TV ارسال کنید.
3. همانطور که در استفاده از Android Debug Bridge توضیح داده شده است، از طریق ADB به دستگاه Android TV خود متصل شوید.
4. در دستگاه توسعه خود، یک پنجره مرورگر Chrome باز کنید و به chrome://inspect بروید.
   توجه: این گزینه با گزینه اشکال‌زدایی برای دستگاه Chromecast متفاوت است، جایی که به آدرس IP گیرنده وب خود در پورت 9222 پیمایش می‌کنید.
5. روی پیوند بازرسی کلیک کنید تا گیرنده وب به دیباگر وارد شود.

6. در کنسول Chrome Remote Debugger، با وارد کردن موارد زیر، گزارش اشکال زدایی را فعال کنید:

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

برای اطلاعات بیشتر به اشکال زدایی مراجعه کنید.

دستورالعمل‌های سازگاری Android TV

سازگار کردن برنامه Cast خود با Android TV به کار اضافی کمی نیاز دارد. برای اطمینان از سازگاری برنامه شما با Android TV، توصیه‌ها و مشکلات رایجی که باید از آنها اجتناب کنید در اینجا آمده است:

• توجه داشته باشید که رشته user-agent شامل «Android» و «CrKey» است. برخی از سایت‌ها ممکن است به یک سایت فقط تلفن همراه هدایت شوند زیرا برچسب "Android" را تشخیص می‌دهند. فرض نکنید که "Android" در رشته user-agent همیشه یک کاربر تلفن همراه را نشان می دهد.
• پشته رسانه Android ممکن است از GZIP شفاف برای واکشی داده استفاده کند. مطمئن شوید که داده‌های رسانه شما می‌توانند به Accept-Encoding: gzip .
• رویدادهای رسانه Android TV HTML5 ممکن است در زمان‌های متفاوتی نسبت به Chromecast فعال شوند، این ممکن است مشکلاتی را نشان دهد که در Chromecast پنهان شده‌اند.
• هنگام به‌روزرسانی رسانه، از رویدادهای مرتبط با رسانه که توسط عناصر <audio>/<video> اجرا می‌شوند، مانند timeupdate ، pause و waiting استفاده کنید. از استفاده از رویدادهای مرتبط با شبکه مانند progress ، suspend و stalled خودداری کنید، زیرا این رویدادها به پلتفرم وابسته هستند.
• هنگام پیکربندی گواهی‌های HTTPS سایت گیرنده وب خود، حتماً گواهی‌های CA میانی را نیز لحاظ کنید. برای تأیید، به صفحه آزمایش Qualsys SSL مراجعه کنید: اگر مسیر تأیید اعتبار سایت شما دارای گواهینامه CA با عنوان «دانلود اضافی» باشد، ممکن است در پلتفرم‌های مبتنی بر Android بارگیری نشود.
• در حالی که Chromecast صفحه گیرنده وب را در صفحه گرافیکی 720p نمایش می دهد، سایر پلتفرم های Cast از جمله Android TV ممکن است صفحه را تا 1080p نمایش دهند. اطمینان حاصل کنید که صفحه گیرنده وب شما با رزولوشن های مختلف به خوبی مقیاس می شود.

استفاده از پل دیباگ اندروید

پلتفرم 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. در Allow USB debugging؟ گفتگو، از این رایانه همیشه اجازه داده شود و OK را انتخاب کنید.

4. در رایانه خود، یک ترمینال را باز کنید و دستورات ADB را وارد کنید. با دستور زیر می توانید تأیید کنید که اتصال برقرار شده است و دستگاه Android TV در حال برقراری ارتباط در سراسر شبکه است:

   adb logcat

استفاده از ADB از طریق TCP/IP

ADB بدون کابل USB، از طریق TCP/IP کار می کند، اما ابتدا باید آدرس IP دستگاه Android TV را دریافت کنید. دستگاه‌های دارای مشکل توسعه‌دهنده به طور خودکار به اتصالات درگاه ADB گوش می‌دهند و می‌توانند بدون مقداردهی اولیه پورت متصل شوند. دستگاه‌های تلویزیون Android خرده‌فروشی استاندارد به طور خودکار به اتصالات ADB گوش نمی‌دهند. برای این دستگاه ها ابتدا باید با کابل USB به ADB متصل شده و پورت را مقدار دهی اولیه کنید.

1. همانطور که در تنظیمات برای توسعه توضیح داده شده است، دستگاه Android TV خود را برای توسعه تنظیم کنید.
2. در Android TV، در ردیف Device ، Network > Wi-Fi را انتخاب کنید و شبکه متصل را انتخاب کنید.
3. Status info را انتخاب کنید و آدرس 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، در Allow USB debugging؟ گفتگو، از این رایانه همیشه اجازه داده شود و تأیید را انتخاب کنید. با دستور زیر می توانید تأیید کنید که اتصال برقرار شده است و دستگاه Android TV در حال برقراری ارتباط در سراسر شبکه است:

   adb logcat