CastReceiverOptions

new CastReceiverOptions()‎

adBreakPreloadTime

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

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

customNamespaces

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

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

disableIdleTimeout

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

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

enforceSupportedCommands

قيمة منطقية

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

localSenderId

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

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

maxInactivity

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

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

mediaElement

(HTMLMediaElement غير فارغ أو غير محدّد)

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

playbackConfig

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

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

playWatchedBreak

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

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

preferredPlaybackRate

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

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

preferredTextLanguage

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

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

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

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

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

shakaVariant

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

Which build of Shaka Player should be loaded. اضبط القيمة على cast.framework.ShakaVariant.DEBUG لتحميل إصدار مخصص لتصحيح الأخطاء.

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 الأقدم من الإصدار التلقائي، لأنّه تم إصلاح العديد من الأخطاء في الإصدارات الأحدث. ويمكن تحديد الإصدارات الأحدث هنا للموافقة على الإصلاحات أو الميزات الإضافية التي لم تتوفّر بعد تلقائيًا. ومع ذلك، يُرجى العِلم أنّ الإصدارات المستقبلية من حزمة تطوير البرامج (SDK) لجهاز الاستقبال على الويب قد تغيّر نطاق الإصدارات المتوافقة وتفرض استخدام إصدار آخر غير الذي تحدّده هنا. يجب استخدام هذه العلامة كإجراء مؤقت فقط وبتوجيه من فريق دعم Cast. (https://developers.google.com/cast/support) Use at your own risk.

skipMplLoad

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

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

skipPlayersLoad

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

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

skipShakaLoad

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

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

statusText

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

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

supportedCommands

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

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

انظر أيضًا

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

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

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