צריך לרשום את האפליקציה אם אתם משתמשים ב-Styled Media Receiver או יוצרים Custom Receiver. אחרי שתירשמו את האפליקציה, תקבלו מזהה אפליקציה. האפליקציה השולחת משתמשת במזהה הזה כדי לבצע קריאות ל-API, למשל כדי להפעיל אפליקציית Web Receiver.
אם אתם משתמשים ב-Default Media Receiver, אין צורך לרשום את האפליקציה. ב-Default Media Receiver אי אפשר לספק עיצוב לממשק המשתמש של נגן המדיה, והוא משתמש בערך קבוע שסופק בתור מזהה האפליקציה.
בנוסף, לפני הפרסום, צריך לרשום את מכשיר Google Cast כדי שיהיה לו גישה לאפליקציית Web Receiver. אחרי שתפרסמו את אפליקציית המקלט, היא תהיה זמינה לכל מכשירי Google Cast.
אפליקציות
רישום האפליקציה מאפשר לכם לבדוק אותה במכשיר Cast הרשום לפני פרסום האפליקציה. פרסום האפליקציה יהפוך אותה לזמינה לכל מכשירי ה-Cast.
רישום האפליקציה
כדי לקבל מזהה אפליקציה שמשמש בקריאות ל-API מאפליקציית השולח, צריך לרשום חיישן מדיה עם עיצוב או חיישן מותאם אישית.
כדי לרשום את אפליקציית ה-Cast:
- נכנסים למסוף הפיתוח של Google Cast SDK.
- בדף Overview (סקירה כללית) או בדף Applications (אפליקציות), לוחצים על Add New Application (הוספת אפליקציה חדשה).
בוחרים את סוג אפליקציית Web Receiver שבה רוצים להשתמש:
Custom Receiver
בוחרים באפשרות הזו אם האפליקציה שלכם דורשת רכיבים של ממשק המשתמש או דפוסי אינטראקציה שלא מסופקים על ידי Styled Media Receiver. יכול להיות שתצטרכו לבחור באפשרות 'מקלט בהתאמה אישית' גם אם סוג התוכן שלכם לא מופיע בסוגי המדיה הנתמכים של Styled Media Receiver.
חשוב לזכור שבאפשרות הזו צריך לפתח אפליקציית אינטרנט מלאה לאפליקציית Web Receiver.
פרטים נוספים זמינים במאמר אפליקציית מקלט בהתאמה אישית.
Styled Media Receiver
בוחרים באפשרות הזו אם האפליקציה שלכם משדרת תוכן וידאו או אודיו באמצעות אחד מסוגי המדיה הנתמכים, ואתם רוצים לספק ממשק משתמש בטלוויזיה שמשתמש בממשק המשתמש של נגן המדיה שמוגדר כברירת מחדל או בקבוצה של סגנונות מותאמים אישית מעל ממשק המשתמש של נגן המדיה שמוגדר כברירת מחדל.
הסגנונות המותאמים אישית שאתם יכולים לספק מאפשרים לכם להגדיר את המראה של רכיבים שונים בממשק המשתמש של הנגן (כמו מסך הפתיחה וסרגל ההתקדמות) פשוט על ידי שליחת קובץ CSS – אין צורך לפתח אפליקציית מקלט.
פרטים נוספים זמינים במאמר Styled Media Receiver.
ממלאים את הפרטים של אפליקציית Web Receiver:
בשדה Name, מזינים את שם האפליקציה.
זהו שם האפליקציה כפי שהוא מופיע בזמן טעינת מקלט האינטרנט, או במצב מנוחה אם אתם משתמשים במקלט המדיה המעוצב. אם משתמשים ב-Custom Receiver, הערך בשדה הזה הוא ערך ברירת המחדל למצב האפליקציה, אם הוא לא מוגדר באמצעות השיטה
setApplicationState.מציינים את המראה של אפליקציית Web Receiver:
בנמען בהתאמה אישית, מציינים את כתובת ה-URL של האפליקציה בשדה כתובת URL.
מזינים כתובת URL שהתקן Google Cast צריך לבקש כשהאפליקציה Web Receiver נטענת. במהלך הפיתוח, אפשר להשתמש ב-HTTP בכתובת ה-URL, אבל כשמפרסמים את האפליקציה צריך להשתמש ב-HTTPS. כתובת ה-URL יכולה להיות של דף HTML או של סוג קובץ אחר שאפשר לגשת אליו מדפדפן אינטרנט. מותר למכשיר Web Receiver להיות בכתובת IP פנימית (רשומה ב-NAT), אבל לא ב-localhost, כי הוא רק לעתים רחוקות דומיין ברמה העליונה. אמנם חובה להציג את אפליקציית Web Receiver באמצעות SSL (HTTPS) כשמפרסמים אותה, אבל התוכן שנטען באפליקציית Web Receiver יכול להופיע באמצעות HTTP.
במקלט מדיה עם עיצוב, בשדה כתובת ה-URL של העיצוב, מציינים את כתובת ה-URL של גיליון הסגנונות.
יש לספק כתובת URL מסוג HTTPS שמפנה לקובץ ה-CSS שנמצא באתר שלכם. כדי להשתמש בסגנונות ברירת המחדל, משאירים את השדה ריק. תמיד תוכלו לערוך את הנתונים האלה מאוחר יותר, אם תרצו לספק או לעדכן סגנונות מותאמים אישית.
מסמנים את התיבה Supports relay casting (יש תמיכה בהעברת העברה) או משאירים אותה לא מסומנת.
העברה (relay) של העברה (cast) מאפשרת למכשיר המקבל באינטרנט לתמוך בהעברה (cast) משולחים שלא מחוברים לאותה רשת Wi-Fi כמו המכשיר המקבל. כדי להשבית את העברת ההעברה (relay) של השידור בנגן, מבטלים את הסימון בתיבה הזו.
מסמנים את התיבה Supports casting to audio-only devices (יש תמיכה בהעברה (cast) למכשירים עם אודיו בלבד) או משאירים אותה לא מסומנת.
כדי לאפשר לאפליקציה לזהות מכשירים של Google Cast לאודיו, מסמנים את התיבה הזו. כדי להשבית את התמיכה במכשירים עם אודיו בלבד, מבטלים את הסימון בתיבה הזו. מידע נוסף זמין במאמר מכשירי אודיו.
לוחצים על שמירה.
מוצגים פרטי הרישום, כולל מזהה הבקשה, השם, הסוג והסטטוס. חשוב לזכור את מזהה האפליקציה, כי תצטרכו לציין אותו בקריאות ל-Cast API של האפליקציה.
לוחצים על Done (סיום) כדי לחזור לדף Applications (אפליקציות).
עריכת פרטי האפליקציה
כדי לפרסם את האפליקציה, תצטרכו לספק מידע נוסף. אפשר גם לעדכן את המידע שסיפקתם על האפליקציה במהלך ההרשמה.
כדי לערוך את פרטי האפליקציה:
- במסוף הפיתוח של Google Cast SDK, בדף Overview (סקירה כללית) או בדף Applications (אפליקציות), לוחצים על Application ID (מזהה האפליקציה) או על Edit (עריכה) של האפליקציה שרוצים לערוך.
- בשדה Name מעדכנים את השם שסיפקתם כשרשמתם את האפליקציה.
- באפליקציות של מקלט בהתאמה אישית, מעדכנים את המיקום של אפליקציית מקלט האינטרנט שרשמת בשדה כתובת URL.
- באפליקציות של Styled Receiver, בשדה Skin URL מעדכנים את המיקום של גיליון הסגנונות של האפליקציה.
מסמנים את התיבה Supports relay casting (יש תמיכה בהעברת העברה) או משאירים אותה לא מסומנת.
העברה ב-relay מאפשרת למכשיר המקבל באינטרנט לתמוך בהעברה (cast) משולחים שלא מחוברים לאותה רשת Wi-Fi כמו המכשיר המקבל. כדי להשבית את העברת ההעברה (relay) למכשיר המקבל, מבטלים את הסימון בתיבה הזו.
מסמנים את התיבה Supports casting to audio-only devices (יש תמיכה בהעברת Cast למכשירים עם אודיו בלבד) או משאירים אותה לא מסומנת.
כדי לאפשר לאפליקציה לזהות מכשירים של Google Cast לאודיו, מסמנים את התיבה הזו. כדי להשבית את התמיכה במכשירים עם אודיו בלבד, מבטלים את הסימון בתיבה הזו. מידע נוסף זמין בקטע מכשירי אודיו.
בקטע פרטי השולח, עליכם לספק את הפרטים הבאים לכל פלטפורמה שהאפליקציה תומכת בה:
Android:
- השם המלא של חבילת האפליקציה.
iOS:
- מזהה iTunes ומזהה החבילה הנדרשים על ידי Apple.
- ה-URI להפעלת האפליקציה, באמצעות ה-URI שבו אפליקציית Google Home משתמשת כדי להפעיל את האפליקציה. מידע נוסף על הפורמט הנדרש של ה-URI זמין במאמר שימוש בסכימות של כתובות URL כדי לתקשר עם אפליקציות.
אינטרנט:
- כתובת ה-URL של האתר של האפליקציה.
בקטע פרטי כרטיס, בוחרים אם להציג את האפליקציה בנכסי Google כמו chromecast.com/apps.
בתפריט הנפתח קטגוריה, בוחרים את הקטגוריה שמתארת בצורה הכי מדויקת את האפליקציה.
הערה: האפליקציה חייבת לתמוך בסוגי המדיה שמפורטים כאן, וגם בסוגי המדיה שנגזרים מהגדרות אחרות. לדוגמה, אם האפליקציה תומכת ב-Google Cast לאודיו, ובוחרים כאן באפשרות 'טלוויזיה וסרטים', האפליקציה צריכה לתמוך במכשירים עם אודיו בלבד כפי שמתואר בקטע מכשירי אודיו, וגם לעמוד בדרישות להפעלת וידאו.
כדי לציין את המדינות שבהן האפליקציה זמינה, בוחרים בלחצן הבחירה כל המדינות או רק במדינות שנבחרו. אם מציינים מדינות, מסמנים את התיבות של המדינות האלה ברשימה שמופיעה.
בשדה Title, מזינים שם תיאורי לאפליקציה.
אפשר להזין עד 50 תווים. לדוגמה, YouTube.
בשדה Description מזינים תיאור של האפליקציה.
אפשר להזין עד 80 תווים. לדוגמה: "עכשיו אפשר לצפות בערוצי YouTube המועדפים עליך במסך הכי טוב בבית".
בקטע Graphics, לוחצים על סימן הפלוס כדי להעלות את קובץ התמונה של הסמל של האפליקציה.
התמונה חייבת להיות בגודל 512x512 פיקסלים, ויכול להיות לה רקע שקוף.
בקטע הוספת תרגומים משלכם, אם רוצים לספק תרגומים לשדות שם ותיאור, בוחרים את השפה בתפריט הנפתח, לוחצים על הוספה ומזינים את הטקסט המתורגם בתיבת הדו-שיח שמופיעה. אפשר גם להעלות תמונה לסמל שספציפי לתרגום הזה.
כשמסיימים לעדכן את פרטי האפליקציה, לוחצים על שמירה.
פרסום האפליקציה
פרסום האפליקציה יאפשר לכם להפוך אותה לזמינה לכל מכשירי Cast ברחבי העולם. בנוסף, המערכת יוצרת כרטיס לאפליקציה בנכסי Google, כמו אתר הכרטיסים chromecast.com/apps, שבו המשתמשים יכולים לגלות את האפליקציה שלכם ולהוריד אותה. אם בחרתם להוסיף את האפליקציה לכרטיס כשערכתם את פרטי האפליקציה בשלב 6 שלמעלה, היא תופיע בכתובת chromecast.com/apps אחרי שהיא תפורסם.
כדי לפרסם את האפליקציה:
במסוף הפיתוח של Google Cast SDK, בדף Overview או בדף Applications, לוחצים על Publish לצד האפליקציה שרוצים לפרסם.
אם פרטי האפליקציה מלאים, יופיע מסך תצוגה מקדימה עם פרטי האפליקציה שהזנתם בקטע עריכת פרטי האפליקציה. אם לא, תופיע הודעה עם המידע שצריך לספק.
אפשר ללחוץ על עריכה כדי לחזור ולעדכן את הפרטים.
כשמוכנים לפרסם את האפליקציה, לוחצים על פרסום.
נתונים סטטיסטיים
Google Cast SDK Developer Console עוקב אחרי ביצועי האפליקציה. כדי לראות את נתוני הביצועים של כל אפליקציה שפורסמה בדף 'אפליקציות' או בדף 'סקירה כללית', לוחצים על הצגה בעמודה נתונים סטטיסטיים.
מוצגים הפרטים הבאים:
- מספר מקלטי Cast שהפעילו את האפליקציה
- מספר הסשנים שהופעלו
- משך ההפעלה הממוצע של מדיה (בדקות) בכל סשן
אם מופיעה בפלטפורמה אחר בנתונים הסטטיסטיים, המשמעות היא שהשולח לא ציין את הפלטפורמה שלו. לדוגמה, אם שולח iOS ישן יותר לא עודכן.
מכשירים
כברירת מחדל, מכשירי Google Cast (כמו Chromecast או מכשיר Android TV) לא מופעלים לפיתוח ולבדיקה. כדי להפוך את המכשיר למכשיר פיתוח ולקבל גישה לאפליקציית Web Receiver שעדיין לא פורסמה במהלך הפיתוח, צריך לרשום את המכשיר באפליקציה. הרישום מאפשר גם לגשת למכשיר מחלון דפדפן מרוחק לניפוי באגים (מידע נוסף זמין במאמר ניפוי באגים).
כדי לרשום את מכשיר Google Cast:
מגדירים את מכשיר Google Cast ומחברים אותו לאותה רשת Wi-Fi שאליה מחובר המחשב.
למידע נוסף, עיינו בהוראות להגדרת מכשיר העברה.
פותחים במחשב דפדפן אינטרנט שתומך ב-Cast.
נכנסים למסוף הפיתוח של Google Cast SDK.
מאתרים את המספר הסידורי של המכשיר שרוצים לרשום.
בדף 'סקירה כללית' או בדף 'מכשירים', לוחצים על הוספת מכשיר חדש.
מזינים את המספר הסידורי של המכשיר.
מזינים תיאור ולוחצים על אישור.
זהו פשוט שם ידידותי למכשיר (הוא לא חייב להיות זהה לשם שהקצית למכשיר במהלך הגדרת המשתמש).
צריך להמתין חמש עשרה דקות לפני שממשיכים.
בסיום ההרשמה, הסטטוס של המכשיר יהיה 'מוכן לבדיקה'.
מפעילים מחדש את מכשיר ההעברה (cast): מנתקים את כבל החשמל או כבל ה-USB מהמכשיר ומחברים אותו מחדש.
איך למצוא את המספר הסידורי של המכשיר
כדי למצוא את המספר הסידורי של כל מכשיר, אפשר להעביר (cast) את הדף של Cast Developer Console למכשיר:
לוחצים על הלחצן להעברה (cast) (כאילו רוצים להעביר את הדף הזה).
בהודעה מופיעה האפשרות כרטיסיית Cast, ומפורטים בה המכשירים הזמינים.
בתפריט הנפתח, בוחרים את המכשיר שרוצים לקבל את המספר הסידורי שלו.
- במכשירי תצוגה, המספר הסידורי מוצג במסך הטלוויזיה ומוקרא ברמקול הטלוויזיה (כדי להבדיל בין 0 ל-O).
- במכשירי אודיו, המספר הסידורי יוקרא בקול ברמקול שאליו מתבצע ההעברה.
המספר הסידורי של תוכנת Android TV
למכשירי Android TV (ATV) יש מספר מספרים סדוריים שמשויכים אליהם. אפשר לקבל את המספר הסידורי של התוכנה (Cast) על ידי העברה (cast) של הדף של Cast Developer Console למכשיר ה-ATV, כפי שמתואר למעלה, או על ידי הכנסת מכשיר ה-ATV למצב פיתוח ומציאת המספר הסידורי של התוכנה בהגדרות Cast.
כדי להעביר את מכשיר ה-ATV למצב פיתוח, עוברים אל הגדרות > מערכת > מידע כללי > Android TV OS build ולוחצים על build כמה פעמים עד שמופיעה הודעה במכשיר על מעבר למצב פיתוח. כדי למצוא את המספר הסידורי אחרי שמפעילים את מצב הפיתוח, עוברים אל הגדרות > העדפות המכשיר > Chromecast מובנה או אל הגדרות > מערכת > העברה (cast), בהתאם לדגם ה-ATV, והמספר הסידורי של התוכנה יופיע.
חשוב לדעת: כשמכשיר ATV מאופס להגדרות המקוריות, המספר הסידורי של התוכנה משתנה. אחרי איפוס להגדרות המקוריות, פועלים לפי השלבים שלמעלה כדי למצוא את המספר הסידורי של התוכנה ולרשום מחדש את המספר הסידורי החדש של התוכנה במכשיר באמצעות מסוף הפיתוח של Cast.
בעיות בחשבון
אני רוצה לבטל את הרישום שלי ב-Google Cast Developer Console
לא ניתן לקבל החזר כספי על דמי הרישום של חשבון הפיתוח בסך 5$.
אין לי יותר גישה ל-Google Cast Developer Console
אם קיבלת בעבר אימייל שלנו עם הודעה על כך שחשבון הפיתוח שלך הושעה עקב מספר הפרות של התנאים וההגבלות או של מדיניות התוכן שלנו, אפשר להשיב לאימייל הזה אם דרושה לך הבהרה נוספת.
האפליקציה שלי הוסרה מ-Google Cast
אפליקציות שהוסרו נחשבות כפסילות במסגרת הבדיקה של חשבון הפיתוח שלכם. הפרות מרובות או הפרות חמורות ביותר של המדיניות עשויות להוביל לסגירה של חשבון הפיתוח שלכם.
אם האפליקציה תוסר, המשתמשים לא יוכלו לראות אותה או לגשת אליה. אם פרטי הכניסה שלך כמפתח עדיין תקינים ב-Google Cast ואופי האפליקציה מאפשר זאת, יש לך אפשרות לבצע תיקונים ולפרסם מכונה חדשה של האפליקציה שעומדת בדרישות.
אין לפרסם מחדש אפליקציה שהוסרה עד שמתקנים את הפרת המדיניות.
אני רוצה לשנות את כתובת האימייל שמשויכת לחשבון שלי
אי אפשר לשנות את כתובת האימייל שמשויכת לחשבון הפיתוח שלכם ב-Google Cast. אם אתם עובדים בארגון, מומלץ להשתמש בכתובת אימייל של צוות כדי למנוע בעיות גישה בעתיד.
יש לי בעיה אחרת
אפשר לעיין בדף התמיכה של Cast SDK.