کلاس: CastReceiverOptions

سازنده

CastReceiverOptions

new CastReceiverOptions()

مشخصات

adBreakPreloadTime

(عدد یا تعریف‌نشده)

مدت‌زمانی که باید پیش‌از شروع وقفه آگهی، محتوای آن را پیش‌بارگیری کنیم (به ثانیه). این کار به شما امکان می‌دهد از پیش‌بارگیری وقفه آگهی خیلی زودتر از موعد جلوگیری کنید و درنتیجه سنجه‌های آگهی‌تان را گیج کنید. اگر ارائه نشود، از مقدار پیش‌فرض ۵ ثانیه استفاده می‌شود.

customNamespaces

شیء غیرتهی با ویژگی‌های غیرتهی cast.framework.system.MessageType

نقشه فضاهای نام پیام سفارشی و انواع آن‌ها. فضاهای نام پیام سفارشی باید قبل‌از شروع برنامه مقداردهی اولیه شوند، بنابراین باید در گزینه‌های گیرنده ارائه شوند. (اگر در اینجا ارائه نشده باشد، نوع پیام پیش‌فرض JSON است).

disableIdleTimeout

(بولی یا تعریف‌نشده)

اگر درست باشد، از بسته شدن گیرنده هنگام غیرفعال شدن آن پس‌از توقف بازپخش فعال جلوگیری می‌کند. این ویژگی فقط باید برای برنامه‌های غیررسانه‌ای استفاده شود.

enforceSupportedCommands

ثابت

بولی

اگر درست باشد، هر فرمان رسانه‌ای که در نقشه supportedCommands نباشد، خطا ایجاد می‌کند. cast.framework.messages.ErrorReason روی NOT_SUPPORTED تنظیم خواهد شد. مقدار پیش‌فرض «نادرست» است که به فرمان‌های رسانه اجازه می‌دهد بدون بررسی نقشه اجرا شوند.

localSenderId

(رشته یا تعریف‌نشده)

شناسه فرستنده استفاده‌شده برای درخواست‌های محلی. مقدار پیش‌فرض «local» است.

maxInactivity

(عدد یا تعریف‌نشده)

حداکثر زمان به ثانیه قبل‌از بستن اتصال فرستنده بیکار. تنظیم این مقدار پیام ضربان قلب را برای زنده نگه داشتن اتصال فعال می‌کند. برای شناسایی فرستنده‌هایی که سریع‌تر از زمان‌بندی‌های معمول TCP پاسخ نمی‌دهند استفاده می‌شود. حداقل مقدار ۵ ثانیه است؛ حد بالایی اعمال نمی‌شود، اما معمولاً چند دقیقه طول می‌کشد تا زمان‌تمام‌های TCP پلاتفرم وارد بازی شوند. مقدار پیش‌فرض ۱۰ ثانیه است.

mediaElement

(HTMLMediaElement غیرتهی یا تعریف‌نشده)

عنصر رسانه‌ای برای پخش محتوا. رفتار پیش‌فرض استفاده از اولین عنصر رسانه‌ای است که در صفحه پیدا می‌شود.

playbackConfig

(cast.framework.PlaybackConfig غیرتهی یا تعریف‌نشده)

پیکربندی بازپخش با پارامترهای سفارشی.

playWatchedBreak

(بولی یا تعریف‌نشده)

اگر درست باشد، وقفه ادغام‌شده در سمت کارخواه پخش خواهد شد حتی اگر قبلاً تماشا شده باشد.

preferredPlaybackRate

(عدد یا تعریف‌نشده)

نرخ بازپخش برای استفاده درصورت مشخص نشدن در درخواست بارگیری. محدوده مجاز ۰٫۵ تا ۲ است، که ۱ سرعت عادی است.

preferredTextLanguage

(رشته یا تعریف‌نشده)

زبانی که برای قطعه نوشتاری استفاده می‌شود اگر درخواست بارگیری قطعه فعالی را مشخص نکند.

صف پخش

(cast.framework.QueueBase غیرتهی یا تعریف‌نشده)

پیاده‌سازی صف سفارشی.

shakaVariant

(non-null cast.framework.ShakaVariant or undefined)

کدام ساخت Shaka Player باید بار شود. برای بار کردن ساخت اشکال‌زدایی، روی 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 قدیمی‌تر از نسخه پیش‌فرض توصیه نمی‌شود، زیرا بسیاری از اشکال‌ها در جدیدترین نسخه‌ها برطرف شده است. نسخه‌های جدیدتر ممکن است در اینجا مشخص شوند تا برای دریافت اصلاحات یا ویژگی‌های اضافی که هنوز به‌طور پیش‌فرض دردسترس نیستند موافقت شود. بااین‌حال، لطفاً توجه داشته باشید که نسخه‌های پخش آتی Web Receiver SDK ممکن است محدوده نسخه‌های پشتیبانی‌شده را تغییر دهد و استفاده از نسخه‌ای غیراز آنچه در اینجا مشخص می‌کنید را اجباری کند. این پرچم باید فقط به‌عنوان اقدامی موقت و تحت راهنمایی تیم پشتیبانی Cast استفاده شود. (https://developers.google.com/cast/support) با مسئولیت خودتان از آن استفاده کنید.

skipMplLoad

(بولی یا تعریف‌نشده)

اگر درست باشد، از بار کردن پخش‌کننده MPL توسط گیرنده جلوگیری می‌کند.

skipPlayersLoad

(بولی یا تعریف‌نشده)

اگر درست باشد، از بار کردن کتابخانه‌های MPL یا Shaka player توسط گیرنده جلوگیری می‌کند. معادل تنظیم هر دو skipMplLoad و skipShakaLoad روی true.

skipShakaLoad

(بولی یا تعریف‌نشده)

اگر درست باشد، از بار کردن پخش‌کننده Shaka توسط گیرنده جلوگیری می‌کند.

statusText

(رشته یا تعریف‌نشده)

نوشتاری که وضعیت درخواست را نشان می‌دهد. این رشته باید از قوانین بین‌المللی‌سازی پیروی کند، زیرا ممکن است توسط برنامه فرستنده نمایش داده شود.

supportedCommands

(عدد یا تعریف‌نشده)

ماسک بیتی فرمان‌های رسانه که برنامه از آن‌ها پشتیبانی می‌کند. 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

(بولی یا تعریف‌نشده)

اگر 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

(عدد یا تعریف‌نشده)

عدد صحیحی که به‌عنوان شماره نسخه داخلی برای نشان دادن نسخه گیرنده شما استفاده می‌شود. این شماره فقط برای تشخیص نسخه‌های پخش گیرنده هنگام جمع‌آوری سنجه‌ها استفاده می‌شود. این مقدار باید با هر انتشار افزایش یابد و درصورت بازگشت به نسخه قبلی، به آن انتشار محدود بماند.