الفئة: بيانات اللاعبين

الشركة المصنِّعة

PlayerData

new PlayerData()

الخصائص

activeTrackIds

مصفوفة أرقام غير فارغة

أرقام التعريف النشطة للوسائط الحالية

applicationData

nullable cast.framework.ui.ApplicationData

بيانات التطبيق

breakPercentagePositions

مصفوفة أرقام غير فارغة

مصفوفة مواضع فواصل الإعلانات بالنسبة المئوية تم إيقافها نهائيًا، ولا يتم تعديلها للفواصل الإعلانية في البث المباشر أو الفواصل الإعلانية الديناميكية.

منهي العمل به
استخدِم السمة `breaks` الخاصة بـ cast.framework.ui.PlayerData#media بدلاً من ذلك.

breakTitle

سلسلة

عنوان فترة الاستراحة الحالية

currentBreakClipNumber

الرقم

تمثّل هذه السمة رقم مقطع الإعلان الحالي الذي يتم تشغيله في فاصل الإعلانات.

currentTime

الرقم

الموضع الحالي للوسائط بالثواني، أو الموضع الحالي للفاصل الإعلاني إذا كان قيد التشغيل

customState

كائن قابل للقيم الفارغة

حالة مخصّصة للمستخدم، يجب استخدامها لفصل منطق التشغيل وواجهة المستخدم، للسماح بتشغيل رمز واجهة المستخدم نفسه في جهاز تحكّم عن بُعد. يمكن ضبط الحالة من خلال استدعاء cast.framework.PlayerManager#sendCustomState

displayStatus

قيمة منطقية

تحديد ما إذا كان يجب عرض البيانات الوصفية للمشغّل (مثل العنوان وcurrentTime) ستكون هذه القيمة صحيحة إذا كان يجب عرض حقل واحد على الأقل في البيانات الوصفية. في بعض الحالات، ستكون قيمة displayStatus صحيحة، ولكن يجب إخفاء أجزاء من البيانات الوصفية (مثل عنوان الوسائط أثناء البحث عن الوسائط). في هذه الحالات، يمكن تطبيق CSS إضافي لإخفاء هذه العناصر. في الحالات التي تكون فيها الوسائط صوتية فقط، يكون هذا صحيحًا دائمًا تقريبًا. في الحالات التي تكون فيها الوسائط عبارة عن فيديو، تكون هذه القيمة صحيحة عندما: (1) يكون الفيديو قيد التحميل أو التخزين المؤقت أو البحث (2) تم تقديم طلب تشغيل في آخر خمس ثوانٍ أثناء تشغيل الوسائط، (3) تم تقديم طلب لعرض الحالة في آخر خمس ثوانٍ، أو (4) تم إيقاف الوسائط مؤقتًا في آخر خمس ثوانٍ.

displayType

سلسلة

سمة للتمييز بين أنواع الشاشات المختلفة يكون التلفزيون هو الجهاز التلقائي.

المدة

الرقم

مدة الوسائط بالثواني، أو مدة الفاصل إذا كان يتم تشغيل فاصل

isAtLiveEdge

قيمة منطقية

تحدّد هذه السمة ما إذا كان يتم تشغيل بث الوسائط عند الحافة المباشرة.

isBreakExpanded

قيمة منطقية

تشير هذه السمة إلى أنّ المستلِم يشاهد استراحة موسّعة. لا ينطبق ذلك إلا على فواصل الإعلانات الديناميكية.

isBreakSkippable

قيمة منطقية

تشير إلى أنّه يمكن تخطّي مقطع الاستراحة في الوقت الحالي. صحيح عندما whenSkippable == 0.

isLive

قيمة منطقية

تحديد ما إذا كان المحتوى عبارة عن بث مباشر

isPlayingBreak

قيمة منطقية

تشير إلى أنّ المستلِم يشاهد استراحة.

isSeeking

قيمة منطقية

تشير إلى أنّ المشغّل يبحث عن محتوى (يمكن أن يحدث ذلك أثناء التشغيل أو الإيقاف المؤقت).

liveSeekableRange

nullable cast.framework.messages.LiveSeekableRange

يجب الإشارة إلى النطاق القابل للبحث في المحتوى إذا كان بثًا مباشرًا.

وسائط

(nullable cast.framework.messages.MediaInformation or undefined)

معلومات الوسائط الحالية

mediaCategory

nullable cast.framework.messages.MediaCategory

فئة الوسائط (فيديو أو صوت أو صورة)

mediaSessionId

الرقم

المعرّف الفريد لجلسة الوسائط. ويتم تعديلها عند تلقّي طلب تحميل جديد.

mediaStartAbsoluteTime

رقم يقبل القيم الفارغة

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

البيانات الوصفية

(nullable cast.framework.messages.MediaMetadata أو Object قابل للتصغير)

البيانات الوصفية للوسائط

nextMetadata

(nullable cast.framework.messages.MediaMetadata أو Object قابل للتصغير)

بيانات وصفية للعنصر التالي

nextSubtitle

سلسلة

العنوان الفرعي للعنصر التالي

nextThumbnailUrl

سلسلة

عنوان URL للصورة المصغّرة للعنصر التالي

nextTitle

سلسلة

عنوان العنصر التالي

numberBreakClips

الرقم

عدد مقاطع الاستراحة في الاستراحة الحالية

playbackRate

الرقم

سرعة تشغيل الوسائط

preloadingNext

قيمة منطقية

علم لإظهار/إخفاء البيانات الوصفية للعنصر التالي

queueData

(nullable cast.framework.messages.QueueData or undefined)

بيانات قائمة الانتظار

secondaryImageUrl

سلسلة

عنوان URL للصورة الثانوية للمحتوى

sectionDuration

رقم يقبل القيم الفارغة

يشير هذا الحقل إلى مدة القسم بالثواني.

sectionStartTimeInMedia

رقم يقبل القيم الفارغة

يُرجى الإشارة إلى وقت بدء القسم، بتنسيق الوقت الإعلامي بالثواني.

الولاية

cast.framework.ui.State

حالة المشغّل الحالية

supportedMediaCommands

الرقم

الأوامر التي يتيحها مشغّل الفيديو هذا

انظر أيضًا
cast.framework.messages.Command

thumbnailUrl

سلسلة

عنوان URL للصورة المصغّرة للمحتوى

title

سلسلة

تمثّل هذه السمة عنوان المحتوى.

whenSkippable

(رقم أو غير محدّد)

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