الفئة: PlayerManager

cast.framework.PlayerManager

class   static

التحكّم في تشغيل الوسائط ومراقبته

عمليات الطرح

non-null Error في حال استخدام الدالة الإنشائية مباشرةً يجب الوصول إلى PlayerManager فقط من خلال استدعاء cast.framework.CastReceiverContext#getPlayerManager.

الطُرق

addEventListener

addEventListener(eventType, eventListener)

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

المَعلمة

eventType

(قيمة غير فارغة من cast.framework.events.EventType أو مصفوفة غير فارغة من قيم غير فارغة من cast.framework.events.EventType)

نوع حدث أو مصفوفة من أنواع الأحداث

eventListener

function(non-null cast.framework.events.Event)
عمليات الطرح

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

addSupportedMediaCommands

addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

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

المَعلمة

supportedMediaCommands

الرقم

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

broadcastStatus

اختياري

قيمة منطقية

يشير true إلى أنّه يجب إعلام المرسلين بالتغيير (في حال عدم توفّره، سيتم إعلام المرسلين).
انظر أيضًا
cast.framework.messages.Command

broadcastStatus

broadcastStatus(includeMedia, requestId, customData, includeQueueItems)

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

المَعلمة

includeMedia

اختياري

قيمة منطقية

يشير true إلى أنّ الرسالة يجب أن تتضمّن معلومات حول الوسائط.

requestId

اختياري

الرقم

معرّف الطلب الوارد الذي تسبّب في ظهور هذا الردّ.

customData

اختياري

عنصر

تمثّل هذه السمة البيانات المخصّصة الخاصة بالتطبيق لرسالة الحالة.

قد تكون القيمة فارغة.

includeQueueItems

اختياري

قيمة منطقية

تحديد ما إذا كان سيتم تضمين عناصر قائمة الانتظار في رسالة الحالة. ولا يتم تضمينها تلقائيًا.

getAbsoluteTimeForMediaTime

getAbsoluteTimeForMediaTime(mediaTime) returns number

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

المَعلمة

mediaTime

الرقم

وقت الوسائط
المرتجعات

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#startreceiver، وإلا ستعرض القيمة 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) تعرض رقمًا

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

المَعلمة

absoluteTime

الرقم

الوقت المطلق للوسائط، بتنسيق وقت حقبة UNIX (عدد الثواني منذ بداية حقبة UNIX).
المرتجعات

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

getPlaybackConfig

تعرض الدالة getPlaybackConfig()‎ cast.framework.PlaybackConfig

تعرض هذه الدالة إعدادات التشغيل أو null إذا لم يتم تجاوز الإعدادات التلقائية.

المرتجعات

nullable cast.framework.PlaybackConfig 

getPlaybackRate

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

تعرض هذه السمة سرعة التشغيل الحالية. تعرض هذه السمة القيمة 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() قيمة رقمية.

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

المرتجعات

nullable number 

getStats

تعرض الدالة getStats() cast.framework.stats.Stats

تعرض هذه الطريقة إحصاءات التشغيل. يتم تجميع الإحصاءات على مستوى جلسة التشغيل بأكملها عند الاقتضاء.

المرتجعات

non-null cast.framework.stats.Stats 

getSupportedMediaCommands

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

يحصل على أوامر الوسائط المتوافقة مع جهاز الاستقبال. يجب استدعاء هذه الدالة فقط بعد استدعاء 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 وعد يتم تنفيذه عند نجاح العملية، أو رفضه في حال تعذُّرها.

pause

pause()

يوقِف هذا الإجراء الوسائط التي يتم تشغيلها حاليًا مؤقتًا.

تشغيل

play()

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

removeEventListener

removeEventListener(eventType, eventListener)

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

المَعلمة

eventType

(قيمة غير فارغة من cast.framework.events.EventType أو مصفوفة غير فارغة من قيم غير فارغة من cast.framework.events.EventType)

eventType أو مصفوفة من أنواع الأحداث

eventListener

function(non-null cast.framework.events.Event)

removeSupportedMediaCommands

removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

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

المَعلمة

supportedMediaCommands

الرقم

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

broadcastStatus

اختياري

قيمة منطقية

يشير true إلى أنّه يجب إعلام المرسلين بالتغيير (في حال عدم توفّره، سيتم إعلام المرسلين).
انظر أيضًا
cast.framework.messages.Command

تقديم/ترجيع

seek(seekTime)

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

المَعلمة

seekTime

الرقم

sendCustomState

sendCustomState(state)

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

المَعلمة

الولاية

عنصر

عنصر الحالة المخصّصة

يجب ألا تكون القيمة فارغة.
انظر أيضًا
cast.framework.ui.PlayerData#customState

sendError

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

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

المَعلمة

senderId

سلسلة

معرّف المُرسِل

requestId

الرقم

معرّف الطلب الوارد الذي تسبّب في حدوث هذا الخطأ.

النوع

cast.framework.messages.ErrorType

نوع الخطأ

يجب ألا تكون القيمة فارغة.

السبب

اختياري

cast.framework.messages.ErrorReason

سبب الخطأ

قد تكون القيمة فارغة.

customData

اختياري

عنصر

تمثّل هذه السمة بيانات مخصّصة خاصة بالتطبيق لرسالة الخطأ.

قد تكون القيمة فارغة.

sendLocalMediaRequest

sendLocalMediaRequest(request)

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

المَعلمة

طلب

cast.framework.messages.RequestData

يجب ألا تكون القيمة فارغة.

sendStatus

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

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

المَعلمة

senderId

سلسلة

معرّف المُرسِل

requestId

الرقم

معرّف الطلب الوارد الذي تسبّب في ظهور هذا الردّ.

includeMedia

اختياري

قيمة منطقية

يشير true إلى أنّ الرسالة يجب أن تتضمّن نسخة من MediaInformation.

customData

اختياري

عنصر

تمثّل هذه السمة البيانات المخصّصة الخاصة بالتطبيق لرسالة الحالة.

قد تكون القيمة فارغة.

includeQueueItems

اختياري

قيمة منطقية

تحديد ما إذا كان سيتم تضمين عناصر قائمة الانتظار في رسالة الحالة. ولا يتم تضمينها تلقائيًا.

setIdleReason

setIdleReason(idleReason)

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

المَعلمة

idleReason

cast.framework.messages.IdleReason

سبب التواجد في حالة IDLE

يجب ألا تكون القيمة فارغة.

setMediaElement

setMediaElement(mediaElement)

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

المَعلمة

mediaElement

(non-null HTMLMediaElement أو non-null Promise يحتوي على non-null HTMLMediaElement)

MediaElement التي ستستخدمها Player

setMediaInformation

setMediaInformation(mediaInformation, opt_broadcast)

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

المَعلمة

mediaInformation

cast.framework.messages.MediaInformation

يجب ألا تكون القيمة فارغة.

opt_broadcast

اختياري

قيمة منطقية

setMediaPlaybackInfoHandler

setMediaPlaybackInfoHandler(handler)

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

المَعلمة

المعالج

function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.PlaybackConfig)

دالة لتوفير إعدادات تشغيل خاصة بالطلب

قد تكون القيمة فارغة.

setMediaUrlResolver

setMediaUrlResolver(resolver)

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

المَعلمة

برنامج التعيين

function(non-null cast.framework.messages.LoadRequestData)

دالة لتحديد عنوان URL الخاص بمحتوى الوسائط

قد تكون القيمة فارغة.

setMessageInterceptor

setMessageInterceptor(type, interceptor)

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

المَعلمة

النوع

cast.framework.messages.MessageType

يجب ألا تكون القيمة فارغة.

صاروخ اعتراضي

function(non-null cast.framework.messages.RequestData)

قد تكون القيمة فارغة.
عمليات الطرح

non-null Error إذا كان نوع الرسالة غير صالح أو إذا لم يكن المعترِض دالة

setPlaybackConfig

setPlaybackConfig(playbackConfig)

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

المَعلمة

playbackConfig

cast.framework.PlaybackConfig

يجب ألا تكون القيمة فارغة.

setSupportedMediaCommands

setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

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

المَعلمة

supportedMediaCommands

الرقم

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

broadcastStatus

اختياري

قيمة منطقية

يشير true إلى أنّه يجب إعلام المرسلين بالتغيير (في حال عدم توفّره، سيتم إعلام المرسلين).
انظر أيضًا
cast.framework.messages.Command

إيقاف

stop()

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