הרשמה

אם אתם משתמשים ב-Styled Media Receiver או ב-Custom Receiver, אתם צריכים לרשום את האפליקציה. אחרי שרושמים את האפליקציה, מקבלים מזהה אפליקציה. אפליקציית השולח משתמשת במזהה הזה כדי לבצע קריאות API, למשל כדי להפעיל אפליקציית Web Receiver.

אם אתם משתמשים בDefault Media Receiver, אתם לא צריכים לרשום את האפליקציה. ה-Default Media Receiver לא מאפשר לספק סגנון לממשק המשתמש של נגן המדיה, והוא משתמש בקבוע שסופק כמזהה האפליקציה.

בנוסף, צריך לרשום את מכשיר Google Cast כדי שיוכל לגשת לאפליקציית Web Receiver לפני שמפרסמים אותה. אחרי שמפרסמים את אפליקציית המקלט, היא זמינה לכל מכשירי Google Cast.

אפליקציות

הרשמה של האפליקציה מאפשרת לכם לבדוק אותה מול מכשיר Cast רשום לפני שאתם מפרסמים את האפליקציה. פרסום האפליקציה מאפשר להשתמש בה בכל מכשירי Cast.

רישום האפליקציה

צריך לרשום Styled Media Receiver או Custom Receiver כדי לקבל מזהה אפליקציה שמשמש לקריאות API מאפליקציית השולח.

כדי לרשום את אפליקציית Cast:

  1. נכנסים אל Google Cast SDK Developer Console.
  2. בדף סקירה כללית או בדף אפליקציות, לוחצים על הוספת אפליקציה חדשה.

  3. בוחרים את סוג אפליקציית Web Receiver שבה רוצים להשתמש:

    • Custom Receiver

      בוחרים באפשרות הזו אם האפליקציה דורשת רכיבי ממשק משתמש או דפוסי אינטראקציה שלא מסופקים על ידי Styled Media Receiver. יכול להיות שיהיה צורך לבחור באפשרות Custom Receiver (מקלט בהתאמה אישית) אם סוג התוכן שלכם לא מופיע ברשימת סוגי המדיה הנתמכים של Styled Media Receiver (מקלט מדיה עם סגנון).

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

      פרטים נוספים מופיעים במאמר בנושא אפליקציית מקלט בהתאמה אישית.

    • Styled Media Receiver

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

      הסגנונות המותאמים אישית שאתם יכולים לספק מאפשרים לכם להגדיר את המראה של רכיבים שונים בממשק המשתמש של הנגן (כמו מסך הפתיחה וסרגל ההתקדמות) פשוט על ידי אספקת קובץ CSS – אתם לא צריכים ליצור אפליקציית מקלט.

      פרטים נוספים זמינים במאמר בנושא Styled Media Receiver.

  4. ממלאים את הפרטים של אפליקציית Web Receiver:

    1. בשדה Name, מזינים את שם האפליקציה.

      זהו שם האפליקציה שמופיע בזמן הטעינה של Web Receiver או במצב בלי פעילות אם משתמשים ב-Styled Media Receiver. אם משתמשים ב-Custom Receiver, הערך של השדה הזה הוא ערך ברירת המחדל של מצב האפליקציה, אם הוא לא מוגדר באמצעות השיטה setApplicationState.

    2. מציינים את המראה של אפליקציית Web Receiver:

      • במקלט בהתאמה אישית, בשדה כתובת URL, מציינים את כתובת ה-URL של האפליקציה.

        מזינים כתובת URL שהמכשיר עם Google Cast צריך לשלוח בקשה אליה כשמטעינים את אפליקציית Web Receiver. במהלך הפיתוח, כתובת ה-URL יכולה להשתמש ב-HTTP, אבל כשמפרסמים את האפליקציה היא חייבת להשתמש ב-HTTPS. כתובת ה-URL יכולה להיות של דף HTML או של סוג קובץ אחר שאפשר לגשת אליו מדפדפן אינטרנט. אין בעיה שכתובת ה-IP של Web Receiver תהיה פנימית (רשומה ב-NAT), אבל היא לא יכולה להיות localhost, כי בדרך כלל זה לא דומיין ברמה העליונה. אף על פי שאפליקציית Web Receiver צריכה להיות מוגשת באמצעות SSL‏ (HTTPS) כשהיא מתפרסמת, יכול להיות שהתוכן שנטען באפליקציית Web Receiver מוגש באמצעות HTTP.

      • במקלט מדיה עם סגנון, בשדה Skin URL (כתובת ה-URL של הסקין), מציינים את כתובת ה-URL של גיליון הסגנונות.

        צריך לספק כתובת URL מסוג HTTPS שמפנה לקובץ ה-CSS שנמצא באתר שלכם. כדי להשתמש בסגנונות ברירת המחדל, משאירים את השדה ריק. תמיד אפשר לערוך את זה מאוחר יותר אם רוצים לספק או לעדכן את הסגנונות המותאמים אישית.

      • מסמנים את התיבה תמיכה בהעברה לשידור או מבטלים את הסימון שלה.

        העברת Cast מאפשרת ל-Web Receiver לתמוך ב-Cast משולחים שלא מחוברים לאותה רשת Wi-Fi שאליה מחובר ה-Receiver. כדי להשבית את ההפעלה של Cast עם שידור חוזר במכשיר המקלט, מבטלים את הסימון בתיבה הזו.

      • מסמנים את התיבה Supports casting to audio-only devices או מבטלים את הסימון שלה.

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

  5. לוחצים על שמירה.

    פרטי הרישום שלכם, כולל מזהה האפליקציה, השם, הסוג והסטטוס, מוצגים. חשוב לרשום את מזהה האפליקציה, כי תצטרכו לספק אותו עם הקריאות ל-Cast API של האפליקציה.

  6. לוחצים על סיום כדי לחזור לדף האפליקציות.

עריכת פרטי האפליקציה

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

כדי לערוך את פרטי האפליקציה:

  1. ב-Google Cast SDK Developer Console, בדף Overview או בדף Applications, לוחצים על מזהה האפליקציה או על Edit ליד האפליקציה שרוצים לערוך.
  2. בשדה Name, מעדכנים את השם שציינתם כשנרשמתם לאפליקציה.
  3. באפליקציות של מקלט בהתאמה אישית, בשדה כתובת URL, מעדכנים את המיקום של אפליקציית Web Receiver שרשמתם.
  4. באפליקציות של מקלט עם סגנון, בשדה Skin URL (כתובת URL של סקין), מעדכנים את המיקום של גיליון הסגנונות של האפליקציה.

  5. מסמנים את התיבה תמיכה בהעברה לשידור או מבטלים את הסימון שלה.

    הפעלת Cast באמצעות שרת ממסר מאפשרת ל-Web Receiver לתמוך בהפעלת Cast משולחים שלא מחוברים לאותה רשת Wi-Fi שאליה מחובר ה-Receiver. כדי להשבית את ההפעלה של שידור חוזר במכשיר המקלט, מבטלים את הסימון בתיבה הזו.

  6. מסמנים את התיבה תמיכה בהפעלת Cast אל מכשירים עם אודיו בלבד או מבטלים את הסימון שלה.

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

  7. בקטע פרטי השולח, מספקים את הפרטים הבאים לכל פלטפורמה שהאפליקציה תומכת בה:

    • Android:

      • השם המלא של חבילת האפליקציה.

    • iOS:

    • אינטרנט:

      • כתובת ה-URL של האתר של האפליקציה.

  8. בקטע פרטי כרטיס המוצר, בוחרים אם לפרסם את האפליקציה בנכסי Google כמו chromecast.com/apps.

  9. בתפריט הנפתח קטגוריה, בוחרים את הקטגוריה שמתארת בצורה הכי טובה את האפליקציה.

    הערה: האפליקציה שלכם צריכה לתמוך בסוגי המדיה שמתוארים כאן, וגם בסוגים שמשתמעים מהגדרות אחרות. לדוגמה, אם האפליקציה שלכם תומכת ב-Google Cast לאודיו, ואתם בוחרים כאן באפשרות 'טלוויזיה וסרטים', האפליקציה שלכם צריכה לתמוך במכשירים לאודיו בלבד, כפי שמתואר במכשירי אודיו, וגם בהוראות להפעלת סרטונים.

  10. כדי לתאר את המדינות שבהן האפליקציה זמינה, בוחרים באפשרות כל המדינות או באפשרות רק במדינות נבחרות. אם בוחרים באפשרות השנייה, מסמנים את התיבות של המדינות הרלוונטיות ברשימה שמופיעה.

  11. בשדה Title (שם), נותנים שם תיאורי לאפליקציה.

    אפשר להשתמש ב-50 תווים לכל היותר. לדוגמה, 'YouTube'.

  12. בשדה Description (תיאור), מזינים תיאור של האפליקציה.

    אפשר להשתמש ב-80 תווים לכל היותר. לדוגמה, "צפייה בערוצים האהובים ב-YouTube במסך הכי טוב בבית".

  13. בקטע Graphics (גרפיקה), לוחצים על סימן הפלוס כדי להעלות את תמונת הסמל של האפליקציה.

    התמונה צריכה להיות בגודל ‎512 x 512 פיקסלים, והרקע שלה יכול להיות שקוף.

  14. בקטע הוספת תרגומים משלך, אם רוצים לספק תרגומים לשדות שם ותיאור, בוחרים את השפה מהתפריט הנפתח, לוחצים על הוספה ומזינים את הטקסט המתורגם בתיבת הדו-שיח שמופיעה. אפשר גם להעלות תמונה לסמל שספציפי לתרגום הזה.

  15. כשמסיימים לעדכן את פרטי האפליקציה, לוחצים על שמירה.

פרסום האפליקציה

פרסום האפליקציה מאפשר להשתמש בה בכל מכשירי Cast בעולם. בנוסף, המערכת יוצרת כרטיס לאפליקציה במוצרי Google, כמו אתר הכרטיסים chromecast.com/apps, שבו משתמשים יכולים לגלות את האפליקציה ולהוריד אותה. אם בחרתם לפרסם את האפליקציה כשערכתם את פרטי האפליקציה בשלב 6 שלמעלה, היא תופיע באתר chromecast.com/apps אחרי הפרסום.

כדי לפרסם את האפליקציה:

  1. במסוף המפתחים של Google Cast SDK, בדף Overview או בדף Applications, לוחצים על Publish ליד האפליקציה שרוצים לפרסם.

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

  2. אפשר ללחוץ על עריכה כדי לחזור ולעדכן את הפרטים.

  3. כשמוכנים לפרסם את האפליקציה, לוחצים על פרסום.

נתונים סטטיסטיים

ב-Google Cast SDK Developer Console אפשר לעקוב אחרי הביצועים של האפליקציה. בכל אפליקציה שפורסמה בדף 'אפליקציות' או בדף 'סקירה כללית', אפשר לראות נתוני ביצועים בלחיצה על הצגה בעמודה סטטיסטיקה.

מוצג המידע הבא:

  • מספר מכשירי Cast שהפעילו את האפליקציה
  • מספר הסשנים שהופעלו
  • משך ההפעלה הממוצע של מדיה (בדקות) בכל סשן

אם הפלטפורמה אחר מופיעה בנתונים הסטטיסטיים, זה אומר שהשולח לא ציין את הפלטפורמה שלו. לדוגמה, אם שולח עם גרסה ישנה של iOS לא עדכן את המכשיר.

מכשירים

כברירת מחדל, מכשירי Google Cast (כמו Chromecast או מכשיר Android TV) לא מופעלים לפיתוח ולבדיקה. כדי להפוך את המכשיר למכשיר פיתוח ולקבל גישה לאפליקציית Web Receiver שלא פורסמה במהלך הפיתוח, צריך לרשום את המכשיר באפליקציה. הרישום גם מאפשר גישה ל-Receiver מחלון דפדפן מרוחק לצורך ניפוי באגים (ראו ניפוי באגים).

כדי לרשום את מכשיר Google Cast:

  1. מגדירים את מכשיר Google Cast ומחברים אותו לאותה רשת Wi-Fi שאליה מחובר המחשב.

    מידע נוסף מופיע בהוראות בנושא הגדרת מכשיר Cast.

  2. במחשב, פותחים דפדפן אינטרנט שתומך ב-Cast.

  3. נכנסים אל Google Cast SDK Developer Console.

  4. מאתרים את המספר הסידורי של המכשיר שרוצים לרשום.

  5. בדף הסקירה הכללית או בדף המכשירים, לוחצים על הוספת מכשיר חדש.

  6. מזינים את המספר הסידורי של המכשיר.

  7. מזינים תיאור ולוחצים על אישור.

    זהו רק שם ידידותי למכשיר (הוא לא צריך להיות זהה לשם שנתתם למכשיר במהלך הגדרת המשתמש).

  8. מחכים רבע שעה לפני שממשיכים.

    אחרי שההרשמה תושלם, הסטטוס של המכשיר יהיה 'מוכן לבדיקה'.

  9. מפעילים מחדש את מכשיר Cast: מנתקים את כבל החשמל או ה-USB מהמכשיר ואז מחברים אותו מחדש.

איך מוצאים את המספר הסידורי של המכשיר

כדי למצוא את המספר הסידורי של מכשיר כלשהו, אפשר להפעיל Cast של דף Cast Developer Console אל המכשיר:

  1. לוחצים על הכפתור להפעלת Cast (כמו כשמפעילים Cast של הדף).

    ההנחיה מציגה את האפשרות הפעלת Cast לכרטיסייה ורשימה של המכשירים הזמינים.

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

    • במכשירי תצוגה, המספר הסידורי מוצג על מסך הטלוויזיה ומוקרא ברמקולים של הטלוויזיה (כדי להבחין בין 0 ל-O).
    • במכשירי אודיו, המספר הסידורי מושמע ברמקול שאליו מתבצעת ההפעלה ל-Chromecast.

מספר סידורי של תוכנת Android TV

למכשירי Android TV (ATV) יש כמה מספרים סידוריים שמשויכים אליהם. אפשר לקבל את המספר הסידורי של התוכנה (Cast) באחת משתי דרכים: על ידי הפעלת Cast של הדף Cast Developer Console במכשיר ATV, כמו שמתואר למעלה, או על ידי העברת מכשיר ATV למצב פיתוח וחיפוש המספר הסידורי של התוכנה בהגדרות Cast.

כדי להעביר את מכשיר ATV למצב פיתוח, עוברים אל הגדרות > מערכת > מידע כללי > גרסת Android TV OS ולוחצים על הגרסה כמה פעמים עד שהמכשיר מודיע לכם שאתם במצב פיתוח. כדי למצוא את המספר הסידורי פעם אחת במצב פיתוח, עוברים אל הגדרות > העדפות מכשיר > Google Cast או אל הגדרות > מערכת > Cast, בהתאם לדגם של ATV, והמספר הסידורי של התוכנה יוצג.

שימו לב: כשמבצעים איפוס להגדרות המקוריות במכשיר ATV, המספר הסידורי של התוכנה משתנה. אחרי איפוס להגדרות המקוריות, פועלים לפי השלבים שלמעלה כדי למצוא את המספר הסידורי של התוכנה ולרשום מחדש את המספר הסידורי החדש של התוכנה של המכשיר ב-Cast Developer Console.

בעיות בחשבון

אני רוצה לבטל את הרישום שלי ב-Google Cast Developer Console

אי אפשר לקבל החזר כספי על עמלת הרישום של חשבון הפיתוח בסך 5$.

אין לי יותר גישה אל Google Cast Developer Console

אם קיבלת מאיתנו בעבר אימייל שבו צוין שחשבון הפיתוח שלך הושעה עקב הפרות מרובות של התנאים וההגבלות או של מדיניות התוכן, אפשר להשיב לאימייל הזה אם דרוש לך הסבר נוסף.

האפליקציה שלי הוסרה מ-Google Cast

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

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

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

אני רוצה לשנות את כתובת האימייל שמשויכת לחשבון שלי

אי אפשר לשנות את כתובת האימייל שמשויכת לחשבון Google Cast למפתחים. אם אתם עובדים בארגון, מומלץ להשתמש בכתובת אימייל של צוות כדי להימנע מבעיות גישה בעתיד.

יש לי בעיה אחרת

מידע נוסף זמין בדף התמיכה של Cast SDK.