כלי פקודות ובקרה (CAC)

כלי הבקרה והבקרה (CaC) הוא שולח אינטרנט פונקציונלי שמאפשר למפתחים לבדוק ולנפות באגים באפליקציה של מקלט אינטרנט.

מפתחים יכולים להשתמש בכלי CAC כדי:

  • הפעילו אפליקציה של מקלט אינטרנט במכשיר שתומך ב-Cast, ושלחו בקשת טעינה כדי להפעיל את המדיה.
  • הדמיה של פקודות קוליות ש-Google Assistant שולחת למקלט האינטרנט.
  • מתעדים יומנים מהכלי תיעוד של ניפוי באגים ב-Cast ושולטים בשכבת-העל של ניפוי הבאגים של מקלט האינטרנט.

הפעלת האפליקציה 'מקלט אינטרנט'

יש שתי דרכים להפעיל את מקלט האינטרנט באמצעות כלי CAC:

  1. כדי להתחיל סשן חדש של העברה (cast):

    1. פותחים את הכלי CAC, מזינים את מזהה האפליקציה של מקלט האינטרנט ולוחצים על הלחצן הגדרת מזהה האפליקציה.
    2. לחצו על לחצן הפעלת Cast ובחרו מכשיר כדי להפעיל את מקלט האינטרנט במכשיר מרוחק.

  2. כדי להצטרף לסשן העברה קיים:

    1. אפשר לקבל את מזהה סשן ההעברה ב-Cast באמצעות הקודים הבאים:

      בצד של מקלט האינטרנט, השתמשו בשיטה הבאה כדי לקבל מזהה הפעלה במסוף ניפוי באגים מרחוק ב-Chrome:

      cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;
      

      לחלופין, כדי לקבל את מזהה הסשן משולח אינטרנט מחובר, יש להשתמש בשיטה הבאה:

      cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();
      
    2. מזינים את מזהה הסשן בכלי CAC ולוחצים על הלחצן המשך.

כאשר כלי ה-CCA מחובר לאפליקציית מקלט האינטרנט, לחצן ההעברה מופיע בצורת מסגרת מלאה. גם מזהה האפליקציה ומזהה הסשן ב-Web Weber מוצגים בחלק העליון של הכלי.

טעינת המדיה

אפשר לטעון מדיה מאפליקציית השולח או מכלי ה-CAC.

אפליקציית השולח

כדי להפעיל הפעלה של מדיה במקלט האינטרנט, צריך להעביר את אפליקציית השולח לאותו מכשיר שההעברה אליו מופעלת, ולשלוח בקשת טעינה מאפליקציית השולח למקלט האינטרנט.

כלי CAC

בנוסף, בכלי CaC יש כמה דרכים לשלוח בקשת טעינה לאפליקציה Webמשלימים:

טעינה לפי ישות (העברה קולית)

כשמשתמשים מפעילים מדיה דרך Google Assistant, Google Assistant משתמשת בהודעות Command ו-CaC כדי לשלוח את פרטי הכניסה והישות אל מקלט האינטרנט שלכם.

כלי ה-CCA מדמה העברה (cast) ושולח בקשת טעינה עם credentials ועם entity.

טעינה לפי תוכן

בנוסף, כלי ה-CAC יכול לדמות את האפליקציה שלכם כך שהיא שולחת בקשת טעינה באמצעות Content ID או Content Url.

כשמפעילים מדיה, הכלי CaC Tool מקבל הודעות סטטוס מדיה מהאפליקציה של מקלט האינטרנט ומציג אותן בכרטיסייה סטטוס המדיה.

בקשת טעינה מותאמת אישית

אם אתם רוצים לבדוק את המקלט באמצעות אובייקטים משלכם מסוג Load Request, תוכלו להשתמש בשדה Request Load Request (שדה 'בקשת טעינה מותאמת אישית') בכרטיסייה LOAD MEDIA. קודם כול, בוחרים את סוג הבקשה מלחצני הבחירה Select Type Type (בחירת סוג בקשה), ולאחר מכן מעתיקים ומדביקים או יוצרים אובייקט JSON משלכם.

בדיקת הפקודות הקוליות

כלי ה-CAC מדמה גם פקודות קוליות ש-Google Assistant שולחת לאפליקציה שלכם באינטרנט. אתם יכולים לבדוק אם פקודות המדיה שהאפליקציה שלכם תומכת בהן פועלות כמו שצריך. יש לטפל בפקודות מדיה שלא נתמכות על ידי סוג השגיאה והסיבות לשגיאה.

איך בודקים ומנהלים את ניפוי הבאגים של ההעברה?

אם האפליקציה של מקלט האינטרנט שלכם מאפשרת תיעוד יומן לניפוי באגים, הכלי CaC יוצר תיעוד של הודעות היומן ושולט בשכבת ניפוי הבאגים של מקלט האינטרנט.

השתמש בלחצנים הבאים כדי לשלוט במקלט האינטרנט ובהודעות ביומן:

  • מזהה האפליקציה של מקלט האינטרנט
    • ניקוי המטמון והפסקת קליטת האינטרנט – טעינה מחדש של אפליקציית מקלט האינטרנט והפסקת ההעברה
  • שכבת-על של ניפוי באגים במקלט אינטרנט
    • הצגה – החלפת שכבת-על של ניפוי באגים במקלט האינטרנט
    • ניקוי – מחיקת הודעות היומן בשכבת-העל של ניפוי הבאגים של המקלט באינטרנט
  • רישום פקדי הודעות
    • הוספת הודעה - הוספת תגובות או מחיצות באזור היומן
    • הורדת היומן – שמירת הודעות ביומן
    • ניקוי היומן – מחיקת הודעות היומן באזור היומן
  • רישום הודעות ביומן
    • תגים מותאמים אישית - לוחצים על תיבת הסימון כדי לסנן הודעות יומן

התגים הבאים עשויים להופיע בקטע תגים מותאמים אישית. הכלים האלה נוספים לכלי CAC כדי להציג ולסנן יומנים או הודעות חשובים שקשורים לסשן הבדיקה:

  • MEDIA - הודעות שנשלחו בהצלחה במרחב השמות של Media
  • MEDIA-ERROR – אירעה שגיאה במהלך השליחה או בתגובה להודעות שנשלחו במרחב השמות של Media
  • CAC – הודעות שנשלחו בהצלחה במרחב השמות CAC
  • CAC-ERROR – אירעה שגיאה במהלך השליחה או בתגובה להודעות שנשלחו במרחב השמות CAC
  • פועל - היומן מציג את התוצאה כשלוחצים על הלחצן מה שומעים? בכלי CaC
  • USER - יומן שבו מוצגת הודעה מותאמת אישית שהזין המשתמש באמצעות הלחצן הוספת הודעה בכלי CAC

בדיקת Cast Connect

כדי לבדוק את Cast Connect, יש לבצע את השלבים הבאים לפני יצירת הסשן:

  1. מזינים את מזהה האפליקציה המקבל המשויך למקלט התומך ב-Cast Connect, ולוחצים על הגדרת מזהה האפליקציה.
  2. לוחצים על הצגת אפשרויות Android TV.
  3. מסמנים את התיבה androidReceiverתואם. אם המקבל לא מחייב להגדיר את Launch Credentials, או אם רוצים לבדוק מה קורה במקרה שהוא לא מוגדר, אפשר להפסיק כאן ולהמשיך לשלב 5.
  4. (אופציונלי) מזינים את Launch Credentials ולוחצים על הלחצן הגדרת פרטי כניסה להפעלה כדי להגדיר את פרטי הכניסה לפעילות של הפעלת ההעברה.
  5. כדי להתחיל פעילות העברה, לוחצים על סמל ההעברה (cast) בכותרת או דרך תפריט ההעברה בדפדפן Chrome.

אפליקציית Android TV שלך אמורה לפעול עכשיו במכשיר.