الفئة: CastReceivedrOptions

الشركة المصنِّعة

CastReceiverOptions

خيار جديد CastReceivedrOptions()

أماكن إقامة

adBreakPreloadTime

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

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

customNamespaces

كائن غير فارغ مع خصائص cast.framework.system.MessageType غير فارغة

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

disableIdleTimeout

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

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

enforceSupportedCommands

ثابت

boolean

في حال الضبط على "true"، سيؤدي أي أمر وسائط غير متوفر في خريطة SupportCommands إلى إنشاء خطأ. سيتم ضبط Cast.framework.messages.Errorreason على NOT_SUPPORTED. القيمة التلقائية هي false، ما يسمح بتنفيذ أوامر الوسائط بدون التحقق من الخريطة.

localSenderId

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

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

maxInactivity

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

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

mediaElement

(HTMLMediaElement غير فارغة أو غير معرّفة)

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

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، على سبيل المثال "4.3.4" (الإصدار التلقائي الحالي).

الإصدارات المتوافقة هي >=3.3.16 <5.0.0. تجدر الإشارة إلى أنّ الإصدارات التي تم إيقافها نهائيًا ولكنها لا تزال متوافقة مع الإصدار >=2.5.6 <3.3.16.

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

skipMplLoad

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

في حال اختيار "true"، سيمنع المستلم من تحميل مشغّل MPL.

skipPlayersLoad

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

في حال كانت القيمة "true"، ستمنع المتلقي من تحميل مكتبات مشغِّل MPL أو Shaka. تعادل هذه الإعدادات ضبط كل منهم browseMplLoad وتخطيShakaLoad على "صحيح".

skipShakaLoad

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

في حال اختيار "true"، سيمنع المُستلِم من تحميل مشغّل Shaka.

statusText

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

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

supportedCommands

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

قناع بت لأوامر الوسائط المتوافقة مع التطبيق. يجب أن تتوفّر إمكانية استخدام LOAD وPLAY وSTOP وGET_STATUS دائمًا. في حال عدم تقديم هذه القيمة، يُفترض أيضًا توافق "الإيقاف المؤقت" و"زر الطلب" و"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 لأنّه لا تزال بعض الميزات غير متوفّرة، ولأنّنا نريد التأكد من أنّه جيد ومتوافق على نطاق واسع مع أجهزة استقبال البث المباشر وفق بروتوكول HTTP (HLS) قبل ضبطه كمتصفّح تلقائي. في حال تفعيل Shaka Player لميزة HLS قبل الإطلاق الرسمي، يُرجى الإبلاغ عن أي مشاكل تواجهك. (https://developers.google.com/cast/support) قبل الإطلاق الكامل لـ Shaka Player for HLS، لا نقدّم أي ضمانات بشأن توافق Shaka Player مع بروتوكول HLS، وقد ننصحك بإعادة هذه العلامة إلى الإعداد التلقائي إذا كنت تواجه مشاكل ليست بسيطة.

versionCode

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

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