الصف: جلسة

chrome.بث.الجلسة

class   ثابت

تصف حالة تطبيق Cast قيد التشغيل حاليًا. في العادة، يجب ألا ينشئ العميل هذه الكائنات.

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

الجلسة

new Session(sessionId, appId, DisplayName, appImages, keepr)

المَعلمة
sessionId	سلسلة معرِّف الجلسة
appId	سلسلة معرّف تطبيق المُستلِم.
displayName	سلسلة الاسم المعروض للتطبيق
appImages	مصفوفة chrome.cast.Image غير الفارغة الصور المرتبطة بالتطبيق يجب ألا تكون القيمة فارغة.
المستلِم	chrome.cast.Receiver المستلِم الذي يشغّل التطبيق. يجب ألا تكون القيمة فارغة.

أماكن إقامة

appId

سلسلة

معرّف تطبيق Cast ليس للعرض.

appImages

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

مصفوفة من الصور المتاحة التي تصف التطبيق.

displayName

سلسلة

تمثّل هذه السمة الاسم الذي يمكن لشخص عادي قراءته لتطبيق Cast، مثل "YouTube".

وسائط

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

الوسائط التي تنتمي إلى جلسة البث هذه، بما في ذلك الوسائط التي حمَّلها مُرسِلون آخرون.

مساحات الاسم

مصفوفة غير فارغة لـ {name: string}

قائمة بمساحات الاسم التي يتيحها تطبيق المُستلِم.

المستلِم

chrome.cast.Receiver غير خالٍ

المُستلِم الذي يشغِّل التطبيق

senderApps

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

تطبيقات المُرسِلين المتوافقة مع تطبيق المُستلِم. قد يتم استخدام هذا الطلب لمطالبة المستخدم بتثبيت التطبيق المرسل أو الانتقال إليه.

sessionId

سلسلة

يحدد هذا المثيل من تطبيق المُستلِم بشكل فريد.

الحالة

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

حالة جلسة البث هذه لتطبيق المُستلِم.

statusText

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

نص وصفي لمحتوى التطبيق الحالي، مثل "عرض شرائح زفافي".

transportId

سلسلة

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

الطُرق

addMediaListener

addMediaListener(listener)

يضيف مستمعًا يتم استدعاؤه عندما أنشأ مُرسِل آخر جلسة وسائط.

المَعلمة
أداة معالجة الحدث	function(non-null chrome.cast.media.Media) أداة الاستماع المطلوب إضافتها

addMessageListener

addMessageListener(namespace, listener)

يضيف هذا الإعداد مستمعًا يتم استدعاؤه عند استلام رسالة من تطبيق جهاز الاستقبال. يتم استدعاء المستمع مع تحديد مساحة الاسم كوسيطة أولى والرسالة كوسيطة ثانية.

المَعلمة
namespace	سلسلة مساحة الاسم المطلوب الاستماع إليها، مثل "urn:x-cast:com.example.namespace".
أداة معالجة الحدث	الدالة(سلسلة نصية، سلسلة) المستمِع المطلوب إضافته.

addUpdateListener

addUpdateListener(listener)

يضيف مستمعًا يتم استدعاؤه عند تغيير الجلسة. وستؤدي التغييرات في السمات التالية إلى تشغيل المستمع: statusText ومساحات الاسم والحالة ومستوى صوت المُستلِم.

على المستمعين التحقّق من السمة status للجلسة لتحديد حالة الربط. تم إيقاف المعلَمة المنطقية isAlive نهائيًا لصالح الموقع الإلكتروني لجلسة status. لا يزال يتم تمرير المعلَمة isAlive للتوافق مع الأنظمة القديمة، وهي صحيحة ما لم يتم status = chrome.cast.SessionStatus.STOPPED.

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

getDialAppInfo

getDialAppInfo(successCallback, errorCallback)

الحصول على معلومات تطبيق DIAL.

المَعلمة
successCallback	function(non-null chrome.cast.DialLaunchData)
errorCallback	function(non-null chrome.cast.Error)

ترك

مغادرة(successCallback, errorCallback)

تتم مغادرة (إلغاء الربط) بتطبيق جهاز الاستقبال قيد التشغيل والمرتبط بالجلسة.

سيتم إلغاء ربط العملاء الحاليين ضمن النطاق المحدّد من خلال AutoJOINPolicy لهذا العميل. لن ينضم العملاء المستقبليون تلقائيًا إلى الجلسة المتبقية.

بالنسبة إلى جميع العملاء غير المتصلين، سيتم إجراء مكالمة مع مستمعي تحديثات جلستهم باستخدام isAlive = true. على المستمعين التحقّق من السمة status في الجلسة لتحديد حالة الاتصال بها بعد إيقاف isAlive نهائيًا. وهي في هذه الحالة status = chrome.cast.SessionStatus.DISCONNECTED.

المَعلمة
successCallback	function()
errorCallback	function(non-null chrome.cast.Error) الأخطاء المحتملة هي مغامرات وAPI_NOT_INITIALIZED وCHANNEL_ERROR وSESSION_ERROR و extension_MISSING.

loadMedia

loadMedia(loadRequest, successCallback, errorCallback)

يحمِّل الوسائط إلى تطبيق جهاز استقبال قيد التشغيل.

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

queueLoad

queueLoad(queueLoadRequest, successCallback, errorCallback)

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

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

منهي العمل به

استخدِم cast.framework.CastSession#loadMedia وقدِّم chrome.cast.media.LoadRequest#queueData ذات الصلة.

removeMediaListener

removeMediaListener(listener)

لإزالة مستمع تمت إضافته سابقًا باستخدام addMediaListener.

المَعلمة
أداة معالجة الحدث	function(non-null chrome.cast.media.Media) المستمِع المطلوب إزالته.

removeMessageListener

removeMessageListener(namespace, listener)

إزالة مستمع تمت إضافته سابقًا للرسائل.

المَعلمة
namespace	سلسلة مساحة الاسم التي يتم الاستماع إليها، مثل 'urn:x-cast:com.example.namespace'.
أداة معالجة الحدث	الدالة(سلسلة نصية، سلسلة) المستمِع المطلوب إزالته.

removeUpdateListener

removeUpdateListener(listener)

لإزالة مستمِع سبق أن تمت إضافته إلى هذه الجلسة.

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

sendMessage

sendMessage(namespace, message, successCallback, errorCallback)

يرسل رسالة إلى تطبيق المُستلِم في مساحة الاسم المحددة. يتم استدعاء SuccessCallback عند إرسال الرسالة إلى قناة المراسلة. التسليم إلى التطبيق الذي يتلقّاه الجهاز هو أفضل جهد وغير مضمون.

المَعلمة
namespace	سلسلة مساحة الاسم المطلوب إرسال الرسالة عليها، مثلاً "urn:x-cast:com.example.namespace".
رسالة	(non-null Object or string)
successCallback	function() تم استدعاؤه عند إرسال الرسالة.
errorCallback	function(non-null chrome.cast.Error) تم الاستدعاء عند حدوث خطأ. الأخطاء المحتملة هي PARAM وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR وextension_MISSING.

setReceiverMuted

setReceiverMuted(muted, successCallback, errorCallback)

لضبط مستوى صوت جهاز الاستقبال.

المَعلمة
تم كتم الصوت	boolean الحالة الجديدة للتجاهل.
successCallback	function()
errorCallback	function(non-null chrome.cast.Error) الأخطاء المحتملة هي مهلة وAPI_NOT_INITIALIZED وINVALID_PARAMETER وCHANNEL_ERROR وSESSION_ERROR والإضافات.

setReceiverVolumeLevel

setReceiverVolumeLevel(newLevel, successCallback, errorCallback)

لضبط مستوى صوت جهاز الاستقبال.

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

محطة توقّف

إيقاف(successCallback, errorCallback)

يوقف تطبيق المُستلِم قيد التشغيل والمرتبط بالجلسة.

المَعلمة
successCallback	function()
errorCallback	function(non-null chrome.cast.Error) الأخطاء المحتملة هي مغامرات وAPI_NOT_INITIALIZED وCHANNEL_ERROR وSESSION_ERROR و extension_MISSING.