cast.
خيارات سياق جهاز استقبال Cast. جميع الخصائص اختيارية.
الشركة المصنِّعة
CastReceiverOptions
new CastReceiverOptions()
الخصائص
adBreakPreloadTime
(number or undefined)
المدة بالثواني التي يجب أن يتم خلالها التحميل المسبق لمحتويات فاصل إعلاني فردي يسمح لك هذا الخيار بتجنُّب التحميل المسبق لفاصل إعلاني قبل وقت طويل جدًا ، وبالتالي تجنُّب إرباك مقاييس إعلاناتك. إذا لم يتم توفير هذه القيمة، سيتم استخدام القيمة التلقائية وهي 5 ثوانٍ.
customNamespaces
non-null Object with non-null cast.framework.system.MessageType properties
خريطة لمساحات أسماء الرسائل المخصّصة وأنواعها يجب تهيئة مساحات أسماء الرسائل المخصّصة قبل بدء التطبيق ، لذا يجب توفيرها في خيارات جهاز الاستقبال. (نوع الرسالة التلقائي هو JSON إذا لم يتم توفيره هنا).
disableIdleTimeout
(boolean or undefined)
إذا كانت القيمة "صحيح"، يمنع ذلك إغلاق جهاز الاستقبال عندما يصبح غير نشط بعد توقُّف التشغيل النشط. يجب استخدام هذه السمة فقط للتطبيقات غير المرتبطة بالوسائط.
enforceSupportedCommands
boolean
إذا كانت القيمة "صحيح"، سيؤدي أي أمر وسائط غير مضمّن في خريطة supportedCommands إلى ظهور خطأ. سيتم ضبط cast.framework.messages.ErrorReason على NOT_SUPPORTED. القيمة التلقائية هي "خطأ"، ما يسمح بتنفيذ أوامر الوسائط بالتحقّق من الخريطة.
localSenderId
(string or undefined)
رقم تعريف المُرسِل المستخدَم للطلبات المحلية القيمة التلقائية هي "local".
maxInactivity
(number or undefined)
الحد الأقصى للوقت بالثواني قبل إغلاق اتصال مُرسِل غير نشط يؤدي ضبط هذه القيمة إلى تفعيل رسالة نبضات القلب للحفاظ على استمرار الاتصال. يتم استخدام هذه القيمة لرصد المُرسِلين الذين لا يستجيبون بشكل أسرع من مهلات TCP النموذجية. الحد الأدنى للقيمة هو 5 ثوانٍ، ولا يتم فرض حد أعلى ، ولكن عادةً ما يستغرق الأمر دقائق قبل أن تدخل مهلات TCP الخاصة بالنظام الأساسي حيز التنفيذ. القيمة التلقائية هي 10 ثوانٍ.
mediaElement
(non-null HTMLMediaElement or undefined)
عنصر الوسائط لتشغيل المحتوى السلوك التلقائي هو استخدام أول عنصر وسائط يتم العثور عليه في الصفحة.
playbackConfig
(non-null cast.framework.PlaybackConfig or undefined)
إعداد تشغيل يتضمّن مَعلمات مخصّصة
playWatchedBreak
(boolean or undefined)
إذا كانت القيمة "صحيح"، سيتم تشغيل فاصل إعلاني تم تجميعه من جانب العميل حتى إذا سبق أن تم تشغيله.
preferredPlaybackRate
(number or undefined)
سرعة التشغيل التي سيتم استخدامها إذا لم يتم تحديدها في طلب التحميل النطاق المسموح به هو من 0.5 إلى 2، حيث يمثّل الرقم 1 السرعة العادية.
preferredTextLanguage
(string or undefined)
اللغة التي سيتم استخدامها لمسار النص إذا لم يحدّد طلب التحميل مسارًا نشطًا
queue
(non-null cast.framework.QueueBase or undefined)
تنفيذ قائمة انتظار مخصّصة
shakaVariant
(non-null cast.framework.ShakaVariant or undefined)
الإصدار الذي يجب تحميله من Shaka Player اضبط القيمة على
cast.framework.ShakaVariant.DEBUG لتحميل إصدار مخصص لتصحيح الأخطاء.
shakaVersion
(string or undefined)
إصدار Shaka بتنسيق MAJOR.MINOR.PATCH أو MAJOR.MINOR.PATCH-SUFFIX ، مثلاً "4.15.53" (الإصدار التلقائي الحالي)
الإصدارات المتوافقة هي >=4.15.53 و<5.0.0. الإصدارات التي تم إيقافها ولكنها لا تزال متوافقة هي >=2.5.6 و<4.15.53.
ملاحظة: لا يُنصح باستخدام إصدارات Shaka Player الأقدم من الإصدار التلقائي، لأنّه تم إصلاح العديد من الأخطاء في أحدث الإصدارات. يمكن تحديد إصدارات أحدث هنا للاشتراك في إصلاحات أو ميزات إضافية غير متاحة بعد بشكل تلقائي. يُرجى العِلم أنّ الإصدارات المستقبلية من حزمة تطوير برامج استقبال الويب قد تغيّر نطاق الإصدارات المتوافقة و تفرض استخدام إصدار آخر غير الذي تحدّده هنا. يجب استخدام هذا الإشعار كإجراء مؤقت فقط، وبتوجيه من فريق دعم Cast. (https://developers.google.com/cast/support) يُرجى استخدام هذه الميزة على مسؤوليتك الخاصة.
skipMplLoad
(boolean or undefined)
إذا كانت القيمة "صحيح"، يمنع ذلك جهاز الاستقبال من تحميل مشغّل MPL.
skipPlayersLoad
(boolean or undefined)
إذا كانت القيمة "صحيح"، يمنع ذلك جهاز الاستقبال من تحميل مكتبات مشغّل MPL أو Shaka يعادل هذا الخيار ضبط كل من skipMplLoad وskipShakaLoad على "صحيح".
skipShakaLoad
(boolean or undefined)
إذا كانت القيمة "صحيح"، يمنع ذلك جهاز الاستقبال من تحميل مشغّل Shaka.
statusText
(string or undefined)
نص يمثّل حالة التطبيق يجب أن يستوفي قواعد تدويل المحتوى، لأنّه قد يتم عرضه من خلال تطبيق المُرسِل.
supportedCommands
(number or undefined)
قناع بت لـ أوامر الوسائط التي يتيحها التطبيق يجب دائمًا إتاحة الأوامر LOAD وPLAY وSTOP وGET_STATUS. إذا لم يتم توفير هذه القيمة، يُفترض أيضًا أنّ التطبيق يتيح الأوامر PAUSE وSEEK و STREAM_VOLUME وSTREAM_MUTE وEDIT_TRACKS وPLAYBACK_RATE.
- انظر أيضًا
- cast.framework.messages.Command
uiConfig
(non-null cast.framework.ui.UiConfig or undefined)
إعدادات واجهة المستخدم
useLegacyDashSupport
(boolean or undefined)
إذا كانت القيمة true، استخدِم مشغّل MPL لمحتوى DASH.
useShakaForHls
(boolean or undefined)
إذا كانت القيمة 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
(number or undefined)
عدد صحيح يُستخدَم كرقم إصدار داخلي لتمثيل إصدار جهاز الاستقبال لا يُستخدَم هذا الرقم إلا للتمييز بين إصدارات جهاز الاستقبال عند جمع المقاييس. يجب زيادته مع كل إصدار ويظل مرتبطًا بهذا الإصدار في حال إجراء عملية رجوع.