chrome.
تصف حالة تطبيق Cast قيد التشغيل حاليًا. في العادة، يجب ألا ينشئ العميل هذه الكائنات.
الشركة المصنِّعة
الجلسة
new Session(sessionId, appId, DisplayName, appImages, keepr)
المَعلمة |
|
|---|---|
|
sessionId |
سلسلة معرِّف الجلسة |
|
appId |
سلسلة معرّف تطبيق المُستلِم. |
|
displayName |
سلسلة الاسم المعروض للتطبيق |
|
appImages |
مصفوفة chrome.cast.Image غير الفارغة الصور المرتبطة بالتطبيق يجب ألا تكون القيمة فارغة. |
|
المستلِم |
المستلِم الذي يشغّل التطبيق. يجب ألا تكون القيمة فارغة. |
أماكن إقامة
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 |
طلب تحميل الوسائط يجب ألا تكون القيمة فارغة. |
|
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. |