کلاس: رسانه

کروم قالب . رسانه ها . رسانه ها

کلاس ایستا

نشان دهنده یک آیتم رسانه ای است که در برنامه گیرنده بارگذاری شده است.

سازنده

رسانه ها

رسانه جدید (sessionId، mediaSessionId)

پارامتر
شناسه جلسه	رشته شناسه جلسه
mediaSessionId	عدد شناسه رسانه

خواص

activeTrackIds

nullable آرایه اعداد

لیست شناسه های مربوط به آهنگ های فعال.

وضعیت شکست

(غیر تهی chrome.cast.media.BreakStatus یا تعریف نشده)

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

CurrentItemId

عدد پوچ

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

زمان جاری

عدد

موقعیت پخش فعلی در چند ثانیه از زمان شروع رسانه. این عضو فقط به صورت پراکنده به روز می شود، بنابراین مقدار آن اغلب قدیمی است. از روش getEstimatedTime برای به دست آوردن تخمینی از موقعیت پخش واقعی بر اساس آخرین اطلاعات گزارش شده توسط گیرنده استفاده کنید.

منسوخ

به جای آن از getEstimatedTime استفاده کنید.

داده های سفارشی

شیء پوچ

مجموعه داده های سفارشی توسط برنامه گیرنده.

idleReason

chrome.cast.media.IdleReason قابل پاک کردن

دلیل بیکار اگر گیرنده بداند.

موارد

nullable آرایه chrome.cast.media.QueueItem غیر تهی

آرایه ای از موارد مرتب شده در صف.

liveSeekableRange

( chrome.cast.media.LiveSeekableRange غیر تهی یا تعریف نشده)

محدوده قابل جستجوی یک جریان زنده یا رویداد. از زمان نسبی رسانه در ثانیه استفاده می کند. برای جریان های VOD تعریف نشده خواهد بود.

loadingItemId

عدد پوچ

شناسه مورد موردی که در حال حاضر در گیرنده بارگیری می شود. اگر هیچ موردی در حال بارگیری نباشد، تهی است.

رسانه ها

chrome.cast.media.MediaInfo قابل پوچ کردن

توضیحات رسانه

mediaSessionId

عدد

آیتم رسانه ای را شناسایی می کند.

میزان پخش

عدد

نرخ پخش 1.0 نشان دهنده پخش عادی است.

بازیکن ایالت

chrome.cast.media.PlayerState غیر تهی

وضعیت بازیکن

از پیش بارگذاری شدهItemId

عدد پوچ

شناسه مورد بعدی، فقط در صورتی موجود است که از قبل بارگذاری شده باشد. آیتم های رسانه گیرنده را می توان از قبل بارگذاری کرد و به طور موقت در حافظه پنهان کرد، بنابراین وقتی بعداً بارگذاری می شوند، روند سریعتر انجام می شود (زیرا رسانه لازم نیست از شبکه واکشی شود).

صف داده ها

(غیر تهی chrome.cast.media.QueueData یا تعریف نشده)

داده های صف

حالت تکرار

chrome.cast.media.RepeatMode غیر پوچ

حالت تکرار برای پخش صف.

شناسه جلسه

رشته

جلسه ای را که میزبان رسانه است مشخص می کند.

Commands Media پشتیبانی کرد

آرایه غیر تهی از chrome.cast.media.MediaCommand غیر تهی

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

اطلاعات ویدیویی

(غیر تهی chrome.cast.media.VideoInformation یا تعریف نشده)

اطلاعات ویدیویی

جلد

chrome.cast.Volume غیر تهی

حجم جریان رسانه volume.level و volume.muted همیشه تنظیم خواهند شد.

مواد و روش ها

addUpdateListener

addUpdateListener(شنونده)

شنونده ای اضافه می کند که وقتی وضعیت رسانه تغییر کرده است فراخوانی می شود. تغییرات در ویژگی‌های زیر شنونده را فعال می‌کند: currentTime، حجم، فراداده، نرخ پخش، PlayState، CustomData. تماس موفق با روش getStatus رسانه نیز شنونده را تحریک می کند.

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

editTracksInfo

editTracksInfo(editTracksInfoRequest, successCallback, errorCallback)

سبک آهنگ های متنی را تغییر می دهد یا وضعیت آهنگ ها را تغییر می دهد. اگر یک trackId با trackId های موجود مطابقت نداشته باشد، کل درخواست با شکست مواجه می شود و هیچ وضعیتی تغییر نمی کند.

پارامتر
editTracksInfoRequest	chrome.cast.media.EditTracksInfoRequest مقدار نباید صفر باشد.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

getEstimatedBreakClipTime

getEstimatedBreakClipTime() برمی گرداند (تعداد یا تعریف نشده)

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

برمی گرداند

(number or undefined) تخمینی از موقعیت کلیپ شکسته فعلی در چند ثانیه از زمان شروع رسانه. در صورتی که breakStatus یا currentBreakClipTime تعریف نشده باشد، تعریف نشده باز خواهد گشت.

getEstimatedBreakTime

getEstimatedBreakTime() برمی گرداند (تعداد یا تعریف نشده)

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

برمی گرداند

(number or undefined) تخمینی از موقعیت شکست فعلی در چند ثانیه از زمان شروع رسانه. اگر breakStatus یا currentBreakTime تعریف نشده باشد (زمانی که استراحت پخش نمی شود) تعریف نشده برمی گردد.

getEstimatedLiveSeekableRange

getEstimatedLiveSeekableRange() را برمی گرداند ( chrome.cast.media.LiveSeekableRange یا تعریف نشده)

بر اساس آخرین اطلاعات گزارش شده توسط گیرنده، شروع liveSeekableRange را در چند ثانیه تخمین می زند.

برمی گرداند

(non-null chrome.cast.media.LiveSeekableRange or undefined) برآوردی از liveSeekableRange فعلی. اگر liveSeekableRange، liveSeekableRange.start، یا liveSeekableRange.end زمانی که محتوا زنده نباشد، تعریف نشده باز خواهد گشت.

getEstimatedTime

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

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

برمی گرداند

number تخمینی از موقعیت پخش فعلی در چند ثانیه از زمان شروع پخش رسانه.

getStatus

getStatus (getStatusRequest، successCallback، errorCallback)

وضعیت مورد رسانه را از برنامه گیرنده دریافت می کند.

همراه با موفقیت Callback داده شده، هر شنونده به روز رسانی رسانه اضافه شده نیز هنگام دریافت وضعیت از برنامه گیرنده فراخوانی می شود. به‌جای فراخوانی این روش برای نظرسنجی وضعیت رسانه، برنامه‌ها ترجیح می‌دهند هر زمان که رسانه تغییر می‌کند، به فراخوانی خودکار شنوندگان به‌روزرسانی رسانه تکیه کنند.

پارامتر
getStatusRequest	chrome.cast.media.GetStatusRequest درخواست وضعیت اختیاری دریافت.
موفقیت تماس برگشتی	تابع() هنگام دریافت وضعیت از برنامه گیرنده فراخوانی می شود.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

مکث

مکث (مکث درخواست، موفقیت پاسخ به تماس، پاسخ تماس خطا)

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

پارامتر
درخواست مکث	chrome.cast.media.PauseRequest
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. درخواست توقف رسانه خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

بازی

پخش (پخش درخواست، موفقیت پاسخ تماس، خطای تماس)

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

پارامتر
playRequest	chrome.cast.media.PlayRequest درخواست پخش رسانه اختیاری.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

queueAppendItem

queueAppendItem (مورد، موفقیت تماس، پاسخ تماس خطا)

یک آیتم رسانه ای جدید به انتهای صف اضافه می کند.

پارامتر
مورد	chrome.cast.media.QueueItem موردی که باید به انتهای صف اضافه شود. مقدار نباید صفر باشد.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

queueInsertItems

queueInsertItems (queueInsertItemsRequest، successCallback، errorCallback)

لیستی از آیتم های رسانه جدید را در صف قرار می دهد.

پارامتر
queueInsertItemsRequest	chrome.cast.media.QueueInsertItemsRequest درخواست درج موارد رسانه در صف رسانه. مقدار نباید صفر باشد.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

queueJumpToItem

queueJumpToItem (ItemId، successCallback، errorCallback)

مورد را با itemId در صف پخش می کند.

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

پارامتر
شناسه مورد	عدد شناسه موردی که باید به آن پرش کنید.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

queueMoveItemToNewIndex

queueMoveItemToNewIndex(itemId، newIndex، successCallback، errorCallback)

مورد را با itemId در موقعیت newIndex در صف قرار می دهد.

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

errorCallback در صورت منفی بودن newIndex فراخوانی می شود. با این حال، اگر newIndex سرریز شود، یا به این دلیل که به اشتباه مشخص شده است یا صف توسط فرستنده دیگری کوچک شده است، مورد به انتهای صف منتقل می شود.

پارامتر
شناسه مورد	عدد شناسه موردی که قرار است منتقل شود.
newIndex	عدد نمایه جدید آیتم.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

صف بعدی

queueNext (successCallback, error Callback)

به آیتم بعدی در صف می پرد.

پارامتر
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

صف قبلی

queuePrev (successCallback, error Callback)

به آیتم قبلی در صف می پرد.

پارامتر
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

queueRemoveItem

queueRemoveItem (ItemId، successCallback، error Callback)

مورد با itemId را از صف حذف می کند.

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

پارامتر
شناسه مورد	عدد شناسه موردی که باید حذف شود.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

queueReorderItems

queueReorderItems (queueReorderItemsRequest, successCallback, errorCallback)

فهرستی از آیتم های رسانه در صف را دوباره ترتیب دهید.

پارامتر
queueReorderItemsRequest	chrome.cast.media.QueueReorderItemsRequest درخواست برای سفارش مجدد اقلام در صف رسانه. مقدار نباید صفر باشد.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

queueSetRepeatMode

queueSetRepeatMode (RepeatMode، successCallback، errorCallback)

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

پارامتر
حالت تکرار	chrome.cast.media.RepeatMode الگوریتم انتخاب مورد بعدی پس از پایان آیتم فعلی. مقدار نباید صفر باشد.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

صف UpdateItems

queueUpdateItems (queueUpdateItemsRequest, successCallback, errorCallback)

ویژگی های صف رسانه، به عنوان مثال حالت تکرار، و ویژگی های موارد موجود در صف رسانه را به روز می کند.

پارامتر
queueUpdateItemsRequest	chrome.cast.media.QueueUpdateItemsRequest درخواست به روز رسانی ویژگی های صف رسانه. مقدار نباید صفر باشد.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

removeUpdateListener

removeUpdateListener(شنونده)

شنونده ای را که قبلاً برای این رسانه اضافه شده است حذف می کند.

پارامتر
شنونده	تابع (بولی) شنونده برای حذف.

به دنبال

seek (seekRequest, success Callback, error Callback)

به دنبال آیتم رسانه ای است.

پارامتر
seekRequest	chrome.cast.media.SeekRequest رسانه ها به دنبال درخواست هستند. مقدار نباید صفر باشد.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

تنظیم حجم

setVolume (volumeRequest، successCallback، error Callback)

حجم جریان رسانه را تنظیم می کند. حداقل یکی از volumeRequest.level یا volumeRequest.muted باید تنظیم شود. تغییر حالت بی صدا بر سطح صدا تأثیر نمی گذارد و بالعکس.

پارامتر
حجم درخواست	chrome.cast.media.VolumeRequest درخواست حجم تنظیم شده مقدار نباید صفر باشد.
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

متوقف کردن

توقف (stopRequest، successCallback، error Callback)

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

پارامتر
stopRequest	chrome.cast.media.StopRequest درخواست توقف
موفقیت تماس برگشتی	تابع() به موفقیت استناد کرد.
errorCallback	تابع (غیر تهی chrome.cast. خطا ) بر روی خطا احضار شد. خطاهای احتمالی عبارتند از TIMEOUT، API_NOT_INITIALIZED، INVALID_PARAMETER، CHANNEL_ERROR، SESSION_ERROR، و EXTENSION_MISSING.

پشتیبانی از فرمان

supportsCommand(command) بولی را برمی گرداند

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

پارامتر
فرمان	chrome.cast.media.MediaCommand دستور پرس و جو مقدار نباید صفر باشد.

برمی گرداند

اگر پخش کننده از دستور پشتیبانی کند boolean درست است.