الصف: الوسائط

chrome.cast.media.الوسائط

class   ثابت

يمثّل هذا العنصر وسائط تم تحميلها في تطبيق جهاز الاستقبال.

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

الوسائط

new Media(sessionId, mediaSessionId)

المَعلمة
sessionId	سلسلة معرِّف الجلسة
mediaSessionId	الرقم معرّف الوسائط

أماكن إقامة

activeTrackIds

مصفوفة أرقام قابلة للقيم

قائمة بالمعرفات المقابلة للمسارات النشطة.

breakStatus

(chrome.cast.media.BreakStatus غير فارغة أو غير محدَّدة)

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

currentItemId

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

معرّف العنصر الذي كان نشطًا في قائمة الانتظار (قد لا يكون قيد التشغيل) في وقت حدوث تغيير حالة الوسائط.

currentTime

الرقم

موضع التشغيل الحالي بالثواني منذ بدء تشغيل الوسائط. يتم تعديل هذا العنصر بشكل متقطع فقط، لذا غالبًا ما تكون قيمته قديمة. استخدِم الطريقة getEstimatedTime للحصول على تقدير لموضع التشغيل الفعلي استنادًا إلى آخر معلومات أبلغ عنها المُستلِم.

منهي العمل به

يُرجى استخدام getEstimateTime بدلاً من ذلك.

customData

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

مجموعة بيانات مخصصة من خلال تطبيق المُستلِم.

idleReason

chrome.cast.media.IdleReason قابلة للقيم الفارغة

سبب عدم النشاط لفترة قصيرة إذا كان المُستلِم يعرف ذلك.

عناصر

مصفوفة chrome.cast.media.QueueItem غير فارغة

مصفوفة من العناصر التي تم ترتيبها في قائمة الانتظار.

liveSeekableRange

(chrome.cast.media.LiveSeekableRange غير فارغة أو غير محدّدة)

نطاق يمكن البحث عنه لبث مباشر أو بث حدث. وهو يستخدم الوقت النسبي للوسائط بالثواني. ولن يتم تحديده في أحداث بث الفيديو عند الطلب.

loadingItemId

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

معرِّف السلعة للسلعة التي يتم تحميلها حاليًا على المُستلِم. فارغة إذا لم يتم تحميل أي عنصر حاليًا.

وسائط

chrome.cast.media.MediaInfo قابلان للقيم الفارغة

وصف الوسائط.

mediaSessionId

الرقم

لتحديد عنصر الوسائط.

playbackRate

الرقم

معدّل التشغيل الرقم 1.0 يمثل التشغيل العادي.

playerState

non-null chrome.cast.media.PlayerState

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

preloadedItemId

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

لا يتوفر معرّف العنصر التالي إلا إذا تم تحميله مسبقًا. يمكن تحميل ملفات الوسائط على جهاز الاستقبال مسبقًا وتخزينها مؤقتًا بشكل مؤقت في الذاكرة، وبالتالي عندما يتم تحميلها في وقت لاحق، تصبح العملية أسرع (لأنّه لا يلزم جلب الوسائط من الشبكة).

queueData

(chrome.cast.media.QueueData غير فارغة أو غير محدّدة)

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

repeatMode

non-null chrome.cast.media.RepeatMode

وضع التكرار لتشغيل قائمة المحتوى التالي

sessionId

سلسلة

تحدِّد الجلسة التي تستضيف الوسائط.

supportedMediaCommands

non-null Array of non-null chrome.cast.media.MediaCommand

أوامر الوسائط المتوافقة مع مشغّل الوسائط.

videoInfo

(chrome.cast.media.VideoInformation غير فارغة أو غير محدّدة)

معلومات الفيديو

الحجم

chrome.cast.Volume غير فارغة

مستوى صوت بث الوسائط سيتم دائمًا ضبط مجلد "مستوى الصوت" و"مستوى الصوت".

الطُرق

addUpdateListener

addUpdateListener(listener)

يضيف مستمعًا يتم استدعاؤه عند تغيير حالة الوسائط. وستؤدي التغييرات في السمات التالية إلى تشغيل المستمع: currentTime، ومستوى الصوت، والبيانات الوصفية، ومعدّل التشغيل، ومشغّل شبكة الجوّال، وcustomData. عند إجراء اتصال ناجح باستخدام طريقة getStatus للوسائط، سيتم أيضًا تشغيل المستمع.

المَعلمة
أداة معالجة الحدث	function(boolean) المستمِع المطلوب إضافته. تشير المعلَمة إلى ما إذا كان عنصر الوسائط لا يزال على قيد الحياة.

editTracksInfo

editTracksInfo(editTracksInfoRequest, successCallback, errorCallback)

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

المَعلمة
editTracksInfoRequest	chrome.cast.media.EditTracksInfoRequest يجب ألا تكون القيمة فارغة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

getEstimatedBreakClipTime

getEstimatedBreakClipTime() returns (number or undefined)

يتم تقدير موضع مقطع الفاصل الحالي استنادًا إلى آخر معلومات أبلغ عنها المُستلِم.

المرتجعات

(number or undefined) تقدير لموضع مقطع الفواصل الإعلانية الحالي بالثواني من بدء تشغيل الوسائط. سيتم عرض القيمة "غير محدّد" في حال عدم تحديد قيمة breakStatus أو currentBreakClipTime عند عدم تشغيل الفاصل.

getEstimatedBreakTime

getEstimatedBreakTime() returns (number or undefined)

يتم تقدير موضع الفاصل الحالي استنادًا إلى آخر معلومات أبلغ عنها المُستلِم.

المرتجعات

(number or undefined) تقدير لموضع الفاصل الحالي بالثواني منذ بدء تشغيل الوسائط. سيتم عرض القيمة "غير محدّد" في حال عدم تحديد قيمة breakStatus أو currentBreakTime (في حال عدم تشغيل فاصل إعلاني).

getEstimatedLiveSeekableRange

getEstimatedLiveSeekableRange() returns (chrome.cast.media.LiveSeekableRange or undefined)

يقدّر هذا الحقل بداية حدث LiveSeekableRange بالثواني استنادًا إلى آخر معلومات أبلغ عنها المُستلِم.

المرتجعات

(non-null chrome.cast.media.LiveSeekableRange or undefined) تقدير للنطاق LiveSeekableRange الحالي. ستعرض القيمة غير محددة إذا لم يتم تحديد المعلمة liveSeekableRange أو LiveSeekableRange.start أو liveSeekableRange.end عندما لا يكون المحتوى منشورًا.

getEstimatedTime

تعرض get المقدَّرةTime() رقمًا.

يقدّر هذا القسم موضع التشغيل الحالي استنادًا إلى آخر معلومات أبلغ عنها المُستلِم.

المرتجعات

number تقدير لموضع التشغيل الحالي بالثواني منذ بدء تشغيل الوسائط.

getStatus

getStatus(getStatusRequest, successCallback, errorCallback)

للتعرُّف على حالة ملف الوسائط من تطبيق المُستلِم.

إلى جانب نجاح الإجراء userCallback المحدّدَين، سيتم أيضًا استدعاء أي أدوات لمعالجة تحديثات الوسائط عند تلقّي الحالة من تطبيق المُستلِم. وبدلاً من استخدام هذه الطريقة لاستطلاع حالة الوسائط، من المفترض أن تفضّل التطبيقات الاعتماد على الاستدعاء التلقائي لأدوات معالجة تحديثات الوسائط كلما تغيّرت الوسائط.

المَعلمة
getStatusRequest	chrome.cast.media.GetStatusRequest الطلب الاختياري للحصول على الحالة.
successCallback	function() تم استدعاؤه عند استلام الحالة من تطبيق المُستلِم.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

pause

off(pauseRequest, maxCallback, errorCallback)

إيقاف عنصر الوسائط مؤقتًا

المَعلمة
pauseRequest	chrome.cast.media.PauseRequest
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. طلب إيقاف الوسائط مؤقتًا. تجدر الإشارة إلى أن الأخطاء المحتملة هي TIMESTAMP وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR والإضافات.

تشغيل

play(playRequest, sameCallback, errorCallback)

لتشغيل عنصر الوسائط.

المَعلمة
playRequest	chrome.cast.media.PlayRequest طلب تشغيل الوسائط الاختياري.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueAppendItem

queueAppendItem(item, successCallback, errorCallback)

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

المَعلمة
عنصر	chrome.cast.media.QueueItem العنصر المطلوب إلحاقه بنهاية قائمة المحتوى التالي. يجب ألا تكون القيمة فارغة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueInsertItems

queueInsertItems(queueInsertItemsRequest, successCallback, errorCallback)

لإدراج قائمة بعناصر الوسائط الجديدة في قائمة الانتظار.

المَعلمة
queueInsertItemsRequest	chrome.cast.media.QueueInsertItemsRequest يمكنك طلب إدراج الوسائط في قائمة انتظار الوسائط. يجب ألا تكون القيمة فارغة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueJumpToItem

queueJumpToItem(itemId, successCallback, errorCallback)

لتشغيل العنصر الذي يحتوي على itemId في قائمة الانتظار.

إذا لم يتم العثور على itemId في قائمة الانتظار، إما لأنّه لم يكن متوفرًا في الأصل أو لأنّه تمت إزالته من قِبل مُرسِل آخر قبل استدعاء هذه الدالة، سيتم عرض هذه الدالة بدون إرسال طلب إلى المُستلِم.

المَعلمة
itemId	الرقم رقم تعريف العنصر المطلوب الانتقال إليه.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueMoveItemToNewIndex

queueMoveItemToNewIndex(itemId, newIndex, successCallback, errorCallback)

ينقل العنصر الذي يحمل itemId إلى الموضع newIndex في قائمة الانتظار.

إذا لم يتم العثور على itemId في قائمة الانتظار، إما لأنّه لم يكن متوفرًا في الأصل أو لأنّه تمت إزالته من قِبل مُرسِل آخر قبل استدعاء هذه الدالة، سيتم عرض هذه الدالة بدون إرسال طلب إلى المُستلِم.

سيتم استدعاء errorCallback إذا كانت قيمة newIndex سالبة. مع ذلك، في حال تجاوز مؤشر newIndex المحتوى، سواء تم تحديده عن طريق الخطأ أو أنه تم تقليص قائمة الانتظار من قِبل مُرسِل آخر، سيتم نقل العنصر إلى نهاية قائمة الانتظار.

المَعلمة
itemId	الرقم رقم تعريف العنصر المطلوب نقله
newIndex	الرقم الفهرس الجديد للسلعة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueNext

queueNext(successCallback, errorCallback)

للانتقال إلى العنصر التالي في قائمة الانتظار

المَعلمة
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queuePrev

queuePrev(successCallback, errorCallback)

للانتقال إلى العنصر السابق في قائمة الانتظار

المَعلمة
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueRemoveItem

queueRemoveItem(itemId, successCallback, errorCallback)

لإزالة العنصر الذي يحتوي على itemId من قائمة الانتظار.

إذا لم يتم العثور على itemId في قائمة الانتظار، إما لأنّه لم يكن متوفرًا في الأصل أو لأنّه تمت إزالته من قِبل مُرسِل آخر قبل استدعاء هذه الدالة، سيتم عرض هذه الدالة بدون إرسال طلب إلى المُستلِم.

المَعلمة
itemId	الرقم معرّف السلعة المطلوب إزالتها
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueReorderItems

queueReorderItems(queueReorderItemsRequest, successCallback, errorCallback)

إعادة ترتيب قائمة عناصر الوسائط في قائمة الانتظار

المَعلمة
queueReorderItemsRequest	chrome.cast.media.QueueReorderItemsRequest طلب إعادة ترتيب العناصر في قائمة انتظار الوسائط يجب ألا تكون القيمة فارغة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueSetRepeatMode

queueSetRepeatMode(repeatMode, successCallback, errorCallback)

لضبط وضع التكرار لقائمة الانتظار.

المَعلمة
repeatMode	chrome.cast.media.RepeatMode تمثّل هذه السمة خوارزمية اختيار العنصر التالي عند انتهاء العنصر الحالي. يجب ألا تكون القيمة فارغة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

queueUpdateItems

queueUpdateItems(queueUpdateItemsRequest, successCallback, errorCallback)

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

المَعلمة
queueUpdateItemsRequest	chrome.cast.media.QueueUpdateItemsRequest يمكنك طلب تعديل خصائص قائمة انتظار الوسائط. يجب ألا تكون القيمة فارغة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

removeUpdateListener

removeUpdateListener(listener)

لإزالة مستمع سبق إضافته إلى هذه الوسائط.

المَعلمة
أداة معالجة الحدث	function(boolean) المستمِع المطلوب إزالته.

تقديم/ترجيع

request(seekRequest, SuccessCallback, errorCallback)

للبحث عن الوسائط

المَعلمة
seekRequest	chrome.cast.media.SeekRequest طلب الوسائط يجب ألا تكون القيمة فارغة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

setVolume

setVolume(volumeRequest, successCallback, errorCallback)

لضبط مستوى صوت بث الوسائط. يجب ضبط قيمة واحدة على الأقل من levelRequest.level أو levelRequest.muted. لا يؤثر تغيير حالة كتم الصوت في مستوى الصوت والعكس صحيح.

المَعلمة
volumeRequest	chrome.cast.media.VolumeRequest طلب ضبط مستوى الصوت. يجب ألا تكون القيمة فارغة.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

محطة توقّف

off(stopRequest, SuccessCallback, errorCallback)

يوقف مشغّل الوسائط.

المَعلمة
stopRequest	chrome.cast.media.StopRequest طلب الإيقاف.
successCallback	function() تم الاستدعاء عند نجاح العملية.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

supportsCommand

يعرض SupportCommand(command) قيمة منطقية

تحدِّد هذه السياسة ما إذا كان مشغّل الوسائط متوافقًا مع أمر الوسائط المحدَّد.

المَعلمة
Command	chrome.cast.media.MediaCommand الأمر المطلوب الاستعلام منه. يجب ألا تكون القيمة فارغة.

المرتجعات

boolean صحيح إذا كان المشغِّل يتيح استخدام الأمر.