עם השקת Android 5.0 מגיע Android TV שתומך ב-Google Cast. במסמך הזה מוסבר מה צריך לעשות כדי להגדיר ולבדוק את האפליקציה ב-Android TV במהלך הפיתוח של אפליקציות Cast. אפליקציית Cast הקיימת שלכם פועלת ב-Android TV ללא מאמץ נוסף. אם אתם מפתחים אפליקציית Cast בפעם הראשונה, כדאי לעיין במסמכי התיעוד של Google Cast ולפתח את אפליקציית ההעברה כדי שתפעל במכשיר Chromecast לפני הפיתוח והבדיקה עם Android TV.
הגדרה לקראת פיתוח
- מגדירים את מכשיר Android TV:
- מחברים את מכשיר ה-Android TV לרשת המקומית.
- נכנסים לחשבון Google.
- מהרשימה הגדרות, בשורה מכשיר, בוחרים באפשרות מידע כללי.
- גוללים למטה ולוחצים על Build כמה פעמים עד שמופיעה תיבת דו-שיח עם ההודעה "You are now a Developers".
- אם ניפוי הבאגים ב-USB:
- מתקינים את כבל ה-USB, אבל עדיין לא מחברים את הקצה העליון של כבל ה-USB למחשב.
- בשורה העדפות, לוחצים על אפשרויות למפתחים, ואז על ניפוי באגים ב-USB ולאחר מכן על מופעל.
- חוזרים למסך הבית. עליכם לעשות זאת כדי להחיל את ההגדרות שבחרתם. ההגדרות יישמרו ללא שינוי, אלא אם תבצעו איפוס להגדרות המקוריות.
- רושמים את מכשיר ה-Android TV במסוף המפתחים של Google Cast SDK, כפי שמתואר ברישום מכשיר.
ניפוי באגים
כדי לבדוק את תוצאות ניפוי הבאגים של אפליקציית מקלט האינטרנט במכשיר Android TV, נסו לבצע את הפעולות הבאות:
- רושמים את האפליקציה ל-Android TV ואת הבקשה במסוף המפתחים של Google Cast SDK. מידע נוסף על רישום מכשירים ואפליקציות זמין בקטע רישום.
- מפעילים את אפליקציית השולח ומעבירים למכשיר Android TV.
- מתחברים למכשיר Android TV באמצעות ADB, כפי שמתואר במאמר איך משתמשים ב-Android Debug Bridge.
- במחשב הפיתוח, פותחים חלון של דפדפן Chrome ועוברים אל chrome://inspect.
- לוחצים על הקישור inspect כדי להעביר את מקלט האינטרנט לניפוי באגים.
במסוף ניפוי באגים מרחוק של 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 כדי לוודא: אם מסלול האישור המוסמך לאתר שלכם כולל אישור CA שנקרא 'הורדה נוספת', ייתכן שהוא לא ייטען בפלטפורמות מבוססות Android.
- בזמן ש-Chromecast מציג את דף מקלט האינטרנט במטוס גרפי של 720p, פלטפורמות Cast אחרות, כולל Android TV, עשויות להציג את הדף עד ל-1080p. הקפידו לשנות את קנה המידה של דף מקלט האינטרנט ברזולוציות שונות.
באמצעות Android Debug Bridge
פלטפורמת Android TV מוצגת בסוגים רבים של מכשירי אלקטרוניקה בידוריים: טלוויזיות, ממירים, קונסולות משחקים וכו'. אפשר להגדיר כל אחד מהם באופן שונה. אם נתקלת בקשיים בגישה למשאבי המערכת של Android TV דרך ממשק המשתמש של המכשיר, אפשר להשתמש ב-Android Debug Bridge (ADB) כדי לקבל את המספר הסידורי של המכשיר לרישום, וגם לנפות באגים באפליקציה. למידע נוסף, קראו את הגשר לניפוי באגים ב-Android.
שימוש ב-ADB בחיבור Wi-Fi
כדי להתחבר למכשיר באמצעות ADB באמצעות חיבור Wi-Fi:
- במכשיר Android TV הפעלתם את האפשרויות למפתחים כפי שמתואר בקטע הגדרת פיתוח.
- מוודאים שהמחשב ומכשיר Android TV מחוברים לאותה רשת.
פותחים מסוף ומזינים את הפרטים הבאים:
adb connect Android TV device IP address:4321
במחשב, פותחים מסוף ומזינים פקודות ADB. ניתן לוודא שהחיבור נוצר ושמכשיר Android TV מתקשר ברשת, באמצעות הפקודה הבאה:
adb logcat
שימוש ב-ADB עם כבל USB
כדי להתחבר למכשיר באמצעות ADB באמצעות כבל USB:
- מגדירים את מכשיר ה-Android TV לפיתוח, כפי שמתואר בקטע הגדרת פיתוח.
- מחברים את הקצה העליון של כבל ה-USB למחשב.
- בתיבת הדו-שיח האם לאפשר ניפוי באגים ב-USB? לוחצים על לאפשר מהמחשב הזה ובוחרים באפשרות אישור.
במחשב, פותחים מסוף ומזינים פקודות ADB. ניתן לוודא שהחיבור נוצר ושמכשיר Android TV מתקשר ברשת, באמצעות הפקודה הבאה:
adb logcat
שימוש ב-ADB באמצעות TCP/IP
ADB פועל ללא כבל USB, באמצעות TCP/IP, אך תחילה עליכם לקבל את כתובת ה-IP של מכשיר ה-Android TV. מכשירים עם בעיות למפתחים מאזינים לחיבורים של יציאות ADB באופן אוטומטי, ואפשר לחבר אותם בלי להפעיל את היציאה. התקני Android TV הרגילים לא מאזינים באופן אוטומטי לחיבורי ADB. למכשירים האלה צריך קודם להתחבר ל-ADB באמצעות כבל USB ולהפעיל את היציאה.
- מגדירים את מכשיר ה-Android TV לפיתוח, כפי שמתואר בקטע הגדרת פיתוח.
- ב-Android TV, בשורה מכשיר, בוחרים באפשרות רשת > Wi-Fi ובוחרים ברשת המחוברת.
- בוחרים באפשרות פרטי סטטוס ומציינים את כתובת ה-IP.
אם המכשיר שלכם הוא מכשיר קמעונאי רגיל של Android TV, עליכם לבצע את הפעולות הבאות:
- מבצעים את ההוראות שמפורטות במאמר שימוש ב-ADB עם כבל USB.
- חשוב לוודא שהמחשב מחובר לאותה הרשת שאליה מחובר מכשיר ה-Android TV.
במחשב, במסוף, מפעילים את היציאה ל-TCP/IP על ידי הזנת הפקודות הבאות:
adb tcpip 5555
מסירים את כבל ה-USB ומזינים את הפרטים הבאים במסוף:
adb connect Android TV device IP address:5555
אם יש לכם מכשיר Android TV עם בעיה למפתחים, עליכם לפעול לפי השלבים הבאים:
- ודאו שהמחשב מחובר לאותה רשת שאליה מחובר מכשיר ה-Android TV.
פותחים מסוף ומזינים את הפרטים הבאים:
adb connect Android TV device IP address:4321
ב-Android TV, בתיבת הדו-שיח האם לאפשר ניפוי באגים ב-USB? לוחצים על לאפשר תמיד מהמחשב הזה ולאחר מכן על אישור. ניתן לוודא שהחיבור נוצר ושמכשיר Android TV מתקשר באמצעות הרשת באמצעות הפקודה הבאה:
adb logcat