CastReceiverOptions

new CastReceiverOptions()

adBreakPreloadTime

(رقم أو غير محدّد)

تحدّد هذه السمة المدة التي يجب أن يتم خلالها التحميل المُسبَق لمحتوى فاصل إعلاني فردي، وذلك بالثواني. يتيح لك ذلك تجنُّب التحميل المُسبَق لفاصل إعلاني قبل وقت طويل جدًا، وبالتالي تجنُّب حدوث تشويش في مقاييس إعلاناتك. في حال عدم توفيرها، يتم استخدام القيمة التلقائية وهي 5 ثوانٍ.

customNamespaces

كائن غير فارغ يتضمّن سمات cast.framework.system.MessageType غير فارغة

خريطة لمساحات أسماء الرسائل المخصّصة وأنواعها. يجب تهيئة مساحات أسماء الرسائل المخصّصة قبل بدء تشغيل التطبيق، لذا يجب توفيرها في خيارات جهاز الاستقبال. (نوع الرسالة التلقائي هو JSON في حال عدم توفيره هنا).

disableIdleTimeout

(قيمة منطقية أو غير محدّدة)

إذا كانت القيمة true، سيتم منع إغلاق جهاز الاستقبال عندما يصبح غير نشط بعد توقّف التشغيل النشط. يجب استخدام هذه السمة للتطبيقات غير المرتبطة بالوسائط فقط.

enforceSupportedCommands

قيمة منطقية

في حال ضبط القيمة على "true"، سيؤدي أي أمر وسائط غير وارد في خريطة supportedCommands إلى ظهور خطأ. سيتم ضبط cast.framework.messages.ErrorReason على NOT_SUPPORTED. القيمة التلقائية هي false، ما يسمح بتنفيذ أوامر الوسائط بدون التحقّق من الخريطة.

localSenderId

(سلسلة أو غير محدّد)

معرّف المُرسِل المستخدَم للطلبات المحلية القيمة التلقائية هي "local".

maxInactivity

(رقم أو غير محدّد)

الحد الأقصى للوقت بالثواني قبل إغلاق اتصال مرسل غير نشط. يؤدي ضبط هذه القيمة إلى تفعيل رسالة إبقاء الاتصال نشطًا. يُستخدَم لرصد المرسلين غير المستجيبين بشكل أسرع من مهلات TCP النموذجية. القيمة الدنيا هي 5 ثوانٍ، ولا يتم فرض حد أقصى، ولكن عادةً ما يستغرق الأمر دقائق قبل أن يتم تطبيق مهلات TCP على مستوى النظام الأساسي. القيمة التلقائية هي 10 ثوانٍ.

mediaElement

(non-null HTMLMediaElement or undefined)

عنصر الوسائط لتشغيل المحتوى ويتمثّل السلوك التلقائي في استخدام أول عنصر وسائط يتم العثور عليه في الصفحة.

playbackConfig

(قيمة غير فارغة من cast.framework.PlaybackConfig أو قيمة غير محدّدة)

إعدادات تشغيل تتضمّن مَعلمات مخصّصة

playWatchedBreak

(قيمة منطقية أو غير محدّدة)

إذا كانت القيمة صحيحة، سيتم تشغيل فاصل إعلاني تم دمجه من جهة العميل حتى إذا سبق أن تمّت مشاهدته.

preferredPlaybackRate

(رقم أو غير محدّد)

معدّل التشغيل الذي سيتم استخدامه في حال عدم تحديده في طلب التحميل يتراوح النطاق المسموح به بين 0.5 و2، حيث تمثّل القيمة 1 السرعة العادية.

preferredTextLanguage

(سلسلة أو غير محدّد)

اللغة التي سيتم استخدامها لمسار النص إذا لم يحدّد طلب التحميل مسارًا نشطًا.

قائمة المحتوى التالي

(قيمة غير فارغة cast.framework.QueueBase أو غير محدّدة)

تنفيذ قائمة انتظار مخصّصة

shakaVariant

(قيمة غير فارغة من cast.framework.ShakaVariant أو قيمة غير محدّدة)

تحدّد هذه السمة إصدار Shaka Player الذي يجب تحميله. اضبط القيمة على cast.framework.ShakaVariant.DEBUG لتحميل إصدار تصحيح الأخطاء.

shakaVersion

(سلسلة أو غير محدّد)

إصدار Shaka بالتنسيق MAJOR.MINOR.PATCH أو MAJOR.MINOR.PATCH-SUFFIX، مثل "4.15.12" (الإعداد التلقائي الحالي).

الإصدارات المتوافقة هي >=4.15.12 <5.0.0. الإصدارات القديمة التي لا تزال متوافقة هي >=2.5.6 <4.15.12.

ملاحظة: لا ننصح باستخدام إصدارات Shaka Player الأقدم من الإصدار التلقائي، لأنّه تم إصلاح العديد من الأخطاء في أحدث الإصدارات. يمكن تحديد إصدارات أحدث هنا للاستفادة من إصلاحات أو ميزات إضافية غير متاحة بعد بشكل تلقائي. يُرجى العِلم أنّ الإصدارات المستقبلية من حزمة تطوير البرامج (SDK) الخاصة ببرنامج Web Receiver قد تغيّر نطاق الإصدارات المتوافقة وتفرض استخدام إصدار آخر غير الذي تحدّده هنا. يجب استخدام هذا الخيار كإجراء مؤقت فقط، وبإشراف من فريق دعم Cast. (https://developers.google.com/cast/support) يمكنك استخدامها على مسؤوليتك الخاصة.

skipMplLoad

(قيمة منطقية أو غير محدّدة)

إذا كانت القيمة true، يمنع ذلك جهاز الاستقبال من تحميل مشغّل MPL.

skipPlayersLoad

(قيمة منطقية أو غير محدّدة)

إذا كانت القيمة صحيحة، سيتم منع جهاز الاستقبال من تحميل مكتبات MPL أو مشغّل Shaka. وهو يعادل ضبط كل من skipMplLoad وskipShakaLoad على القيمة "صحيح".

skipShakaLoad

(قيمة منطقية أو غير محدّدة)

إذا كانت القيمة صحيحة، يمنع جهاز الاستقبال تحميل مشغّل Shaka.

statusText

(سلسلة أو غير محدّد)

نص يمثّل حالة الطلب. يجب أن يستوفي هذا النص قواعد التدويل، لأنّه قد يتم عرضه من خلال تطبيق المرسِل.

supportedCommands

(رقم أو غير محدّد)

قناع بتات لأوامر الوسائط التي يتيحها التطبيق. يجب أن تتوافق الأجهزة دائمًا مع الأوامر LOAD وPLAY وSTOP وGET_STATUS. إذا لم يتم توفير هذه القيمة، يُفترض أيضًا أنّ PAUSE وSEEK وSTREAM_VOLUME وSTREAM_MUTE وEDIT_TRACKS وPLAYBACK_RATE متوافقة.

انظر أيضًا

cast.framework.messages.Command

uiConfig

(قيمة غير فارغة 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

(رقم أو غير محدّد)

عدد صحيح يُستخدَم كرقم إصدار داخلي لتمثيل إصدار جهاز الاستقبال. يُستخدم هذا الرقم فقط للتمييز بين إصدارات جهاز الاستقبال عند جمع المقاييس. ويجب زيادته مع كل إصدار، وأن يظل مرتبطًا بهذا الإصدار في حال الرجوع إلى إصدار سابق.