cast.
אפשרויות ההקשר של מקלט ההעברה. כל המאפיינים הם אופציונליים.
יצרן
CastReceiverOptions
חדש CastReceiverOptions()
תכונות
adBreakPreloadTime
(מספר או לא מוגדר)
כמה זמן מראש עלינו לטעון מראש בשניות תוכן של הפסקה למודעה בודדת. כך אפשר להימנע מטעינה מראש של הפסקה למודעה זמן רב מדי מראש, ולגרום לבלבול במדדים של המודעות. אם לא מציינים את הפרמטר הזה, המערכת משתמשת בברירת מחדל של 5 שניות.
customNamespaces
אובייקט שאינו ריק עם מאפייני cast.framework.system.MessageType שאינם null
מפה של מרחבי שמות מותאמים אישית של הודעות והסוגים שלהם. צריך לאתחל את מרחבי השמות בהתאמה אישית לפני שהאפליקציה מתחילה, ולכן צריך לציין אותם באפשרויות של המקבל. (סוג ההודעה המוגדר כברירת מחדל הוא JSON, אם הוא לא מופיע כאן).
disableIdleTimeout
(בוליאני או לא מוגדר)
אם המדיניות הזו מוגדרת כ-True, המקלט לא ייסגר כשהיא מפסיקה לפעול אחרי שההפעלה הפעילה מפסיקה. יש להשתמש בנכס הזה רק לאפליקציות שאינן מדיה.
enforceSupportedCommands
boolean
אם הערך הוא True, כל פקודות מדיה שלא מופיעות במפת ה-Commands הנתמכת תיצור שגיאה. הרכיב cast.framework.messages.ErrorReason יוגדר לערך NOT_SUPPORTED. ערך ברירת המחדל הוא False, ולכן ניתן לבצע פקודות מדיה בלי לבדוק את המפה.
localSenderId
(מחרוזת או לא מוגדר)
מזהה השולח שמשמש לבקשות מקומיות. ערך ברירת המחדל הוא 'local'.
maxInactivity
(מספר או לא מוגדר)
הזמן המקסימלי בשניות לפני סגירת חיבור של שולח לא פעיל. הגדרת הערך הזה מפעילה הודעה של פעימת לב כדי לשמור על החיבור פעיל. משמש לזיהוי שולחים שלא מגיבים מהר יותר מהזמן הקצוב לתפוגה טיפוסי של TCP. הערך המינימלי הוא 5 שניות. אין אכיפה של גבול עליון, אבל בדרך כלל חולפות דקות עד לסיום הזמן הקצוב לתפוגה של הפלטפורמה. ערך ברירת המחדל הוא 10 שניות.
mediaElement
(HTMLMediaElement לא ריק או לא מוגדר)
רכיב מדיה להפעלת התוכן. התנהגות ברירת המחדל היא שימוש ברכיב המדיה הראשון שנמצא בדף.
playbackConfig
(הערך לא null הוא cast.framework.PlaybackConfig או שהוא לא מוגדר)
הגדרת הפעלה עם פרמטרים מותאמים אישית.
playWatchedBreak
(בוליאני או לא מוגדר)
אם ההעדפה מקבלת את הערך True, הפסקה נתפרת על ידי הלקוח תופעל גם אם כבר נצפה.
preferredPlaybackRate
(מספר או לא מוגדר)
קצב ההפעלה שיש להשתמש בו אם לא צוין בבקשת הטעינה. הטווח המותר הוא 0.5 עד 2, כאשר 1 מציין מהירות רגילה.
preferredTextLanguage
(מחרוזת או לא מוגדר)
השפה שבה יש להשתמש בטראק הטקסט אם בבקשת הטעינה לא צוין מסלול פעיל.
רשימת סרטונים
(ללא ערך null בכתובת cast.framework.QueueBase או לא מוגדר)
הטמעת תור בהתאמה אישית.
shakaVariant
(לא ריק cast.framework.ShakaVariant או לא מוגדר)
איזה build של Shaka Player צריך לטעון. צריך להגדיר
כ-cast.framework.ShakaVariant.DEBUG כדי לטעון גרסת build לניפוי באגים.
shakaVersion
(מחרוזת או לא מוגדר)
גרסת Shaka בפורמט MAJOR.MINOR.PATCH, לדוגמה, '4.3.4' (ברירת המחדל הנוכחית).
הגרסאות הנתמכות הן >=3.3.16 <5.0.0. גרסאות שהוצאו משימוש אבל עדיין תואמות הן >=2.5.6 <3.3.16.
הערה: לא מומלץ להשתמש בגרסאות של Shaka Player כשיש ברירת מחדל, כי הרבה באגים תוקנו בגרסאות האחרונות. ניתן לציין כאן גרסאות חדשות יותר כדי להביע הסכמה לתיקונים או לתכונות נוספים שעדיין לא זמינים כברירת מחדל. עם זאת, חשוב לזכור שגרסאות עתידיות של ה-Web Receiver SDK עשויות לשנות את טווח הגרסאות הנתמכות ולאלץ את השימוש בגרסה שונה מזו שמצוינת כאן. יש להשתמש בסימון הזה רק כאמצעי זמני, ובהתאם להנחיות של צוות התמיכה של Cast. (https://developers.google.com/cast/support) השימוש הוא על אחריותך בלבד.
skipMplLoad
(בוליאני או לא מוגדר)
אם הערך הוא True, המקבל לא יוכל לטעון את נגן ה-MPL.
skipPlayersLoad
(בוליאני או לא מוגדר)
אם המדיניות הזו מוגדרת כ-True, מהמקלט לא יוכל לטעון את הספריות של ה-MPL או של Shaka. שוות-ערך להגדרה של searchMplLoad ו-SkipShakaLoad כ-true.
skipShakaLoad
(בוליאני או לא מוגדר)
אם המדיניות הזו מוגדרת כ-True, מהמקבל לא יוכל לטעון את נגן Shaka.
statusText
(מחרוזת או לא מוגדר)
טקסט שמייצג את סטטוס הבקשה. הוא צריך לעמוד בכללי הבינלאומי, כפי שאפשר להציג אותו באפליקציית השולח.
supportedCommands
(מספר או לא מוגדר)
מסיכת סיביות של פקודות מדיה שנתמכות על ידי האפליקציה. חובה תמיד לתמוך ב-LOAD, PLAY, STOP, GET_STATUS. אם לא תספקו את הערך הזה, המערכת תניח גם שהתכונות PAUSE, SEEK, STREAM_VOLUME, STREAM_MUTE, EDIT_TRACKS ו-PLAYBACK_RATE הן נתמכות.
- כדאי לעיין גם בפרטים הבאים
- cast.framework.messages.Command
uiConfig
(לא ערך null: cast.framework.ui.UiConfig או לא מוגדר)
תצורת ממשק משתמש.
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
(מספר או לא מוגדר)
מספר שלם המשמש כמספר גרסה פנימי לייצוג הגרסה של המקבל. המספר הזה משמש רק כדי להבחין בין גרסאות של מקלטים במהלך איסוף מדדים. צריך להוסיף אותה בכל גרסה, ולהישאר כפוף לגרסה הזו במקרה של החזרה לגרסה קודמת.