addEventListener

addEventListener(eventType, eventListener)

تضيف هذه السمة أداة معالجة أحداث ترصد أحداث التشغيل.

الرميات

non-null Error في حال كانت الوسيطات المقدَّمة غير صالحة

addSupportedMediaCommands

addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

تضيف هذه السمة أوامر وسائط جديدة متوافقة إلى قائمة أوامر الوسائط المتوافقة الحالية.

انظر أيضًا

cast.framework.messages.Command

broadcastStatus

broadcastStatus(includeMedia, requestId, customData, includeQueueItems)

يرسل رسالة حالة وسائط إلى جميع المُرسِلين (بث). تستخدم التطبيقات هذا الإجراء لإرسال تغيير مخصّص في الحالة.

getAbsoluteTimeForMediaTime

getAbsoluteTimeForMediaTime(mediaTime) returns number

تحويل وقت الوسائط إلى وقت مطلق للوسائط لا ينطبق الوقت المطلق إلا على أحداث البث المباشر.

المرتجعات

nullable number الوقت المطلق أو null إذا لم يكن متاحًا

getAudioTracksManager

تعرض الدالة getAudioTracksManager() القيمة cast.framework.AudioTracksManager

تعرض هذه السمة مثيل AudioTracksManager.

المرتجعات

non-null cast.framework.AudioTracksManager 

getBreakClipCurrentTimeSec

تعرض الدالة getBreakClipCurrentTimeSec()‎ القيمة number

تعرض هذه السمة الوقت الحالي لمقطع الإعلان أثناء الاستراحة الذي يتم تشغيله حاليًا، وذلك بالثواني.

المرتجعات

‫nullable number الوقت الحالي بالثواني داخل مقطع الإعلان الحالي ‫null عندما لا يتم تشغيل مقطع استراحة Player

getBreakClipDurationSec

تعرض الدالة getBreakClipDurationSec()‎ القيمة number

تعرض هذه السمة مدة مقطع الفاصل الإعلاني الذي يتم تشغيله حاليًا بالثواني.

المرتجعات

nullable number مدة مقطع الإعلان الحالي أثناء الاستراحة ‫null عندما لا يعرض Player مقطع استراحة

getBreakManager

تعرض الدالة getBreakManager() القيمة cast.framework.breaks.BreakManager

تعرض هذه السمة مثيل BreakManager.

المرتجعات

non-null cast.framework.breaks.BreakManager 

getBreaks

getBreaks() returns Array of non-null cast.framework.messages.Break

تعرض هذه الطريقة قائمة بفواصل الأسطر.

المرتجعات

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

getCurrentSupportedMediaCommands

تعرض الدالة getCurrentSupportedMediaCommands()‎ القيمة number

تعرض هذه السمة أوامر الوسائط المتوافقة مع جهاز الاستقبال الحالي. على عكس getSupportedMediaCommands()، تتغيّر القيمة التي تعرضها هذه الطريقة بشكل ديناميكي استنادًا إلى حالة التشغيل الحالية. على سبيل المثال، قد لا يكون الأمر SEEK متاحًا أثناء تشغيل الإعلانات. يجب عدم استدعاء هذه الطريقة إلا بعد استدعاء CastReceiverContext#startالمستلِم، وإلا ستعرض القيمة 0.

انظر أيضًا

cast.framework.messages.Command

المرتجعات

number قناع بتي لأوامر الوسائط التي يتيحها التطبيق.

getCurrentTimeSec

تعرض الدالة getCurrentTimeSec()‎ القيمة number

تعرض هذه السمة وقت التشغيل المنقضي للوسائط الحالية.

المرتجعات

number الوقت المنقضي بالثواني. ستظهر القيمة 0 إذا لم يتم تشغيل أي وسائط.

getDurationSec

تعرض الدالة getDurationSec() القيمة number

تعرض هذه السمة مدة الوسائط التي يتم تشغيلها حاليًا، بالثواني.

المرتجعات

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) تعرض رقمًا

تحويل الوقت المطلق للوسائط إلى وقت الوسائط لا ينطبق الوقت المطلق إلا على أحداث البث المباشر.

المرتجعات

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

الحصول على معدّل التشغيل المفضّل يمكن استخدامها في حدث إيقاف التشغيل لحفظ آخر معدّل تشغيل مفضّل في مساحة التخزين الثابتة، كي يمكن استخدامه في الجلسة التالية ضمن خيارات البث.

المرتجعات

number 

getPreferredTextLanguage

تعرض الدالة getPreferredTextLanguage() القيمة string

تعرض هذه السمة لغة مسار النص المفضّلة.

المرتجعات

nullable string 

getPreferredTextStyle

تعرض الدالة getPreferredTextStyle()‎ النوع cast.framework.messages.TextTrackStyle

تعرض هذه السمة نمط مسار النص المفضّل.

المرتجعات

nullable cast.framework.messages.TextTrackStyle 

getQueueManager

getQueueManager() returns (cast.framework.QueueManager or undefined)

تعرض هذه السمة مثيل QueueManager.

المرتجعات

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

getRawCurrentTimeSec

تعرض الدالة getRawCurrentTimeSec()‎ القيمة number

تعرض هذه السمة الوقت المنقضي لتشغيل الوسائط الحالية، بدون طرح وقت الفاصل الإعلاني.

المرتجعات

number الوقت المنقضي بالثواني. ستظهر القيمة 0 إذا لم يتم تشغيل أي وسائط.

getRawSeekableRange

تعرض الدالة getRawSeekableRange()‎ cast.framework.messages.Range

تعرض هذه السمة النطاق الحالي القابل للبحث في الوسائط.

ملاحظة: يتطابق هذا مع وحدات getRawCurrentTimeSec()، ولكن ليس مع seek()!. ولا يأخذ في الاعتبار إزاحات الإعلانات أو أي وسائط أخرى. ما لم تكن متأكدًا من حاجتك إلى القيم الأولية، عليك استخدام getLiveSeekableRange() بدلاً من ذلك.

المرتجعات

nullable cast.framework.messages.Range 

getStartAbsoluteTime

تعرض الدالة getStartAbsoluteTime() القيمة number

تعرض هذه السمة وقت بدء الوسائط المطلق، كوقت حقبة UNIX (بالثواني منذ بدء حقبة UNIX). لا ينطبق الوقت المطلق إلا على أحداث البث المباشر.

المرتجعات

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 التي تحتوي على قيمة فارغة

يبدأ طلبًا لتحميل الوسائط.

المرتجعات

non-null Promise containing void وعد يتم تنفيذه عند نجاح العملية، أو رفضه في حال تعذُّرها.

pause

pause()

لإيقاف الوسائط التي يتم تشغيلها حاليًا مؤقتًا

تشغيل

play()

تشغيل الوسائط المتوقّفة مؤقتًا حاليًا

removeEventListener

removeEventListener(eventType, eventListener)

تزيل هذه الطريقة أداة معالجة الأحداث التي تمت إضافتها لحدث تشغيل معيّن. في حال عدم توفّر أداة معالجة أحداث مطابقة، سيتم تجاهل هذه المكالمة.

removeSupportedMediaCommands

removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

إزالة الأوامر من قائمة أوامر الوسائط المتوافقة

انظر أيضًا

cast.framework.messages.Command

تقديم/ترجيع

seek(seekTime)

البحث في الوسائط الحالية

sendCustomState

sendCustomState(state)

يرسل حالة مخصّصة من منطق تشغيل التطبيق إلى منطق واجهة المستخدم. تساعد هذه الطريقة في فصل منطق التشغيل وواجهة المستخدم. يسمح الحفاظ على الفصل بين المنطق وواجهة المستخدم باستخدام منطق واجهة المستخدم نفسه لكل من التشغيل المحلي والتحكّم عن بُعد. تتوفّر الحالة المخصّصة التي يتم إرسالها باستخدام هذه الطريقة لواجهة المستخدم من خلال PlayerData.

انظر أيضًا

cast.framework.ui.PlayerData#customState

sendError

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

يرسل هذا الإجراء رسالة خطأ إلى مُرسِل محدّد.

sendLocalMediaRequest

sendLocalMediaRequest(request)

يرسل هذا الإجراء طلب وسائط محلية.

sendStatus

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

يرسل رسالة حالة وسائط إلى مُرسِل محدّد.

setIdleReason

setIdleReason(idleReason)

تضبط هذه السمة سبب انتقال المشغّل إلى الحالة IDLE. يتيح ذلك للتطبيقات التي تريد فرض حالة IDLE تحديد سبب ذلك (على سبيل المثال، خطأ مخصّص). يتم إرسال سبب عدم النشاط في رسالة الحالة التالية. ملاحظة: لا تحتاج معظم التطبيقات إلى ضبط هذه القيمة. ولا تكون هناك حاجة إلى استخدامها إلا إذا كان التطبيق بحاجة إلى الانتقال إلى الحالة IDLE في ظروف خاصة، ولم يعكس idleReason التلقائي السلوك المقصود.Player

setMediaElement

setMediaElement(mediaElement)

تضبط هذه السمة HTMLMediaElement المطلوب استخدامه. في حال ضبط Promise HTMLMediaElement، سيبدأ تشغيل الوسائط بعد حلّ Promise.

setMediaInformation

setMediaInformation(mediaInformation, opt_broadcast)

تضبط هذه السمة معلومات الوسائط.

setMediaPlaybackInfoHandler

setMediaPlaybackInfoHandler(handler)

تضبط هذه السمة معالجًا لعرض أو تعديل cast.framework.PlaybackConfig لطلب تحميل معيّن. مَعلمات المعالج هي LoadRequestData وPlaybackConfig التلقائية للمستقبِل (المقدَّمة في CastReceiverOptions). يجب أن يعرض المعالج إعدادات تشغيل معدَّلة، أو null لمنع تشغيل الوسائط. قد تكون قيمة العرض أيضًا Promise للسماح بالانتظار إلى حين الحصول على البيانات من الخادم.

setMediaUrlResolver

setMediaUrlResolver(resolver)

يضبط هذا الإعداد معالجًا لعرض عنوان URL للوسائط لطلب LOAD. يمكن استخدام معالج الأحداث هذا لتجنُّب نشر عنوان URL الخاص بمحتوى الوسائط كجزء من حالة الوسائط. يتم تلقائيًا استخدام contentId الوسائط كعنوان URL للمحتوى.

setMessageInterceptor

setMessageInterceptor(type, interceptor)

تضبط هذه السمة أداة اعتراض للرسائل الواردة والصادرة. يمكن أن تعدّل أداة الاعتراض بيانات الطلب، ويجب أن تعرض إما بيانات معدَّلة أو Promise مع بيانات معدَّلة (إذا تعذّر عرض البيانات على الفور) أو null إذا كان يجب عدم التعامل مع الطلب. ملاحظة: إذا تم توفير أداة اعتراض رسائل LOAD، ولكن لم يتم توفير أداة اعتراض PRELOAD منفصلة، سيتم استدعاء أداة اعتراض LOAD لرسائل PRELOAD.

setPlaybackConfig

setPlaybackConfig(playbackConfig)

تضبط هذه السياسة إعدادات التشغيل على PlayerManager.

setSupportedMediaCommands

setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

تضبط هذه السمة أوامر الوسائط التي يتيحها جهاز الاستقبال.

انظر أيضًا

cast.framework.messages.Command

إيقاف

stop()

يوقف الوسائط التي يتم تشغيلها حاليًا.