الصف: TextTracksManager

cast.framework.TextTracksManager

class   static

تدير هذه السمة مقاطع النصوص.

عمليات الطرح

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

الطُرق

addTracks

addTracks(tracks)

تضيف هذه السمة مقاطع نصية إلى القائمة.

المَعلمة

مسارات

مصفوفة cast.framework.messages.Track غير فارغة

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

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

createTrack

تعرض الدالة createTrack() القيمة cast.framework.messages.Track

تنشئ هذه الطريقة مسارًا نصيًا.

عمليات الطرح

non-null Error في حال عدم توفُّر "مدير المسارات"

المرتجعات

non-null cast.framework.messages.Track 

getActiveIds

تعرض الدالة getActiveIds() مصفوفة من الأرقام.

تعرض هذه السمة جميع أرقام تعريف النصوص النشطة.

المرتجعات

non-null Array of number 

getActiveTracks

تعرض الدالة getActiveTracks()‎ مصفوفة من cast.framework.messages.Track غير الخالية

تعرض هذه الطريقة جميع مسارات النصوص النشطة.

المرتجعات

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

getTextTracksStyle

getTextTracksStyle() returns (cast.framework.messages.TextTrackStyle or undefined)

تعرض هذه السمة نمط مسار النص الحالي.

المرتجعات

(non-null cast.framework.messages.TextTrackStyle or undefined) 

getTrackById

getTrackById(id) تعرض cast.framework.messages.Track

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

المَعلمة

id

الرقم
عمليات الطرح

non-null Error في حال عدم توفّر المعرّف أو عدم صلاحيته

المرتجعات

nullable cast.framework.messages.Track 

getTracks

getTracks() returns Array of non-null cast.framework.messages.Track

تعرض هذه السمة جميع مسارات النصوص (غير الإجبارية).

المرتجعات

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

getTracksByLanguage

getTracksByLanguage(language) returns Array of non-null cast.framework.messages.Track

الحصول على مقاطع نصية حسب اللغة

المَعلمة

language

سلسلة

علامة اللغة وفقًا لمعيار RFC 5646
عمليات الطرح

non-null Error في حال عدم توفّر اللغة

المرتجعات

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

setActiveByIds

setActiveByIds(newIds)

يضبط مسارات النص لتكون نشطة حسب المعرّف.

المَعلمة

newIds

مصفوفة أرقام

معرّفات مسار النص المطلوب تفعيله لمحو مسارات النصوص، اضبط القيمة على مصفوفة فارغة أو null.

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

non-null Error إذا كان المعرّف غير صالح.

setActiveByLanguage

setActiveByLanguage(language)

يضبط هذا الخيار مسارات الترجمة والشرح لتكون نشطة حسب اللغة. سيتم تفعيل مسار اللغة الأول المطابق فقط.

المَعلمة

language

سلسلة

علامة اللغة وفقًا لمعيار RFC 5646
عمليات الطرح

non-null Error في حال كانت اللغة غير متاحة أو غير صالحة

setTextTrackStyle

setTextTrackStyle(style)

تضبط هذه السمة نمط مسار النص.

المَعلمة

النمط

cast.framework.messages.TextTrackStyle

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

non-null Error في حال عدم توفُّر "مدير المسارات"