ה-Web Receiver SDK משתמש בנגן מדיה מובנה כדי לספק חוויית הפעלה חלקה ופשוטה. היא מספקת תמיכה מובנית ב-Google Assistant וגם תכונות ספציפיות ל-Cast, שנתמכות באופן אוטומטי בכל השולחים והמכשירים שתומכים בנגיעה. כאשר יושקו תכונות חדשות, הן ימשיכו לקבל תמיכה ללא שינויים נוספים בשולח.
מקלט האינטרנט המותאם אישית הוא אפליקציית HTML5 בהתאמה אישית, שצריך לארח כדי להציג את התוכן שלכם במכשירים שתומכים ב-Cast. יכול להיות שתצטרכו ליצור מקלט אינטרנט מותאם אישית, בהתאם לצרכים העסקיים שלכם. לקבלת עזרה בהחלטה של סוג המקלט שבו רוצים להשתמש, אפשר לעיין במדריך למקלט אינטרנט.
SDK של מקלט האינטרנט של Google
האפליקציה של מקלט האינטרנט ניגשת ל-Web Receiver API עם הפנייה הבאה:
<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
שיטה מומלצת לפרוטוקולים של כתובות URL: שימו לב שכתובת ה-URL שלמעלה לא מציינת פרוטוקול עם & "http:" או "https:" אם הפרוטוקולים האלה נשלחים במהלך משאב cast_receiver_framework.js, המשאב הזה מאפשר לשלוף את המשאב הזה באמצעות הפרוטוקול של השרת שמארח את אפליקציית מקלט האינטרנט. כלומר, המעבר בין HTTP לפיתוח לבין HTTPS לסביבת הייצור שקוף, ולא מצריך שינוי קוד. (אפליקציות של מקלט אינטרנט שפורסמו חייבות להתארח בשרתים עם TLS (אבטחת שכבת התעבורה).
תצוגה מקדימה של SDK
אפשר להשתמש בגרסת טרום-השקה של ה-SDK של מקלט האינטרנט (cast) גם לבדיקה של אפליקציות שאינן בשלב הייצור. מידע נוסף על כתובת ה-URL לתצוגה מקדימה של SDK ב-SDK זמין בכתובת ה-URL לתצוגה מקדימה של ה-SDK של Google Cast Web .
מחזור החיים של האפליקציה
מחזור החיים של אפליקציית מקלט האינטרנט מתחיל מהנקודה שבה נטען מקלט האינטרנט במכשיר ה-Cast, וממשיך לנקודה שבה האפליקציה נעלמת ומכשיר ה-CAST חוזר למצב ברירת המחדל.
במהלך מחזור החיים של אפליקציה של רסיבר אינטרנט, ההודעות מועתקות בין מקלט האינטרנט לכל אפליקציות השולח המחוברות. אפליקציית שליחה תשלח הודעה ראשונית למכשיר Google Cast עם בקשה ליצור סשן באמצעות מזהה אפליקציה ספציפי. פעולה זו מפעילה את מחזור החיים של מקלט האינטרנט, מכיוון שמכשיר Google Cast ינסה לטעון את אפליקציית מקלט האינטרנט. בהנחה שאין בעיות ברשת, תתבצע הורדה של אפליקציית מקלט האינטרנט מהרשת באמצעות כתובת האתר המתוקנת המשויכת למזהה האפליקציה. לאחר שהוא ייטען, האפליקציה של רסיבר האינטרנט תבצע את פעולות ההגדרה שלה ותציין שהיא מוכנה לעיבוד הודעות מכל אפליקציה של שולח מחובר.
אפליקציה של מקלט אינטרנט עשויה לקרוס (לסגור את מחזור החיים הנוכחי שלה ולסגור את האפליקציה) בתנאים הבאים:
- האפליקציה Web Receiver מקבלת הודעה מפורשת מהשולח האחרון שמחובר כדי לסיים את סשן הבקשה.
- האפליקציה Web Receiver הייתה לא פעילה במשך פרק זמן מוגדר ללא שולחים מחוברים, ומחליטה לסיים את הסשן באפליקציה.
- התחיל סשן העברה (cast) אחר.
- מקלט האינטרנט נתקל בשגיאה חמורה במהלך מחזור החיים הרגיל שלו.
ה-SDK של מקלט האינטרנט מטפל בכל המקרים הנפוצים בהתאם להנחיות שלנו בנושא חוויית משתמש.
שיעורים עיקריים
מסגרת ה-SDK של מקלט האינטרנט כוללת שתי כיתות עיקריות:
cast.framework.CastReceiverContext– מנהל את כל המסגרת וטוענת את כל הספריות הנדרשות. באמצעות האובייקט הזה, אתם יכולים:- הגדרת אפשרויות להגדרה של אפליקציה
- ניהול אירועי מערכת (למשל, שולח מחובר או מנותק)
- יצירת ערוצים מותאמים אישית
- התחלת תקשורת בהעברה
cast.framework.PlayerManager– ניהול ההפעלה של המדיה. הוא מטפל בנגן המקורי וברכיב המדיה בהתאם לבקשה מהשולח. באמצעות האובייקט הזה, אתם יכולים:- ניהול פעולות הפעלה
- טיפול בבקשות שקשורות להפעלה מהשולח
- ניהול אירועים הקשורים להפעלה
רישום האפליקציה של מקלט האינטרנט
לפני פיתוח אפליקציה למקלט אינטרנט, עליך לרשום את אפליקציית רסיבר האינטרנט שלך ב-Google Cast SDK Console. מידע נוסף זמין בקטע רישום. כל האפליקציות של מקלטי האינטרנט מחייבות אפליקציות שולח לספק מזהה אפליקציה עם הודעות הפקודה שהוא שולח למקלט האינטרנט דרך ממשק ה-API של השולח. כשתרשמו את האפליקציה שלכם באינטרנט, תקבלו את מזהה האפליקציה שיופיע בקריאות ל-API של השולח.
יצירת אפליקציה בסיסית למקלט אינטרנט
אלו המבנה העיקרי של אפליקציית מקלט אינטרנט בסיסית, ללא התאמה אישית:
- רכיב HTML מסוג
cast-media-playerשמייצג את נגן המדיה. - רכיב HTML של סקריפט לטעינה של מסגרת מקלט האינטרנט.
- אפשר להתקשר למספר
start()כדי להפעיל את האפליקציה 'מקלט אינטרנט' ללא אפשרויות.
זה הקוד המינימלי לאפליקציה של מקלט אינטרנט באמצעות המסגרת של אפליקציית Cast ללא התאמה אישית. תוכלו להעתיק את הסקריפט הזה ולהדביק אותו בדיוק כפי שהוא באפליקציה שלכם כדי ליצור את אפליקציית מקלט האינטרנט.
<html>
<head>
<script type="text/javascript"
src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
</script>
</head>
<body>
<cast-media-player></cast-media-player>
<script>
cast.framework.CastReceiverContext.getInstance().start();
</script>
</body>
</html>
בשלב זה, המשתמש יכול לפתוח את אפליקציית השולח, להתחבר למכשיר ה-CAST, לנווט למדיה וללחוץ על 'Play', שלפיו מקלט האינטרנט יכול לשדר את המדיה לטלוויזיה כדי שהמשתמש יוכל לצפות בה.
השוו את מקלט האינטרנט הבסיסי הזה לאפליקציית מקלט מותאמת אישית.
מדיה ונגנים
מסגרת ההעברה מספקת נגן מדיה מובנה, שמיוצג על ידי רכיב ה-HTML cast-media-player. נגן המדיה הזה תומך בהפעלה של פרוטוקולים לסטרימינג, כמו MPEG-DASH, HLS ו-Smooth Streaming.
רשימה של רכיבי קודק נתמכים וגורמים מכילים רשומים מופיעה בקטע מדיה נתמכת. באמצעות העברת הודעות למפתחים, מפתחים יכולים לתמוך ברשימה של פעולות ביוזמת השולח, כמו טעינה, הפעלה, השהיה והרצה, שבהן Cast SDK מטפל באינטראקציות עם המדיה. לקבלת רשימה של פעולות נתמכות, עיינו בהפניה ל-API של השולח בפלטפורמת האפליקציה שלכם: RemoteMediaClient ב-Android Sender, GCKMediaControlChannel ב-iOS Sender ו-Media ב-Web Sender.
שיתוף משאבים בין מקורות
ב-Google Cast יש תמיכה מלאה בשיתוף משאבים בין מקורות (CORS). בסטרימינג של פרוטוקולים, בניגוד לפרוטוקולים מבוססי-קבצים, אפשר לגשת לתוכן באופן אסינכרוני באמצעות XMLHttpRequest. בעולם של CORS, הבקשות האלה מוגנות מפני גישה לא הולמת של כותרת ה-CORS, מהשרת שממנו מגיע המשאב. פירוש הדבר הוא שבשרת התוכן שלכם יש אפשרות לדעת איפה הוא עשוי להיכלל. רוב הדפדפנים המודרניים תומכים באופן מלא ב-CORS. מכשירי iOS ו-Android נכנסים לתוכן ברמה נמוכה יותר ולא מסתכלים על הכותרות האלה. הרבה פעמים זו הבעיה הראשונה שמפתחים מעדיפים להשתמש בתוכן סטרימינג. לפרטים נוספים, ראו שיתוף משאבים בין מקורות.