پخش رسانه را کنترل و نظارت می کند.
- پرتاب می کند
non-null Error
اگر سازنده مستقیماً استفاده شود.PlayerManager
فقط باید با فراخوانی cast.framework.CastReceiverContext#getPlayerManager قابل دسترسی باشد.
addEventListener (EventType، eventListener)
یک شنونده رویداد اضافه می کند که به رویدادهای پخش گوش می دهد.
رویداد نوع | ( cast.framework.events.EventType یا غیر تهی آرایه cast.framework.events.EventType غیر تهی) یک نوع رویداد یا آرایه ای از انواع رویداد |
رویدادListener | تابع ( cast.framework.events.Event غیر تهی) |
- پرتاب می کند
non-null Error
اگر آرگومان های داده شده معتبر نباشند.
addSupportedMediaCommands (Commands Media پشتیبانی شده، وضعیت پخش)
دستورات جدید پشتیبانی شده را به لیست موجود دستورات رسانه پشتیبانی شده اضافه می کند.
Commands Media پشتیبانی کرد | عدد بیت ماسکی از دستورات رسانه ای که توسط برنامه پشتیبانی می شود. |
وضعیت پخش | اختیاری بولی |
- همچنین ببینید
- cast.framework.messages.Command
وضعیت پخش (شامل رسانه، شناسه درخواست، دادههای سفارشی، شامل آیتمهایQueue)
یک پیام وضعیت رسانه را برای همه فرستندگان ارسال می کند (پخش شده). برنامه ها از این برای ارسال یک تغییر حالت سفارشی استفاده می کنند.
شامل رسانه ها | اختیاری بولی |
درخواست شناسه | اختیاری عدد شناسه درخواست ورودی که باعث این پاسخ شده است. |
داده های سفارشی | اختیاری هدف - شی پیام وضعیت داده های سفارشی ویژه برنامه. مقدار ممکن است صفر باشد. |
شاملQueueItems | اختیاری بولی آیا موارد صف در پیام وضعیت لحاظ شود یا خیر. به طور پیش فرض آنها شامل نمی شوند. |
getAbsoluteTimeForMediaTime(mediaTime) عدد را برمیگرداند
زمان رسانه را به زمان مطلق رسانه تبدیل می کند. زمان مطلق فقط برای پخشهای زنده قابل اعمال است.
mediaTime | عدد زمان رسانه |
- برمی گرداند
nullable number
زمان مطلق یاnull
اگر در دسترس نباشد.
getAudioTracksManager() cast.framework.AudioTracksManager را برمی گرداند
نمونه AudioTracksManager
را دریافت می کند.
- برمی گرداند
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec() عدد را برمی گرداند
زمان فعلی کلیپ استراحت در حال پخش را در چند ثانیه برمیگرداند.
- برمی گرداند
nullable number
زمان فعلی بر حسب ثانیه در کلیپ شکست فعلی. زمانی کهPlayer
کلیپ استراحت را پخش نمی کند،null
.
getBreakClipDurationSec() عدد را برمی گرداند
مدت زمان کلیپ استراحت در حال پخش را بر حسب ثانیه برمی گرداند.
- برمی گرداند
nullable number
مدت زمان کلیپ شکست فعلی. زمانی کهPlayer
کلیپ استراحتی را پخش نمی کند،null
.
getBreakManager() cast.framework.breaks.BreakManager را برمی گرداند.
نمونه BreakManager
دریافت می کند.
- برمی گرداند
non-null cast.framework.breaks.BreakManager
getBreaks() آرایه ای از cast.framework.messages.Break غیر تهی را برمی گرداند.
فهرستی از وقفه ها را برمی گرداند.
- برمی گرداند
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands() شماره را برمی گرداند
دستورات رسانه ای پشتیبانی شده از گیرنده فعلی را دریافت می کند. برخلاف getSupportedMediaCommands()
، مقدار برگشتی این روش به صورت پویا بر اساس وضعیت پخش فعلی تغییر می کند. به عنوان مثال، در حین پخش تبلیغات، ممکن است دستور SEEK
پشتیبانی نشود. این روش فقط باید پس از فراخوانی گیرنده CastReceiverContext#start
فراخوانی شود، در غیر این صورت 0
برمی گردد.
- همچنین ببینید
- cast.framework.messages.Command
- برمی گرداند
number
یک بیت ماسک از دستورات رسانه ای که توسط برنامه پشتیبانی می شود.
getCurrentTimeSec() عدد را برمی گرداند
زمان پخش سپری شده رسانه فعلی را دریافت می کند.
- برمی گرداند
number
زمان سپری شده، بر حسب ثانیه. اگر رسانه ای پخش نشود، این0
خواهد بود.
getDurationSec() عدد را برمی گرداند
مدت زمان پخش رسانه در حال پخش را بر حسب ثانیه دریافت می کند.
- برمی گرداند
number
مدت زمان رسانه.NaN
اگر رسانه ای پخش نمی شود.
getLiveSeekableRange() cast.framework.messages.LiveSeekableRange را برمی گرداند
محدوده قابل جستجوی زنده را با زمان شروع و زمان پایان در چند ثانیه برمیگرداند. ارزش ها بر اساس زمان رسانه ای است.
- برمی گرداند
getMediaInformation() cast.framework.messages.MediaInformation را برمی گرداند
اطلاعات رسانه ای رسانه فعلی را دریافت می کند.
- برمی گرداند
getMediaTimeForAbsoluteTime(absoluteTime) عدد را برمی گرداند
زمان مطلق رسانه را به زمان رسانه ای تبدیل می کند. زمان مطلق فقط برای پخشهای زنده قابل اعمال است.
absoluteTime | عدد زمان مطلق رسانه، به عنوان زمان یونیکس (ثانیه از دوران یونیکس). |
- برمی گرداند
nullable number
رسانه زمان یاnull
اگر در دسترس نباشد.
getPlaybackConfig() cast.framework.PlaybackConfig را برمی گرداند
اگر پیشفرضها لغو نشده باشند، پیکربندی پخش را برمیگرداند یا null
.
- برمی گرداند
nullable cast.framework.PlaybackConfig
getPlaybackRate() عدد را برمی گرداند
نرخ پخش فعلی را برمیگرداند. 1
را قبل از فراخوانی گیرنده CastReceiverContext#start
برمیگرداند.
- برمی گرداند
number
نرخ پخش فعلی.
getPlayerState() cast.framework.messages.PlayerState را برمی گرداند
حالت Player
را دریافت می کند.
- برمی گرداند
non-null cast.framework.messages.PlayerState
وضعیتPlayer
فعلی.
getPreferredPlaybackRate() عدد را برمی گرداند
نرخ پخش ترجیحی را دریافت کنید. می توان از آن در رویداد خاموش شدن برای ذخیره آخرین نرخ پخش ترجیحی در فضای ذخیره سازی مداوم استفاده کرد، بنابراین می توان از آن در جلسه بعدی در گزینه های پخش استفاده کرد.
- برمی گرداند
number
getPreferredTextLanguage() رشته را برمی گرداند
زبان تراک متن ترجیحی را دریافت می کند.
- برمی گرداند
nullable string
getPreferredTextStyle() cast.framework.messages.TextTrackStyle را برمی گرداند
سبک آهنگ متن ترجیحی را دریافت می کند.
- برمی گرداند
getQueueManager() برمی گرداند ( cast.framework.QueueManager یا تعریف نشده)
نمونه QueueManager
را دریافت می کند.
- برمی گرداند
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec() عدد را برمی گرداند
زمان پخش سپری شده رسانه فعلی را بدون کم کردن زمان استراحت آگهی دریافت می کند.
- برمی گرداند
number
زمان سپری شده، بر حسب ثانیه. اگر رسانه ای پخش نشود، این0
خواهد بود.
getStartAbsoluteTime() عدد را برمی گرداند
زمان شروع مطلق رسانه را به عنوان زمان یونیکس (ثانیه از زمان یونیکس) دریافت می کند. زمان مطلق فقط برای پخشهای زنده قابل اعمال است.
- برمی گرداند
nullable number
getStats() cast.framework.stats.Stats را برمی گرداند
آمار پخش را برمی گرداند. در صورت لزوم، آمار در کل جلسه پخش جمع می شود.
- برمی گرداند
non-null cast.framework.stats.Stats
getSupportedMediaCommands() شماره را برمی گرداند
دستورات رسانه ای پشتیبانی شده از گیرنده را دریافت می کند. فقط باید پس از فراخوانی CastReceiverContext#start()
فراخوانی شود، در غیر این صورت 0
را برمی گرداند. مقدار دستورات رسانه پشتیبانی شده فقط توسط برنامه گیرنده کنترل می شود. بر اساس MediaStatus
به طور خودکار به روز نمی شود.
- همچنین ببینید
- cast.framework.messages.Command
- برمی گرداند
number
یک بیت ماسک از دستورات رسانه ای که توسط برنامه پشتیبانی می شود.
getTextTracksManager() cast.framework.TextTracksManager را برمی گرداند
نمونه TextTracksManager
را دریافت می کند.
- برمی گرداند
non-null cast.framework.TextTracksManager
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(eventType، eventListener)
شنونده رویداد اضافه شده برای یک رویداد پخش معین را حذف می کند. اگر شنونده رویداد منطبقی وجود نداشته باشد، این تماس نادیده گرفته می شود.
رویداد نوع | ( cast.framework.events.EventType یا غیر تهی آرایه cast.framework.events.EventType غیر تهی) رویداد نوع یا آرایه ای از انواع رویداد |
رویدادListener | تابع ( cast.framework.events.Event غیر تهی) |
removeSupportedMediaCommands (پشتیبانی شده از دستورات رسانه، وضعیت پخش)
دستورات را از لیست دستورات رسانه پشتیبانی شده حذف کنید.
Commands Media پشتیبانی کرد | عدد بیت ماسکی از دستورات رسانه ای که توسط برنامه پشتیبانی می شود. |
وضعیت پخش | اختیاری بولی |
- همچنین ببینید
- cast.framework.messages.Command
جستجو (seekTime)
در رسانه های فعلی جستجو می کند.
seekTime | عدد |
sendCustomState(state)
یک حالت سفارشی را از منطق پخش برنامه به منطق UI ارسال می کند. این روش به جداسازی منطق پخش و رابط کاربری کمک می کند. حفظ جدایی بین منطق و رابط کاربری به فرد اجازه می دهد تا از منطق رابط کاربری یکسانی برای پخش محلی و کنترل از راه دور استفاده کند. حالت سفارشی ارسال شده توسط این روش برای رابط کاربری از طریق PlayerData
در دسترس است.
حالت | هدف - شی شیء حالت سفارشی. مقدار نباید صفر باشد. |
- همچنین ببینید
- cast.framework.ui.PlayerData#customState
sendError(senderId, requestId, type, reason, customData)
یک خطا را برای فرستنده خاصی ارسال می کند.
شناسه فرستنده | رشته شناسه فرستنده |
درخواست شناسه | عدد شناسه درخواست ورودی که باعث این خطا شده است. |
نوع | cast.framework.messages.ErrorType نوع خطا مقدار نباید صفر باشد. |
دلیل | اختیاری cast.framework.messages.ErrorReason دلیل خطا مقدار ممکن است صفر باشد. |
داده های سفارشی | اختیاری هدف - شی پیام خطا داده های سفارشی خاص برنامه. مقدار ممکن است صفر باشد. |
sendLocalMediaRequest(درخواست)
درخواست رسانه محلی را ارسال می کند.
درخواست | cast.framework.messages.RequestData مقدار نباید صفر باشد. |
sendStatus (senderId، requestId، includeMedia، customData، includeQueueItems)
پیام وضعیت رسانه را به فرستنده خاصی ارسال می کند.
شناسه فرستنده | رشته شناسه فرستنده |
درخواست شناسه | عدد شناسه درخواست ورودی که باعث این پاسخ شده است. |
شامل رسانه ها | اختیاری بولی |
داده های سفارشی | اختیاری هدف - شی پیام وضعیت داده های سفارشی ویژه برنامه. مقدار ممکن است صفر باشد. |
شاملQueueItems | اختیاری بولی آیا موارد صف در پیام وضعیت لحاظ شود یا خیر. به طور پیش فرض آنها شامل نمی شوند. |
setIdleReason(idleReason)
دلیل قرار گرفتن پخش کننده در حالت IDLE
را تعیین می کند. این اجازه می دهد تا برنامه هایی که می خواهند وضعیت IDLE
را مجبور کنند دلیل انجام این کار را نشان دهند (به عنوان مثال، یک خطای سفارشی). دلیل بیکاری در پیام وضعیت بعدی ارسال می شود. توجه بیشتر برنامه ها نیازی به تنظیم این مقدار ندارند. تنها زمانی مورد نیاز است که برنامه نیاز داشته باشد که Player
در شرایط خاص به حالت IDLE
برود و idleReason پیشفرض رفتار مورد نظر را منعکس نکند.
idleReason | cast.framework.messages.IdleReason دلیل قرار گرفتن در حالت مقدار نباید صفر باشد. |
setMediaElement(mediaElement)
HTMLMediaElement
را برای استفاده تنظیم می کند. اگر یک Promise
of a HTMLMediaElement
تنظیم شده باشد، پس از حل شدن Promise
پخش رسانه شروع می شود.
mediaElement | (HTMLMediaElement غیر تهی یا وعده غیر تهی حاوی HTMLMediaElement غیر تهی) |
setMediaInformation(mediaInformation، opt_broadcast)
اطلاعات رسانه را تنظیم می کند.
اطلاعات رسانه ای | cast.framework.messages.MediaInformation مقدار نباید صفر باشد. |
opt_broadcast | اختیاری بولی |
setMediaPlaybackInfoHandler(handler)
یک کنترل کننده را تنظیم می کند تا cast.framework.PlaybackConfig را برای یک درخواست بار خاص برگرداند یا تغییر دهد. پارامترهای کنترل کننده LoadRequestData
و PlaybackConfig
پیش فرض برای گیرنده هستند (در CastReceiverOptions
ارائه شده است). کنترل کننده باید یک پیکربندی پخش اصلاح شده یا null
برگرداند تا از پخش رسانه جلوگیری کند. مقدار بازگشتی نیز ممکن است یک Promise
باشد که امکان انتظار برای داده از سرور را فراهم می کند.
کنترل کننده | تابع ( cast.framework.messages.LoadRequestData غیر تهی، cast.framework غیر تهی.PlaybackConfig) تابعی برای ارائه یک درخواست خاص پیکربندی پخش. مقدار ممکن است صفر باشد. |
setMediaUrlResolver(Resolver)
یک کنترل کننده را تنظیم می کند تا URL رسانه را برای درخواست LOAD
برگرداند. از این کنترل کننده می توان برای جلوگیری از انتشار URL محتوای رسانه به عنوان بخشی از وضعیت رسانه استفاده کرد. به طور پیش فرض، Media contentId
به عنوان URL محتوا استفاده می شود.
حل کننده | تابع ( cast.framework.messages.LoadRequestData غیر تهی) تابعی برای حل و فصل URL محتوای رسانه. مقدار ممکن است صفر باشد. |
setMessageInterceptor (نوع، رهگیر)
رهگیر پیام های ورودی و خروجی را تنظیم می کند. رهگیر میتواند دادههای درخواست را بهروزرسانی کند، و باید دادههای بهروزرسانی شده، یک Promise
با دادههای بهروز شده (اگر دادهها نمیتوانند فوراً برگردانده شوند)، یا اگر درخواست رسیدگی نشود، null
. توجه : اگر یک رهگیر پیام LOAD
ارائه شود، اما رهگیر PRELOAD
جداگانه ارائه نشده باشد، رهگیر LOAD
برای پیام های PRELOAD
فراخوانی می شود.
نوع | cast.framework.messages.MessageType مقدار نباید صفر باشد. |
رهگیر | تابع ( cast.framework.messages.RequestData غیر تهی) مقدار ممکن است صفر باشد. |
setPlaybackConfig (playbackConfig)
پیکربندی پخش را در PlayerManager
تنظیم می کند.
playbackConfig | مقدار نباید صفر باشد. |
setSupportedMediaCommands (پشتیبانی از دستورات رسانه، وضعیت پخش)
دستورات رسانه پشتیبانی شده توسط گیرنده را تنظیم می کند.
Commands Media پشتیبانی کرد | عدد بیت ماسکی از دستورات رسانه ای که توسط برنامه پشتیبانی می شود. |
وضعیت پخش | اختیاری بولی |
- همچنین ببینید
- cast.framework.messages.Command
متوقف کردن()
رسانه در حال پخش را متوقف می کند.