אם אתם משתמשים במקלט מדיה מסוגננת או יוצרים מקלט בהתאמה אישית, עליכם לרשום את האפליקציה. אחרי שרושמים את האפליקציה, מקבלים מזהה אפליקציה שמשמש את אפליקציית השולח לביצוע קריאות ל-API, למשל להפעלת אפליקציה של Web תגובות.
אם אתם משתמשים ב-Default Media Recordingr, אין צורך לרשום את האפליקציה. ברירת המחדל של מקלט המדיה לא מאפשרת לכם להגדיר עיצוב כלשהו לממשק המשתמש של נגן המדיה, ומשתמשת בקבוע שצוין כמזהה האפליקציה.
בנוסף, עליכם לרשום את מכשיר ה-Google Cast כדי שתהיה לו גישה לאפליקציית Web Acceptr לפני הפרסום שלה. לאחר פרסום אפליקציית המקבל, היא תהיה זמינה לכל מכשירי Google Cast.
אפליקציות
רישום האפליקציה מאפשר לבדוק אותה במכשיר Cast הרשום לפני פרסום האפליקציה. פרסום האפליקציה הופך אותה לזמינה לכל מכשירי Cast.
רישום הבקשה
עליכם לרשום Styled Media תוצאהr או מקלט מותאם אישית כדי לקבל מזהה אפליקציה שמשמש לקריאות API מהאפליקציה של השולח.
כדי לרשום את האפליקציה להפעלת Cast:
- נכנסים אל Google Cast SDK Console.
- בדף Overview או בדף Applications לוחצים על Add New Application.
צריך לבחור את סוג האפליקציה של מכשיר האינטרנט שבו רוצים להשתמש:
מקלט מותאם אישית
כדאי לבחור באפשרות הזו אם לאפליקציה נדרשים רכיבים בממשק המשתמש או דפוסי אינטראקציה שלא סופקו על ידי Styled Media Streamingr. יכול להיות שתצטרכו לבחור גם במקלט מותאם אישית אם סוג התוכן שלכם לא רשום כאחד מסוגי המדיה הנתמכים של מקלט מדיה מסוגננת.
שימו לב שהאפשרות הזו מחייבת פיתוח של אפליקציית אינטרנט מלאה עבור אפליקציית Web Acceptr.
לפרטים נוספים, קראו את המאמר אפליקציית מקלט מותאמת אישית.
מקלט מדיה מסוגננת
צריך לבחור באפשרות הזו אם האפליקציה משדרת תוכן וידאו או אודיו באחד מסוגי המדיה הנתמכים, ואתם רוצים לספק ממשק משתמש בטלוויזיה שמשתמש בממשק המשתמש של נגן המדיה שמוגדר כברירת מחדל או בקבוצה של סגנונות מותאמים אישית על גבי ממשק המשתמש המוגדר כברירת מחדל עבור נגן המדיה.
הסגנונות המותאמים אישית שתוכלו לספק מאפשרים להגדיר את המראה של רכיבים שונים בממשק המשתמש של הנגן (כמו מסך הפתיחה וסרגל ההתקדמות) באמצעות שליחת קובץ CSS – אין צורך ליצור אפליקציית מקלט.
לפרטים נוספים, אפשר לקרוא את המאמר מקלט מדיה סגנון.
ממלאים את הפרטים של אפליקציית WebReceiver:
בשדה שם, מזינים את שם האפליקציה.
זהו שם האפליקציה כפי שהוא מופיע כאשר מקלט האינטרנט נטען או במצב לא פעיל אם אתם משתמשים במקלט מדיה סגנון. אם אתם משתמשים במקלט מותאם אישית, הערך בשדה הזה הוא ערך ברירת המחדל למצב האפליקציה, אם הוא לא מוגדר באמצעות השיטה
setApplicationState.ציון המראה של האפליקציה של מקלט האינטרנט:
עבור מקלט מותאם אישית, מציינים את כתובת ה-URL של האפליקציה בשדה כתובת URL.
מזינים את כתובת ה-URL שמכשיר Google Cast צריך לבקש כשטוענים את האפליקציה Web Acceptr. במהלך הפיתוח, כתובת ה-URL יכולה להשתמש ב-HTTP, אבל כשהאפליקציה מתפרסמת, היא חייבת להשתמש ב-HTTPS. כתובת ה-URL יכולה להיות של דף HTML או של סוג קובץ אחר שאפשר לגשת אליו מדפדפן אינטרנט. זה בסדר שמקלט האינטרנט יהיה בכתובת IP פנימית (שרשומה ב-NAT), אבל לא ב-localhost, כי לעיתים נדירות זהו דומיין ברמה העליונה. למרות שאפליקציית מקלט האינטרנט חייבת להיות מוצגת באמצעות SSL (HTTPS) בעת הפרסום, התוכן שנטען באפליקציה של מקלט האינטרנט עשוי להיות מוצג באמצעות HTTP.
ב-Styled Media Gettingr, מציינים את כתובת ה-URL של גיליון הסגנונות בשדה Skin URL.
מספקים כתובת URL מסוג HTTPS שמפנה לקובץ ה-CSS שנמצא באתר שלכם. כדי להשתמש בסגנונות ברירת המחדל, משאירים את השדה ריק. תמיד תוכלו לערוך אותו מאוחר יותר אם תרצו לספק או לעדכן את הסגנונות המותאמים אישית שלכם.
מסמנים את התיבה תמיכה בהעברה באמצעות שרת ממסר או לא מסמנים אותה.
הפעלת Cast דרך שרת הממסר מאפשרת למקלט האינטרנט לתמוך בהעברה (cast) משולחים שלא מחוברים לאותה רשת Wi-Fi שאליה מחובר המכשיר. כדי להשבית את ההעברה מהממסר למקלט, מבטלים את הסימון בתיבה הזו.
מסמנים את התיבה Supports Cast to Audio only devices (תמיכה בהעברה למכשירי אודיו בלבד) או לא מסמנים את התיבה.
כדי לאפשר לאפליקציה לגלות את Google Cast למכשירי אודיו, מסמנים את התיבה. כדי להשבית את התמיכה במכשירים עם אודיו בלבד, צריך לבטל את הסימון של התיבה. מידע נוסף זמין במאמר התקני אודיו.
לוחצים על שמירה.
יוצגו פרטי הרישום, כולל מזהה האפליקציה, השם, הסוג והסטטוס. רשמו לעצמכם את מזהה האפליקציה, כי אתם תספקו אותו בקריאות של האפליקציה ל-Cast API.
לוחצים על Done כדי לחזור לדף Applications.
עריכת פרטי האפליקציה
לפני פרסום האפליקציה, צריך לספק מידע נוסף. אפשר גם לעדכן את המידע שסיפקתם לגבי הבקשה במהלך ההרשמה.
כדי לערוך את פרטי האפליקציה:
- ב-Google Cast SDK Developer Console, בדף Overview או בדף Applications, לוחצים על Application ID או על Edit בשביל האפליקציה שרוצים לערוך.
- בשדה Name, מעדכנים את השם שסיפקתם כשרשמתם את האפליקציה.
- באפליקציות של מקלט מותאם אישית, מעדכנים בשדה כתובת URL את המיקום של האפליקציה שרשמתם את האפליקציה Web Acceptr.
- באפליקציות StyledRecipient, מעדכנים את המיקום של גיליון הסגנונות של האפליקציה בשדה Skin URL.
מסמנים את התיבה תמיכה בהעברה באמצעות שרת ממסר או לא מסמנים אותה.
הפעלת Cast דרך שרת הממסר מאפשרת למקלט האינטרנט לתמוך בהעברה (cast) משולחים שלא מחוברים לאותה רשת Wi-Fi שאליה מחובר המכשיר. כדי להשבית את ההעברה מהממסר למקלט, מבטלים את סימון התיבה הזו.
מסמנים את התיבה תמיכה בהעברה למכשירים עם אודיו בלבד או לא מסמנים אותה.
כדי לאפשר לאפליקציה לגלות את Google Cast למכשירי אודיו, יש לסמן את התיבה הזו. כדי להשבית את התמיכה במכשירים עם אודיו בלבד, צריך לבטל את הסימון בתיבה. למידע נוסף, ראו התקני אודיו.
בקטע Sender Details, מספקים את הפרטים הבאים לכל פלטפורמה שהאפליקציה תומכת בה:
Android:
- השם המוגדר במלואו של חבילת האפליקציה שלכם.
iOS:
- את iTunes ID ואת מזהה החבילה הנדרשים על ידי Apple.
- ה-URI של הפעלת האפליקציה, באמצעות ה-URI שבו משתמשת אפליקציית Google Home כדי להפעיל את האפליקציה. למידע נוסף על פורמט ה-URI הנדרש, ראו שימוש בסכימות של כתובות URL לתקשורת עם אפליקציות.
אתר:
- כתובת האתר של האפליקציה.
בקטע Listing Details, בוחרים אם להציג את האפליקציה במוצרי Google כמו chromecast.com/apps..
בתפריט הנפתח Category, בוחרים את הקטגוריה שמתארת בצורה הטובה ביותר את האפליקציה שלכם.
הערה: האפליקציה חייבת לתמוך בסוגי המדיה שמתוארים כאן, וגם בסוגי המדיה שמשתמעים מהגדרות אחרות. לדוגמה, אם האפליקציה תומכת ב-Google Cast לאודיו ובחרת כאן 'טלוויזיה וסרטים', האפליקציה צריכה לתמוך במכשירים עם אודיו בלבד כפי שמתואר במאמר התקני אודיו, וכן בתנאים להפעלת סרטונים.
כדי לתאר את המדינות שבהן האפליקציה זמינה, לוחצים על לחצן הבחירה All countries או Only in selected countries. אם אתם מציינים מדינות, מסמנים את התיבות של המדינות האלה ברשימה שמופיעה.
בשדה Title מזינים כותרת שמתארת את האפליקציה.
אפשר להזין עד 50 תווים. לדוגמה, "YouTube".
בשדה תיאור מזינים תיאור של האפליקציה.
אפשר להזין עד 80 תווים. לדוגמה, "תיהנו מערוצי YouTube האהובים עליכם במסך הטוב ביותר בבית".
בקטע graphic, לוחצים על סמל הפלוס כדי להעלות את תמונת הסמל של האפליקציה.
התמונה צריכה להיות בגודל 512 X 512 פיקסלים, והרקע שלה יכול להיות שקוף.
כדי להוסיף תרגומים לשדות Title ו-Description בקטע Add Your Own Translations, בוחרים את השפה מהתפריט הנפתח, לוחצים על Add ומזינים את הטקסט המתורגם בתיבת הדו-שיח שמופיעה. אפשר גם להעלות תמונה עבור הסמל הספציפי לתרגום.
אחרי שמסיימים לעדכן את פרטי הבקשה, לוחצים על שמירה.
פרסום האפליקציה
פרסום האפליקציה הופך את האפליקציה לזמינה לכל מכשירי Cast ברחבי העולם. הוא גם יוצר רישום של האפליקציה במוצרי Google, כמו אתר הרישום chromecast.com/apps, שבו המשתמשים יכולים לגלות ולהוריד את האפליקציה. אם בחרתם לרשום את האפליקציה בשלב 6 שלמעלה, היא תופיע ב-chromecast.com/apps לאחר הפרסום.
כדי לפרסם את האפליקציה:
ב-Google Cast SDK Developer Console, בדף Overview או בדף Applications, לוחצים על Publish (פרסום) של האפליקציה שרוצים לפרסם.
אם פרטי האפליקציה מלאים, יופיע מסך תצוגה מקדימה עם פרטי האפליקציה שהזנתם ב-Edit application. אם לא, תופיע הודעה שמצטטת את המידע שאתם צריכים לספק.
אפשר ללחוץ על עריכה כדי לחזור ולעדכן פרטים.
כשמוכנים לפרסם את האפליקציה, לוחצים על פרסום.
נתונים סטטיסטיים
Google Cast SDK Developer Console עוקב אחר ביצועי האפליקציה. עבור כל אפליקציה שפורסמה בדף 'יישומים' או 'סקירה כללית', אפשר לראות נתוני ביצועים על ידי לחיצה על הצג בעמודה נתונים סטטיסטיים.
אלה הפרטים שמופיעים בדוח:
- מספר מקלטי Cast שהפעילו את האפליקציה
- מספר הסשנים שהופעלו
- זמן הפעלה ממוצע של מדיה (בדקות) בכל סשן
אם פלטפורמה אחרת מופיעה בנתונים הסטטיסטיים, סימן שהשולח לא ציין את הפלטפורמה שלה. לדוגמה, אם לא עודכן שולח ישן יותר של iOS.
מכשירים
כברירת מחדל, מכשירי Google Cast (כמו Chromecast או מכשיר Android TV) לא מופעלים לצורכי פיתוח ובדיקה. כדי להפוך את המכשיר למכשיר פיתוח ולקבל גישה לאפליקציה שלא פורסמה במקלט האינטרנט במהלך הפיתוח, צריך לרשום את המכשיר באפליקציה. הרישום מאפשר גם לגשת למקלט מחלון דפדפן מרוחק לצורך ניפוי באגים (ראו ניפוי באגים).
כדי לרשום את מכשיר Google Cast:
מגדירים את מכשיר Google Cast ומחברים אותו לאותה רשת Wi-Fi שאליה מחובר המחשב.
מידע נוסף זמין בהוראות של הגדרת מכשיר Cast.
במחשב, פותחים דפדפן אינטרנט שתומך ב-Cast.
נכנסים אל Google Cast SDK Console.
מוצאים את המספר הסידורי של המכשיר שרוצים לרשום.
בדף הסקירה הכללית או בדף 'מכשירים', לוחצים על הוספת מכשיר חדש.
מזינים את המספר הסידורי של המכשיר.
מזינים תיאור ולוחצים על אישור.
זהו רק שם ידידותי למכשיר שלך (הוא לא צריך להיות זהה לשם שנתת למכשיר במהלך הגדרת המשתמש).
צריך להמתין 15 דקות לפני שממשיכים.
בסיום ההרשמה, בסטטוס של המכשיר יהיה כתוב 'מוכן לבדיקה'.
מפעילים מחדש את מכשיר ה-Cast: מנתקים את כבל החשמל או כבל ה-USB מהמכשיר, ומחברים אותו מחדש.
איתור המספר הסידורי של המכשיר
כדי למצוא את המספר הסידורי של מכשיר כלשהו, אפשר להפעיל Cast של תוכן הדף מ-Cast Console למכשיר:
לוחצים על הלחצן להפעלת Cast (כאילו מעבירים את הדף הזה).
בהודעה תוצג הכרטיסייה 'העברה' עם רשימה של המכשירים הזמינים.
בתפריט הנפתח, בוחרים את המכשיר שעבורו רוצים לקבל את המספר הסידורי.
- במכשירים עם מסך, המספר הסידורי מוצג במסך הטלוויזיה ומוקרא ברמקולים של הטלוויזיה (כדי להבחין בין הספרות 0 ל-O).
- בהתקני אודיו, המספר הסידורי מוקרא בקול ברמקול שאליו מעבירים.
המספר הסידורי של תוכנת Android TV
למכשירי Android TV (ATV) משויכים כמה מספרים סידוריים. ניתן לקבל את המספר הסידורי של התוכנה (Cast) על ידי העברה (cast) מהדף של Cast Developer Console למכשיר ה-ATV כפי שמתואר למעלה, או על ידי העברת המספר הסידורי של מכשיר ה-ATV למצב פיתוח ובהגדרות ה-Cast.
כדי להעביר את מכשיר ה-ATV למצב פיתוח, עוברים אל Settings (הגדרות) > System (מידע כללי) > Android TV OS build ולוחצים על ה-build מספר פעמים עד שהמכשיר מודיע לכם שאתם במצב פיתוח. כדי למצוא את המספר הסידורי במצב פיתוח, מנווטים אל הגדרות > העדפות מכשיר > Chromecast Built-In או אל הגדרות > מערכת > Cast, בהתאם לדגם של ה-ATV. יופיע המספר הסידורי של התוכנה.
שימו לב שכשמאפסים מכשיר ATV להגדרות המקוריות, המספר הסידורי של התוכנה משתנה. אחרי האיפוס להגדרות המקוריות, פועלים לפי השלבים שלמעלה כדי למצוא את המספר הסידורי של התוכנה ולרשום מחדש את המספר הסידורי החדש של המכשיר ב-Cast Console.
בעיות בחשבון
אני רוצה לבטל את ההרשמה שלי ל-Google Cast Developer Console
אי אפשר לקבל החזר כספי על עמלת הרישום של חשבון הפיתוח בסך 5 $.
אין לי יותר גישה אל Google Cast Console
אם קיבלתם מאיתנו בעבר אימייל שבו נכתב שחשבון הפיתוח שלכם הושעה בגלל הפרות מרובות של התנאים וההגבלות או של מדיניות התוכן, אפשר להשיב לאימייל הזה אם דרושות לכם הבהרות נוספות.
האפליקציה שלי הוסרה מ-Google Cast
אפליקציות שהוסרו נספרות כהתראות בגין מצב הניהול התקין של חשבון הפיתוח שלכם. הפרות מדיניות מרובות או חמורות עלולות לגרום לסגירת חשבון הפיתוח שלכם.
המשמעות של הסרה היא שהמשתמשים לא יוכלו לצפות באפליקציה שהוסרה או לגשת אליה. אם פרטי הכניסה של המפתח עדיין מנוהלים באופן תקין ב-Google Cast ואופי האפליקציה מאפשר זאת, תוכלו לבצע תיקונים ולפרסם מופע חדש של האפליקציה שעומד בדרישות.
אסור לפרסם מחדש אפליקציה שהוסרה עד שהפרת המדיניות תטופל.
אני רוצה לשנות את כתובת האימייל המשויכת לחשבון שלי
אי אפשר לשנות את כתובת האימייל המשויכת לחשבון המפתח שלך ב-Google Cast. אם אתם עובדים בארגון, מומלץ להשתמש בכתובת אימייל של צוות כדי למנוע בעיות גישה בעתיד.
יש לי בעיה אחרת
יש לעיין בדף התמיכה ב-SDK להפעלת Cast.