کلاس: PlayerManager

قالب. چارچوب . PlayerManager

کلاس ایستا

پخش رسانه را کنترل و نظارت می کند.

پرتاب می کند

non-null Error اگر سازنده مستقیماً استفاده شود. PlayerManager فقط باید با فراخوانی cast.framework.CastReceiverContext#getPlayerManager قابل دسترسی باشد.

مواد و روش ها

addEventListener

addEventListener (EventType، eventListener)

یک شنونده رویداد اضافه می کند که به رویدادهای پخش گوش می دهد.

پارامتر
رویداد نوع	( cast.framework.events.EventType یا غیر تهی آرایه cast.framework.events.EventType غیر تهی) یک نوع رویداد یا آرایه ای از انواع رویداد
رویدادListener	تابع ( cast.framework.events.Event غیر تهی)

پرتاب می کند

non-null Error اگر آرگومان های داده شده معتبر نباشند.

addSupportedMediaCommands

addSupportedMediaCommands (Commands Media پشتیبانی شده، وضعیت پخش)

دستورات جدید پشتیبانی شده را به لیست موجود دستورات رسانه پشتیبانی شده اضافه می کند.

پارامتر
Commands Media پشتیبانی کرد	عدد بیت ماسکی از دستورات رسانه ای که توسط برنامه پشتیبانی می شود.
وضعیت پخش	اختیاری بولی true نشان می دهد که فرستندگان باید در مورد تغییر مطلع شوند (در صورت عدم ارائه، به فرستنده ها اطلاع داده می شود).

همچنین ببینید

cast.framework.messages.Command

وضعیت پخش

وضعیت پخش (شامل رسانه، شناسه درخواست، داده‌های سفارشی، شامل آیتم‌هایQueue)

یک پیام وضعیت رسانه را برای همه فرستندگان ارسال می کند (پخش شده). برنامه ها از این برای ارسال یک تغییر حالت سفارشی استفاده می کنند.

پارامتر
شامل رسانه ها	اختیاری بولی true نشان می دهد که پیام باید شامل اطلاعات رسانه باشد.
درخواست شناسه	اختیاری عدد شناسه درخواست ورودی که باعث این پاسخ شده است.
داده های سفارشی	اختیاری هدف - شی پیام وضعیت داده های سفارشی ویژه برنامه. مقدار ممکن است صفر باشد.
شاملQueueItems	اختیاری بولی آیا موارد صف در پیام وضعیت لحاظ شود یا خیر. به طور پیش فرض آنها شامل نمی شوند.

getAbsoluteTimeForMediaTime

getAbsoluteTimeForMediaTime(mediaTime) عدد را برمی‌گرداند

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

پارامتر
mediaTime	عدد زمان رسانه

برمی گرداند

nullable number زمان مطلق یا null اگر در دسترس نباشد.

getAudioTracksManager

getAudioTracksManager() cast.framework.AudioTracksManager را برمی گرداند

نمونه AudioTracksManager را دریافت می کند.

برمی گرداند

non-null cast.framework.AudioTracksManager

getBreakClipCurrentTimeSec

getBreakClipCurrentTimeSec() عدد را برمی گرداند

زمان فعلی کلیپ استراحت در حال پخش را در چند ثانیه برمی‌گرداند.

برمی گرداند

nullable number زمان فعلی بر حسب ثانیه در کلیپ شکست فعلی. زمانی که Player کلیپ استراحت را پخش نمی کند، null .

getBreakClipDurationSec

getBreakClipDurationSec() عدد را برمی گرداند

مدت زمان کلیپ استراحت در حال پخش را بر حسب ثانیه برمی گرداند.

برمی گرداند

nullable number مدت زمان کلیپ شکست فعلی. زمانی که Player کلیپ استراحتی را پخش نمی کند، null .

getBreakManager

getBreakManager() cast.framework.breaks.BreakManager را برمی گرداند.

نمونه BreakManager دریافت می کند.

برمی گرداند

non-null cast.framework.breaks.BreakManager

getBreaks

getBreaks() آرایه ای از cast.framework.messages.Break غیر تهی را برمی گرداند.

فهرستی از وقفه ها را برمی گرداند.

برمی گرداند

non-null Array of non-null cast.framework.messages.Break

getCurrentSupportedMediaCommands

getCurrentSupportedMediaCommands() شماره را برمی گرداند

دستورات رسانه ای پشتیبانی شده از گیرنده فعلی را دریافت می کند. برخلاف getSupportedMediaCommands() ، مقدار برگشتی این روش به صورت پویا بر اساس وضعیت پخش فعلی تغییر می کند. به عنوان مثال، در حین پخش تبلیغات، ممکن است دستور SEEK پشتیبانی نشود. این روش فقط باید پس از فراخوانی گیرنده CastReceiverContext#start فراخوانی شود، در غیر این صورت 0 برمی گردد.

همچنین ببینید

cast.framework.messages.Command

برمی گرداند

number یک بیت ماسک از دستورات رسانه ای که توسط برنامه پشتیبانی می شود.

getCurrentTimeSec

getCurrentTimeSec() عدد را برمی گرداند

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

برمی گرداند

number زمان سپری شده، بر حسب ثانیه. اگر رسانه ای پخش نشود، این 0 خواهد بود.

getDurationSec

getDurationSec() عدد را برمی گرداند

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

برمی گرداند

number مدت زمان رسانه. NaN اگر رسانه ای پخش نمی شود.

getLiveSeekableRange

getLiveSeekableRange() cast.framework.messages.LiveSeekableRange را برمی گرداند

محدوده قابل جستجوی زنده را با زمان شروع و زمان پایان در چند ثانیه برمی‌گرداند. ارزش ها بر اساس زمان رسانه ای است.

برمی گرداند

nullable cast.framework.messages.LiveSeekableRange

getMediaInformation

getMediaInformation() cast.framework.messages.MediaInformation را برمی گرداند

اطلاعات رسانه ای رسانه فعلی را دریافت می کند.

برمی گرداند

nullable cast.framework.messages.MediaInformation

getMediaTimeForAbsoluteTime

getMediaTimeForAbsoluteTime(absoluteTime) عدد را برمی گرداند

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

پارامتر
absoluteTime	عدد زمان مطلق رسانه، به عنوان زمان یونیکس (ثانیه از دوران یونیکس).

برمی گرداند

nullable number رسانه زمان یا null اگر در دسترس نباشد.

getPlaybackConfig

getPlaybackConfig() cast.framework.PlaybackConfig را برمی گرداند

اگر پیش‌فرض‌ها لغو نشده باشند، پیکربندی پخش را برمی‌گرداند یا null .

برمی گرداند

nullable cast.framework.PlaybackConfig

getPlaybackRate

getPlaybackRate() عدد را برمی گرداند

نرخ پخش فعلی را برمی‌گرداند. 1 را قبل از فراخوانی گیرنده CastReceiverContext#start برمی‌گرداند.

برمی گرداند

number نرخ پخش فعلی.

getPlayerState

getPlayerState() cast.framework.messages.PlayerState را برمی گرداند

حالت Player را دریافت می کند.

برمی گرداند

non-null cast.framework.messages.PlayerState وضعیت Player فعلی.

getPreferredPlaybackRate

getPreferredPlaybackRate() عدد را برمی گرداند

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

برمی گرداند

number

getPreferredTextLanguage

getPreferredTextLanguage() رشته را برمی گرداند

زبان تراک متن ترجیحی را دریافت می کند.

برمی گرداند

nullable string

getPreferredTextStyle

getPreferredTextStyle() cast.framework.messages.TextTrackStyle را برمی گرداند

سبک آهنگ متن ترجیحی را دریافت می کند.

برمی گرداند

nullable cast.framework.messages.TextTrackStyle

getQueueManager

getQueueManager() برمی گرداند ( cast.framework.QueueManager یا تعریف نشده)

نمونه QueueManager را دریافت می کند.

برمی گرداند

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

getRawCurrentTimeSec

getRawCurrentTimeSec() عدد را برمی گرداند

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

برمی گرداند

number زمان سپری شده، بر حسب ثانیه. اگر رسانه ای پخش نشود، این 0 خواهد بود.

getStartAbsoluteTime

getStartAbsoluteTime() عدد را برمی گرداند

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

برمی گرداند

nullable number

getStats

getStats() cast.framework.stats.Stats را برمی گرداند

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

برمی گرداند

non-null cast.framework.stats.Stats

getSupportedMediaCommands

getSupportedMediaCommands() شماره را برمی گرداند

دستورات رسانه ای پشتیبانی شده از گیرنده را دریافت می کند. فقط باید پس از فراخوانی CastReceiverContext#start() فراخوانی شود، در غیر این صورت 0 را برمی گرداند. مقدار دستورات رسانه پشتیبانی شده فقط توسط برنامه گیرنده کنترل می شود. بر اساس MediaStatus به طور خودکار به روز نمی شود.

همچنین ببینید

cast.framework.messages.Command

برمی گرداند

number یک بیت ماسک از دستورات رسانه ای که توسط برنامه پشتیبانی می شود.

getTextTracksManager

getTextTracksManager() cast.framework.TextTracksManager را برمی گرداند

نمونه TextTracksManager را دریافت می کند.

برمی گرداند

non-null cast.framework.TextTracksManager

getTimedMetadata

getTimedMetadata() آرایه ای از cast.framework.TimedMetadata غیر تهی را برمی گرداند.

فراداده‌های زمان‌بندی‌شده‌ای را که در طول تجزیه مانیفست با آن مواجه شده‌اند، برمی‌گرداند. این #EXT-X-DATERANGE در HLS و EventStream در DASH است.

برمی گرداند

non-null Array of non-null cast.framework.TimedMetadata

بار

load(loadRequest) Promise حاوی void را برمی گرداند

درخواست بارگیری رسانه را آغاز می کند.

پارامتر
loadRequest	cast.framework.messages.LoadRequestData درخواست برای بارگذاری یک رسانه. مقدار نباید صفر باشد.

برمی گرداند

non-null Promise containing void که با موفقیت عملیات برطرف می شود، یا در صورت شکست رد می شود.

مکث

مکث()

رسانه در حال پخش را متوقف می کند.

بازی

بازی()

رسانه ای را که در حال حاضر متوقف شده است پخش می کند.

removeEventListener

removeEventListener(eventType، eventListener)

شنونده رویداد اضافه شده برای یک رویداد پخش معین را حذف می کند. اگر شنونده رویداد منطبقی وجود نداشته باشد، این تماس نادیده گرفته می شود.

پارامتر
رویداد نوع	( cast.framework.events.EventType یا غیر تهی آرایه cast.framework.events.EventType غیر تهی) رویداد نوع یا آرایه ای از انواع رویداد
رویدادListener	تابع ( cast.framework.events.Event غیر تهی)

removeSupportedMediaCommands

removeSupportedMediaCommands (پشتیبانی شده از دستورات رسانه، وضعیت پخش)

دستورات را از لیست دستورات رسانه پشتیبانی شده حذف کنید.

پارامتر
Commands Media پشتیبانی کرد	عدد بیت ماسکی از دستورات رسانه ای که توسط برنامه پشتیبانی می شود.
وضعیت پخش	اختیاری بولی true نشان می دهد که فرستندگان باید در مورد تغییر مطلع شوند (در صورت عدم ارائه، به فرستنده ها اطلاع داده می شود).

همچنین ببینید

cast.framework.messages.Command

به دنبال

جستجو (seekTime)

در رسانه های فعلی جستجو می کند.

پارامتر
seekTime	عدد

sendCustomState

sendCustomState(state)

یک حالت سفارشی را از منطق پخش برنامه به منطق UI ارسال می کند. این روش به جداسازی منطق پخش و رابط کاربری کمک می کند. حفظ جدایی بین منطق و رابط کاربری به فرد اجازه می دهد تا از منطق رابط کاربری یکسانی برای پخش محلی و کنترل از راه دور استفاده کند. حالت سفارشی ارسال شده توسط این روش برای رابط کاربری از طریق PlayerData در دسترس است.

پارامتر
حالت	هدف - شی شیء حالت سفارشی. مقدار نباید صفر باشد.

همچنین ببینید

cast.framework.ui.PlayerData#customState

sendError

sendError(senderId, requestId, type, reason, customData)

یک خطا را برای فرستنده خاصی ارسال می کند.

پارامتر
شناسه فرستنده	رشته شناسه فرستنده
درخواست شناسه	عدد شناسه درخواست ورودی که باعث این خطا شده است.
نوع	cast.framework.messages.ErrorType نوع خطا مقدار نباید صفر باشد.
دلیل	اختیاری cast.framework.messages.ErrorReason دلیل خطا مقدار ممکن است صفر باشد.
داده های سفارشی	اختیاری هدف - شی پیام خطا داده های سفارشی خاص برنامه. مقدار ممکن است صفر باشد.

sendLocalMediaRequest

sendLocalMediaRequest(درخواست)

درخواست رسانه محلی را ارسال می کند.

پارامتر
درخواست	cast.framework.messages.RequestData مقدار نباید صفر باشد.

وضعیت ارسال

sendStatus (senderId، requestId، includeMedia، customData، includeQueueItems)

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

پارامتر
شناسه فرستنده	رشته شناسه فرستنده
درخواست شناسه	عدد شناسه درخواست ورودی که باعث این پاسخ شده است.
شامل رسانه ها	اختیاری بولی true نشان می دهد که پیام باید شامل یک نمونه MediaInformation باشد.
داده های سفارشی	اختیاری هدف - شی پیام وضعیت داده های سفارشی ویژه برنامه. مقدار ممکن است صفر باشد.
شاملQueueItems	اختیاری بولی آیا موارد صف در پیام وضعیت لحاظ شود یا خیر. به طور پیش فرض آنها شامل نمی شوند.

setIdleReason

setIdleReason(idleReason)

دلیل قرار گرفتن پخش کننده در حالت IDLE را تعیین می کند. این اجازه می دهد تا برنامه هایی که می خواهند وضعیت IDLE را مجبور کنند دلیل انجام این کار را نشان دهند (به عنوان مثال، یک خطای سفارشی). دلیل بیکاری در پیام وضعیت بعدی ارسال می شود. توجه بیشتر برنامه ها نیازی به تنظیم این مقدار ندارند. تنها زمانی مورد نیاز است که برنامه نیاز داشته باشد که Player در شرایط خاص به حالت IDLE برود و idleReason پیش‌فرض رفتار مورد نظر را منعکس نکند.

پارامتر
idleReason	cast.framework.messages.IdleReason دلیل قرار گرفتن در حالت IDLE . مقدار نباید صفر باشد.

setMediaElement

setMediaElement(mediaElement)

HTMLMediaElement را برای استفاده تنظیم می کند. اگر یک Promise of a HTMLMediaElement تنظیم شده باشد، پس از حل شدن Promise پخش رسانه شروع می شود.

پارامتر
mediaElement	(HTMLMediaElement غیر تهی یا وعده غیر تهی حاوی HTMLMediaElement غیر تهی) MediaElement که Player از آن استفاده خواهد کرد.

setMediaInformation

setMediaInformation(mediaInformation، opt_broadcast)

اطلاعات رسانه را تنظیم می کند.

پارامتر
اطلاعات رسانه ای	cast.framework.messages.MediaInformation مقدار نباید صفر باشد.
opt_broadcast	اختیاری بولی

setMediaPlaybackInfoHandler

setMediaPlaybackInfoHandler(handler)

یک کنترل کننده را تنظیم می کند تا cast.framework.PlaybackConfig را برای یک درخواست بار خاص برگرداند یا تغییر دهد. پارامترهای کنترل کننده LoadRequestData و PlaybackConfig پیش فرض برای گیرنده هستند (در CastReceiverOptions ارائه شده است). کنترل کننده باید یک پیکربندی پخش اصلاح شده یا null برگرداند تا از پخش رسانه جلوگیری کند. مقدار بازگشتی نیز ممکن است یک Promise باشد که امکان انتظار برای داده از سرور را فراهم می کند.

پارامتر
کنترل کننده	تابع ( cast.framework.messages.LoadRequestData غیر تهی، cast.framework غیر تهی.PlaybackConfig) تابعی برای ارائه یک درخواست خاص پیکربندی پخش. مقدار ممکن است صفر باشد.

setMediaUrlResolver

setMediaUrlResolver(Resolver)

یک کنترل کننده را تنظیم می کند تا URL رسانه را برای درخواست LOAD برگرداند. از این کنترل کننده می توان برای جلوگیری از انتشار URL محتوای رسانه به عنوان بخشی از وضعیت رسانه استفاده کرد. به طور پیش فرض، Media contentId به عنوان URL محتوا استفاده می شود.

پارامتر
حل کننده	تابع ( cast.framework.messages.LoadRequestData غیر تهی) تابعی برای حل و فصل URL محتوای رسانه. مقدار ممکن است صفر باشد.

setMessageInterceptor

setMessageInterceptor (نوع، رهگیر)

رهگیر پیام های ورودی و خروجی را تنظیم می کند. رهگیر می‌تواند داده‌های درخواست را به‌روزرسانی کند، و باید داده‌های به‌روزرسانی شده، یک Promise با داده‌های به‌روز شده (اگر داده‌ها نمی‌توانند فوراً برگردانده شوند)، یا اگر درخواست رسیدگی نشود، null . توجه : اگر یک رهگیر پیام LOAD ارائه شود، اما رهگیر PRELOAD جداگانه ارائه نشده باشد، رهگیر LOAD برای پیام های PRELOAD فراخوانی می شود.

پارامتر
نوع	cast.framework.messages.MessageType مقدار نباید صفر باشد.
رهگیر	تابع ( cast.framework.messages.RequestData غیر تهی) مقدار ممکن است صفر باشد.

setPlaybackConfig

setPlaybackConfig (playbackConfig)

پیکربندی پخش را در PlayerManager تنظیم می کند.

پارامتر
playbackConfig	cast.framework.PlaybackConfig مقدار نباید صفر باشد.

setSupportedMediaCommands

setSupportedMediaCommands (پشتیبانی از دستورات رسانه، وضعیت پخش)

دستورات رسانه پشتیبانی شده توسط گیرنده را تنظیم می کند.

پارامتر
Commands Media پشتیبانی کرد	عدد بیت ماسکی از دستورات رسانه ای که توسط برنامه پشتیبانی می شود.
وضعیت پخش	اختیاری بولی true نشان می دهد که فرستندگان باید در مورد تغییر مطلع شوند (در صورت عدم ارائه، به فرستنده ها اطلاع داده می شود).

همچنین ببینید

cast.framework.messages.Command

متوقف کردن

متوقف کردن()

رسانه در حال پخش را متوقف می کند.