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

قيمة منطقية

إذا كانت القيمة "صحيح"، سيؤدي أي أمر وسائط غير مضمّن في خريطة 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.55" (الإصدار التلقائي الحالي)

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

ملاحظة: لا يُنصح باستخدام إصدارات Shaka Player الأقدم من الإصدار التلقائي، لأنّه تم إصلاح العديد من الأخطاء في أحدث الإصدارات. يمكن تحديد إصدارات أحدث هنا للاشتراك في إصلاحات أو ميزات إضافية غير متاحة بعد بشكل تلقائي. يُرجى العِلم أنّ الإصدارات المستقبلية من حزمة تطوير البرامج (SDK) لجهاز استقبال الويب قد تغيّر نطاق الإصدارات المتوافقة وتفرض استخدام إصدار آخر غير الذي تحدّده هنا. يجب استخدام هذا العَلم كإجراء مؤقت فقط، وبتوجيه من فريق دعم 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)

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