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

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 صحيح إذا كان المشغِّل يتيح استخدام الأمر.