cast.
אפשרויות הקשר של Cast Receiver. כל המאפיינים הם אופציונליים.
יצרן
CastReceiverOptions
new CastReceiverOptions()
מאפיינים
adBreakPreloadTime
(מספר או לא מוגדר)
כמה זמן מראש, בשניות, צריך לטעון מראש את התוכן של הפסקה למודעה בודדת. כך אפשר להימנע מטעינה מראש של הפסקה למודעה זמן רב מדי לפני שהיא מוצגת, וכך לבלבל את מדדי המודעות. אם לא מציינים ערך, ברירת המחדל היא 5 שניות.
customNamespaces
non-null Object with non-null cast.framework.system.MessageType properties
מפה של מרחבי שמות של הודעות בהתאמה אישית והסוגים שלהם. צריך להפעיל מרחבי שמות של הודעות בהתאמה אישית לפני שהאפליקציה מתחילה, ולכן צריך לספק אותם באפשרויות של המקלט. (סוג ההודעה שמוגדר כברירת מחדל הוא JSON, אם לא צוין כאן אחרת).
disableIdleTimeout
(ערך בוליאני או לא מוגדר)
אם הערך הוא true, המקלט לא ייסגר כשהוא יעבור למצב שאין בו פעילות אחרי שההפעלה הפעילה תיפסק. צריך להשתמש במאפיין הזה רק באפליקציות שהן לא אפליקציות מדיה.
enforceSupportedCommands
בוליאני
אם הערך הוא true, כל פקודת מדיה שלא נמצאת במפה supportedCommands תגרום לשגיאה. הערך של cast.framework.messages.ErrorReason יוגדר כ-NOT_SUPPORTED. ערך ברירת המחדל הוא False, שמאפשר להפעיל פקודות מדיה בלי לבדוק את המפה.
localSenderId
(מחרוזת או לא מוגדר)
מזהה השולח שמשמש לבקשות מקומיות. ערך ברירת המחדל הוא "local".
maxInactivity
(מספר או לא מוגדר)
משך הזמן המקסימלי בשניות לפני סגירת חיבור לא פעיל של השולח. הגדרת הערך הזה מפעילה הודעת פעימה כדי לשמור על החיבור פעיל. משמש לזיהוי שולחים שלא מגיבים מהר יותר מאשר זמני קצובים רגילים של TCP. הערך המינימלי הוא 5 שניות. אין אכיפה של גבול עליון, אבל בדרך כלל לוקח כמה דקות עד שזמני הקצובים לתפוגה של TCP בפלטפורמה נכנסים לתוקף. ערך ברירת המחדל הוא 10 שניות.
mediaElement
(HTMLMediaElement שאינו null או לא מוגדר)
רכיב המדיה שבאמצעותו מופעל התוכן. פעולת ברירת המחדל היא להשתמש ברכיב המדיה הראשון שנמצא בדף.
playbackConfig
(cast.framework.PlaybackConfig שאינו null או לא מוגדר)
הגדרת הפעלה עם פרמטרים מותאמים אישית.
playWatchedBreak
(ערך בוליאני או לא מוגדר)
אם הערך הוא True, הפסקה שנוספה בצד הלקוח תופעל גם אם כבר צפו בה.
preferredPlaybackRate
(מספר או לא מוגדר)
מהירות ההפעלה שבה צריך להשתמש אם היא לא צוינה בבקשת הטעינה. הטווח המותר הוא בין 0.5 ל-2, כאשר 1 הוא המהירות הרגילה.
preferredTextLanguage
(מחרוזת או לא מוגדר)
השפה שבה יש להשתמש בטראק הטקסט אם בקשת הטעינה לא מציינת טראק פעיל.
רשימת סרטונים
(cast.framework.QueueBase שאינו null או לא מוגדר)
הטמעה של תור בהתאמה אישית.
shakaVariant
(cast.framework.ShakaVariant שאינו null או לא מוגדר)
איזה גרסה של Shaka Player צריך לטעון. מגדירים את הערך cast.framework.ShakaVariant.DEBUG כדי לטעון גרסת build לניפוי באגים.
shakaVersion
(מחרוזת או לא מוגדר)
גרסת Shaka בפורמט MAJOR.MINOR.PATCH או MAJOR.MINOR.PATCH-SUFFIX, לדוגמה "4.15.56" (ברירת המחדל הנוכחית).
הגרסאות הנתמכות הן >=4.15.56 <6.0.0. גרסאות שהוצאו משימוש אבל עדיין תואמות הן >=2.5.6 <4.15.56.
הערה: לא מומלץ להשתמש בגרסאות של Shaka Player שהן ישנות יותר מגרסת ברירת המחדל, כי בגרסאות האחרונות תוקנו הרבה באגים. אפשר לציין כאן גרסאות חדשות יותר כדי להצטרף לתיקונים או לתכונות נוספים שעדיין לא זמינים כברירת מחדל. עם זאת, חשוב לזכור שגרסאות עתידיות של Web Receiver SDK עשויות לשנות את טווח הגרסאות הנתמכות ולחייב שימוש בגרסה שונה מזו שציינת כאן. הדגל הזה מיועד לשימוש זמני בלבד, ובהנחיית צוות התמיכה של Cast. (https://developers.google.com/cast/support) השימוש הוא באחריותך בלבד.
skipMplLoad
(ערך בוליאני או לא מוגדר)
אם הערך הוא True, המקלט לא יכול לטעון את נגן ה-MPL.
skipPlayersLoad
(ערך בוליאני או לא מוגדר)
אם הערך הוא True, המקלט לא יכול לטעון את ספריות הנגן MPL או Shaka. ההגדרה הזו מקבילה להגדרה של skipMplLoad ו-skipShakaLoad לערך true.
skipShakaLoad
(ערך בוליאני או לא מוגדר)
אם הערך הוא True, המקלט לא יכול לטעון את נגן Shaka.
statusText
(מחרוזת או לא מוגדר)
טקסט שמייצג את סטטוס הבקשה. הוא צריך לעמוד בכללי הבינאום, כי יכול להיות שהוא יוצג על ידי אפליקציית השולח.
supportedCommands
(מספר או לא מוגדר)
ביט-מסק של פקודות מדיה שהאפליקציה תומכת בהן. תמיד צריך לתמוך בפקודות LOAD, PLAY, STOP ו-GET_STATUS. אם הערך הזה לא צוין, המערכת מניחה שגם הפקודות PAUSE, SEEK, STREAM_VOLUME, STREAM_MUTE, EDIT_TRACKS ו-PLAYBACK_RATE נתמכות.
uiConfig
(cast.framework.ui.UiConfig שאינו null או לא מוגדר)
הגדרת ממשק המשתמש.
useLegacyDashSupport
(ערך בוליאני או לא מוגדר)
אם true, צריך להשתמש ב-MPL לתוכן DASH.
useShakaForHls
(ערך בוליאני או לא מוגדר)
אם true, צריך להשתמש ב-Shaka Player לתוכן HLS. ברירת המחדל היא false.
הערה: Shaka Player הוא לא נגן ברירת המחדל לתוכן HLS כי עדיין חסרות בו תכונות, וכי אנחנו רוצים לוודא שהוא פועל היטב ותואם באופן נרחב למקלטי HLS לפני שנגדיר אותו כברירת המחדל. אם בחרת להשתמש ב-Shaka Player ל-HLS לפני ההשקה הרשמית, נשמח אם תדווח על כל בעיה שנתקלת בה. (https://developers.google.com/cast/support) לפני ההשקה המלאה של Shaka Player ל-HLS, אנחנו לא מבטיחים תאימות של Shaka Player ל-HLS, ויכול להיות שנמליץ לכם להחזיר את הדגל הזה להגדרת ברירת המחדל שלו אם תיתקלו בבעיות לא טריוויאליות.
versionCode
(מספר או לא מוגדר)
מספר שלם שמשמש כמספר גרסה פנימי שמייצג את גרסת המקלט. המספר הזה משמש רק כדי להבחין בין גרסאות של המקלט בזמן איסוף המדדים. צריך להגדיל את המספר בכל גרסה, והוא צריך להישאר מקושר לגרסה הזו במקרה של חזרה לגרסה קודמת.