סקירה כללית
ה-SDK של Cast WebReceiver תומך בהפעלה של תוכן באמצעות מספר ממשקי אינטרנט . מבוסס על בפרוטוקול שבו נעשה שימוש, ה-SDK טוען נגן לטיפול בהפעלת התוכן. ב כיסוי של תוכן HLS, ספריית Media Player (MPL) נטענת. במקרה של תוכן DASH, Shaka Player הוא נטען.
בהמשך, צוותי ההנדסה של Cast SDK ו-Shaka Player מאחדים מאמצים להגדלת התמיכה בהפעלת תוכן בפרוטוקול HLS ב-Shaka נגן. לא יתקבלו יותר עדכונים קריטיים ל-MPL. מומלץ להפעיל כדי להשתמש ב-Shka Player להפעלת תוכן HLS באפליקציה.
ההטבות של Shaka Player
החלפת הנגנים מאפשרת לאפליקציות ליהנות מהיתרונות הבאים:
- סשנים של סטרימינג חזקים יותר למשתמשים, עם שיפורים בזמן הטעינה כשלים וזמן אחזור.
- המשך השימוש בתכונות העדכניות של פרוטוקול HLS.
- בהירות יותר של ניתוח שורש הבעיה של תוכן הנגן בעיות תאימות עקב אופי הקוד הפתוח של Shaka Player.
- בסיס קוד של נגן קוד פתוח מאפשר לשותפים לתרומה לפרויקט Shaka Player.
- צמצום משמעותי של זמן התיקון של תכונות ותיקוני באגים עד לסביבת הייצור כמו פריט התוכן של Shaka Player קצב הצעדים לעיתים קרובות והם לא תלויים בגרסאות של ה-SDK של מקלט האינטרנט.
- שליטה רבה יותר על סביבת ההפעלה שמסופקת על ידי
shakaVersionAPI. - תמיכה מוגברת בהפעלה של Google בעזרת משאבים הנדסיים שמתמקד בהפעלת HLS ב-Shaka Player כפי שמוצג מפת הדרכים.
ציר הזמן
ערכת ה-SDK של Web Acceptr תעבור לשימוש ב-Shaka Player כנגן ברירת המחדל להפעלת תוכן בפרוטוקול HLS. הדבר ייעשה בגישה הדרגתית להנחיה שותפים בתהליך ההעברה.
| שלב | Start Date | סקירה כללית |
|---|---|---|
| 1 | אוקטובר 2022 | ערכת ה-SDK של Cast Web Gettingr כוללת ממשקי API להבעת הסכמה להפעלת תוכן HLS ב-Shka Player. |
| 2 | החצי השני של שנת 2024 | ערכת ה-SDK של Cast Web Gettingr משנה את נגן ברירת המחדל ל-Shka Player להפעלת תוכן ב-HLS. |
צוותים של מהנדסי SDK של Web Optr ננקטים גישה מבוססת-ביצועים וימשיכו לשלב הבא רק כשהביצועים של שחקן שאקה מופעלים זהים לביצועים הבסיסיים של MPL. השינויים האלה יפורסמו cast-sdk-announcements google group (העברה ל-SDK) ועדכנת ב- במדריך הזה.
הצטרפות
החל מגרסה 3.0.0105 של CAF, יש רמת אפליקציה
כדי להצטרף לשימוש ב-Shaka Player להפעלה ב-HLS. הגרסה הזו
מציגה גם API לבחירה מתוך מגוון נתמך של גרסאות נגן Shaka
לטעינה. הסימונים האלה מופיעים
CastReceiverOptions עד
useShakaForHls והקבוצה
של shakaVersion מאפיינים והם עוברים הערכה כאשר
CastReceiverContext מתחיל. כל אפליקציה שמצטרפת ל-Shaka ל-HLS
צריך להגדיר גרסת Shaka Player של 4.3.4 לפחות כדי לנצל את
השיפורים האחרונים בפרוטוקול HLS. כדי להביע הסכמה, פועלים לפי קטע הקוד הבא:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;
context.start(castReceiverOptions);
אימות התוכן
על השותפים לאמת את הפעלת התוכן שלהם ב-Shaka Player לפני ההצטרפות להשתמש ב-Shka Player באפליקציית הייצור שלהם. מומלץ לבצע בדיקה לכל אחד הגרסאות הבאות של התוכן:
- סוגי השידורים: LIVE או VOD
- פורמטים של קונטיינרים: TS, MP4 או צדדים שלישיים.
- תוכן עם אי-רציפות או מודעות מוטמעות
- הפעלה בסוגי המכשירים הבאים: מסכים חכמים, מתאמי Chromecast, מכשירי Android TV, טלוויזיות עם Chromecast מובנה, רמקולים חכמים
אם מצאתם שגיאות או התנהגות לא צפויה, אפשר לדווח על באג. אחרי שמוודאים שאין כשלים קריטיים בהפעלה תוכן, דוחפים את השינויים לסביבת הייצור.
ביטול ההסכמה
ה-SDK של WebReceiver יעבור למודל ביטול ההסכמה עבור Shaka Player HLS
הפעלת תוכן בהתאם לציר הזמן. הנכס
ערך ברירת המחדל ישתנה על ידי useShakaForHls
מ-false עד true. באותו זמן, אפליקציות יוכלו לבחור להשתמש ב-MPL עבור HLS
להפעלה על ידי הגדרה ידנית של המאפיין הזה ל-false. כאשר
האפליקציה CastReceiverContext התחילה, ה-SDK של Web Gettingr יחזור להיטען
MPL במקום Shaka Player. הדוגמה הבאה מראה איך לבטל את ההסכמה:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;
context.start(castReceiverOptions);
דיווח על בעיות
אנחנו מעודדים את השותפים שלנו לדווח על בעיות שהם נתקלים בהם במהלך משחק ב-HLS תוכן. כפי שצוין, MPL לא תקבל יותר עדכונים קריטיים. אם בכלל אם נתקלתם בבעיות ב-MPL, צריך לפעול לפי השלבים שמפורטים בקטע הבעת הסכמה. בחלק במדריך כדי לוודא שמעבר ל-Shaka Player יבטל את החסימה של בעיה. אם הבעיה עדיין קיימת או אם נתקלתם בה, עליכם לבצע את השלבים הבאים בעיה אחרת כשמחליפים שחקנים.
- כדאי לנסות להגדיר את
shakaVersionבתור כדי לפתור את הבעיה, מופיעה גרסת הסתעפות אחרת. לדוגמה, אם הבעיה משתמש בהסתעפות4.3. כדאי לנסות להגדיר אותו לגרסה האחרונה ב את הגרסה4.2.xאו3.3.x. כדאי לבדוק את הגרסה של Shaaka Player הערות עם העדכונים הרלוונטיים ביותר. שימו לב ב-API שלshakaVersionיש ערכי מינימום ומקסימום גרסה נתמכת, כפי שמפורט במסמכי העזרה. אם תבחינו שיש רגרסיה, דווחו על הבעיה ב-Shaka Player למעקב אחר בעיות. כדאי לנסות לשנות את הפרמטרים של הגדרת הנגן. נגן Shaka הוא להגדרה באמצעות אובייקט
PlayerConfiguration. האינטרנט ה-SDK של המקבל מגדיר קבוצה של ערכי ברירת מחדל ומאפשר לאפליקציות תשנה את התצורה הזו באמצעות הנכסshakaConfigבPlaybackConfigלאובייקט. מתבצעת הערכה במהלך זמן הטעינה, כשמופע הנגן נוצר. למידע נוסף ב-הגדרת אפליקציות הפרמטר הזה. ברירת המחדל הערכים שהוגדרו על ידי WebReceiver SDK הם הערכים המומלצים.
אפשר לבדוק אם הבעיה דווחה מעקב אחר בעיות ב-Shaka Player או העברה (Cast) למעקב אחר בעיות. מוסיפים הערה על הבאג ומוסיפים פרטים רלוונטיים אם הוא מתאר גם את הבעיה שלך.
בודקים את התוכן באתר ההדגמה של Shaaka Player. אם מוצאים שהבעיה חוזרת על עצמה באתר ההדגמה (דמו) עם התוכן שלכם, שלחו בקשה באג בפרויקט Shaka Player.
לדווח על באג בכלי למעקב אחרי בעיות בהפעלת Cast אם יש בעיה ייחודית ל-Shka Player בנקודות קצה של Cast.
שאלות נפוצות
החלפת שחקנים יכולה לעורר שאלות רבות. בהמשך אפשר למצוא את השפות תשובות לשאלות נפוצות כדי להנחות אתכם בתהליך ההעברה.
האם כדאי לעבור ל-Shaka Player?
אנחנו מעודדים את השותפים שלנו שמשתמשים בתוכן ב-HLS להתחיל את תהליך ההעברה בתור בהקדם האפשרי. כתוצאה מכך, האפליקציה תספק איכות משופרת של סטרימינג עבור המשתמשים. הטבות נוספות מפורטות ב-Shaka Player היתרונות במדריך זה. השותפים צריכים לבצע אימות שהאפליקציות שלהם פועלות בצורה תקינה באמצעות Shaka Player כדי להבטיח של המעבר לממשק החדש. אפליקציות מסוימות עלולות להיות בסיכון למצב שבו ה-SDK של Web Acceptr עובר למודל ביטול הסכמה אם השותפים לא מאמתים שהתוכן שלהם מופעל כראוי ב-Shaka Player מראש.
מהי רמת המאמץ הצפויה כשמחליפים שחקנים?
השותפים יצטרכו לבדוק את האפליקציה והתוכן שלהם בסביבת בדיקה כדי להבטיח שחוויית המשתמש תהיה דומה או משופרת בהשוואה ל-HLS. כדי לעשות את זה, השותפים יצטרכו להביע הסכמה לשימוש בתכונה. בסביבה הפנימית ולבדוק ביסודיות שהתוכן שלהם יכול להפעיל באמצעות Shaka Player. אפשר לקרוא פרטים נוספים בקטע אימות תוכן. באילו היבטים של התוכן צריך להתמקד. לאחר האימות, השותפים יצטרכו להוסיף את הדגל כדי להביע הסכמה בסביבת הייצור של האפליקציה ולהתחיל ומנצלים את ההטבות של Shaka Player. ברמה גבוהה לשם הם שינויים קלים בפיתוח תוכנה ובעיקר דרישות לבקרת איכות עבור של השותפים כדי לבצע את ההעברה.
האפליקציה שלי תשתמש בקרוב ב-HLS כדי לשדר תוכן בסטרימינג. מה עליי לעשות?
לשילובים חדשים צריך להביע הסכמה לשימוש ב-Shaka Player להפעלה. שלך תהיה נתמך טוב יותר בטווח הארוך, את היתרון של התכונות החדשות של HLS ושיפורי ביצועים. אם ההגדרה החדשה נתקל בבעיות, דווח על באג בהקדם האפשרי כדי לספק מספיק זמן כדי לפתור את הבעיה. אם לאפליקציה שלכם יש המועד האחרון, יש לכלול את המידע הזה בדוח איתור הבאגים, וכן את ההשפעה של כדי לקבוע את סדר העדיפויות בהתאם. צוות המהנדסים שלנו יפעל כדי לספק פתרון כדי לתמוך בצורה הולמת במשתמשים שלך.
התוכן או האפליקציה שלי לא פועלים עם Shaka Player. מה עכשיו?
עליך לדווח על באג בפרויקט Shaka Player או בפרויקט Cast (מידע נוסף זמין בקטע דיווח על בעיות). צוות המהנדסים של Cast SDK פעיל לעקוב אחרי מכשירי המעקב האלה, והוא יעזור לכם לפתור כל בעיה שעולה. ככל שהבעיות יזוהו בשלב מוקדם יותר, כך יידרש יותר זמן לפתור בעיות.
MPL לא מקבלת יותר עדכונים קריטיים. מה זה אומר בדיוק?
בעבר, ב-MPL אימצו תכונות חדשות של HLS ותקנו באגים משמעותיים באמצעות ובעדכונים קריטיים. עכשיו, אחרי ש-MPL לא תקבל אותם יותר, הודעות HLS חדשות לא יתווספו לנגן. כמו כן, כל בעיה שדווחו בנוגע ל-HLS הפעלה ב-MPL לא תתוקן ב-MPL. הבעיות האלה אמורות להיפתר עוברים לנגן Shaka לצורך הפעלה. אם הבעיות נמשכות, צריך לשלוח באג את הבעיות הרלוונטיות שנתקלת בהן ב-Shka. נגן. שותפים צריכים להפסיק להשתמש ב-MPL.
התוכן שלי משתמש בפרוטוקול Smooth Streaming. איך זה משפיע על הבקשה שלי?
הקבצים הבינאריים של MPL עדיין יתארחו ויהיו נגישים למקבל שלך תרגום מכונה. עם זאת, כל בקשה של תכונה הקשורה לסטרימינג חלקה, או באג לא תהיה תמיכה בתיקונים המפרט של סטרימינג חלק לא עודכן ב מעל ארבע שנים. מומלץ להעביר את התוכן לשימוש ב-DASH או HLS כדי להמשיך לקבל עדכוני ביצועים ותמיכה את התוכן שלך.
התוכן שלי לא משתמש בפרוטוקולים HLS או Smooth Stream. איך זה משפיע על הבקשה שלי?
אם ספריית התוכן שלך לא משתמשת באף אחד מהפרוטוקולים האלה, אז לא תהיה לכך השפעה על ההעברה. אין צורך לבצע שינויים תרגום מכונה.