الفئة: CastCastrContext

cast.framework.CastCastrContext

class   static

تتم إدارة تحميل المكتبات الأساسية وإعداد حزمة تطوير برامج (SDK) لجهاز استقبال البث.

رمي

non-null Error إذا لم يتم إنشاء MediaElement في نص المستند. وفي حال إنشاء عناصر وسائط متعدّدة، على المطوّر ضبط فئة "castMediaElement" على أحد هذه العناصر، والتي سيستخدمها جهاز استقبال CAF.

الطُرق

الحصول على مثيل

ثابت

تعرض دالة getInstance() cast.framework.CastCastrContext

عرض مثيل CastاستقبالrContext فردي.

المرتجعات

non-null cast.framework.CastReceiverContext 

AddCustomMessage الجوالer

addCustomMessage الجوالer(اسم مساحة، أداة معالجة)

لضبط أداة معالجة الرسائل على قناة الرسائل المخصّصة.

المَعلمة
namespace	سلسلة مساحة الاسم ملاحظة: يجب أن تسبق مساحة الاسم الصالحة السلسلة 'urn:x-cast:'.
أداة معالجة الحدث	دالة(non-blank cast.framework.system.Event)

رمي

Error إذا لم يكن النظام جاهزًا أو كانت مساحة الاسم غير متوافقة مع هذا التطبيق.

إضافةالاستماع إلى حدث

addEventالاستماعer(type, Wizard)

يمكنك إضافة مستمعين إلى أحداث نظام البث.

المَعلمة
كتابة	cast.framework.system.EventType يجب ألا تكون القيمة فارغة.
معالج	دالة(non-blank cast.framework.system.Event)

نوع العرض

إمكانية عرض قيمة CanDisplayType(mimeType أو برامج الترميز والعرض والارتفاع وعدد اللقطات في الثانية) منطقي

للتحقق مما إذا كانت المنصّات الإعلانية المحدّدة للفيديوهات أو عمليات البث الصوتي متوافقة مع المنصة.

المَعلمة
mimeType	سلسلة نوع MIME للوسائط وتتكوّن السياسة من نوع ونوع فرعي مفصول بالحرف "/". ويمكن أن يكون نوعًا من أنواع الفيديو أو MIME.
برامج الترميز	إجراء اختياري سلسلة سلسلة ذات علامات اقتباس تحتوي على قائمة بتنسيقات مفصولة بفواصل، حيث يحدّد كل تنسيق نوعًا من نماذج الوسائط المتوفّرة في ساحة المشاركات.
width	إجراء اختياري الرقم تقدّم هذه السمة وصفًا لدقة البث الأفقي بالبكسل.
الطول	إجراء اختياري الرقم تصف درجة الدقة العمودية للبث بالبكسل.
عدد اللقطات في الثانية	إجراء اختياري الرقم تشير هذه السمة إلى عدد اللقطات في الثانية في البث.

المرتجعات

boolean إذا كان بالإمكان تشغيل البث على جهاز chromecast

الحصول على البيانات

تعرض getApplicationData() cast.framework.system.ApplicationData

يقدم معلومات عن التطبيق عندما يكون النظام جاهزًا، وإلا سيكون فارغًا.

المرتجعات

nullable cast.framework.system.ApplicationData معلومات التطبيق أو قيمة فارغة إذا لم يكن النظام جاهزًا.

الحصول على إمكانيات الجهاز

get الجهازCapability() يعرض عنصرًا

يقدم معلومات عن إمكانيات الجهاز عندما يكون النظام جاهزًا، وإلا سيكون فارغًا. وإذا تم عرض عنصر فارغ، لن يكشف الجهاز أي معلومات عن الإمكانات.

المرتجعات

nullable Object معلومات إمكانات الجهاز (أزواج المفتاح/القيمة). وسيكون فارغًا إذا لم يكن النظام جاهزًا بعد. وقد يكون عنصرًا فارغًا إذا لم يُظهر النظام الأساسي أي معلومات حول إمكانيات الجهاز.

GetPlayerManager

تعرض getPlayerManager() cast.framework.PlayerManager

الحصول على مثيل المشغّل الذي يمكنه التحكّم في تشغيل الوسائط ومراقبته.

المرتجعات

non-null cast.framework.PlayerManager 

Getget

getsender(senderId) يعرض cast.framework.system.sender

الحصول على مُرسِل حسب معرّف المرسِل

المَعلمة
IDId للمُرسِل	سلسلة رقم تعريف المُرسِل المطلوب إرجاعه

المرتجعات

nullable cast.framework.system.Sender 

المُرسِلون

تعرض getsenders() مصفوفة من cast.framework.system.system غير فارغة.

الحصول على قائمة بالمُرسِلين المرتبطين حاليًا

المرتجعات

non-null Array of non-null cast.framework.system.Sender 

GetStandbyState

getStandbyState() يعرض cast.framework.system.StandbyState

تقارير إذا كان إدخال HDMI لتطبيق البث في وضع الاستعداد

المرتجعات

non-null cast.framework.system.StandbyState يبيّن ما إذا كان إدخال HDMI للتطبيق في وضع الاستعداد أم لا. وإذا تعذّر تحديد ذلك، لأنّ التلفزيون لا يتوافق مع أوامر CEC، مثلاً، القيمة التي تم عرضها هي غير معروفة.

GetSystemState

تعرض دالة SystemSystemState() cast.framework.system.SystemState.

يقدِّم معلومات عن حالة النظام.

المرتجعات

non-null cast.framework.system.SystemState حالة النظام

الحصول على إذن الوصول

في ما يُظهر فئة AccessState() cast.framework.system.visibilityState

يتم الإبلاغ عن ما إذا كان تطبيق البث هو الإدخال النشط عبر HDMI.

المرتجعات

non-null cast.framework.system.VisibilityState ما إذا كان التطبيق هو الإدخال النشط في HDMI. وإذا تعذّر تحديد ذلك، لأنّ التلفزيون لا يتوافق مع أوامر CEC، مثلاً، القيمة التي تم عرضها هي غير معروفة.

نظام التشغيل الجاهز

دالة isSystemReady() تعرض قيمة منطقية

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

المرتجعات

boolean سواء كان النظام جاهزًا لمعالجة الرسائل أم لا.

تحميل مكتبات التشغيل

LoadPlayerLibraries(useLegacyDashSupport).

ابدأ بتحميل رمز المشغّل js. ويمكن استخدامه لبدء تحميل رمز js للمشغّلات في المرحلة المبكرة من بدء جهاز الاستقبال قبل بدء الاتصال. هذه الدالة عبارة عن عملية مستقلّة إذا تم تحميل المشغّلات من قبل (تم استدعاء البدء).

المَعلمة
استخدامLegacyDashSupport	إجراء اختياري منطقية وتشير إلى أنه يجب استخدام MPL لمحتوى DASH.

إزالة الاستماع المخصّص للرسائل

removeCustomMessageMessageer(اسم مساحة، أداة معالجة)

إزالة أداة معالجة الرسائل على قناة الرسائل المخصّصة

المَعلمة
namespace	سلسلة مساحة الاسم ملاحظة: يجب أن تسبق مساحة الاسم الصالحة السلسلة 'urn:x-cast:'.
أداة معالجة الحدث	دالة(non-blank cast.framework.system.Event)

رمي

Error إذا لم يكن النظام جاهزًا أو كانت مساحة الاسم غير متوافقة مع هذا التطبيق.

إزالة الاستماع إلى حدث

removeEventالاستماعer(النوع، المعالج)

يمكنك إزالة المستمعين لأحداث نظام البث.

المَعلمة
كتابة	cast.framework.system.EventType يجب ألا تكون القيمة فارغة.
معالج	دالة(non-blank cast.framework.system.Event)

SendCustomMessage

SendCustomMessage(namespace, senderId, message)

إرسال رسالة إلى مُرسِل محدّد

المَعلمة
namespace	سلسلة مساحة الاسم ملاحظة: يجب أن تسبق مساحة الاسم الصالحة السلسلة 'urn:x-cast:'.
IDId للمُرسِل	(سلسلة أو غير محدّد) معرّف المرسِل أو غير معرَّف للبث لجميع المُرسِلين.
رسالة	أي نوع الرسالة. يجب ألا تكون القيمة فارغة.

رمي

Error حدث خطأ أثناء إعداد الرسالة.

إرسال الملاحظات

SendfeedbackMessage(feedbackMessage)

يجب استدعاء هذه الدالة استجابةً للحدث الذي تم بدء الملاحظات بشأنه إذا أضاف التطبيق معلومات حالة تصحيح الأخطاء لتسجيل الدخول في تقرير الملاحظات. وتتطلّب هذه المعلّمة معلّمة "message" وهي سلسلة تمثّل معلومات تصحيح الأخطاء التي يريد التطبيق تسجيلها.

المَعلمة
رسالة الملاحظات	سلسلة

منهي العمل به

استخدِم Cast.framework.CastCastrContext#setfeedbackHandler

حالة التطبيق

setApplicationState(statusText)

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

المَعلمة
نص الحالة	سلسلة نص الحالة.

معرِّف مجموعة التعليقات

setfeedbackHandler(feedbackHandler)

يمكنك ضبط معالج لتوفير بيانات إضافية إلى تقرير الملاحظات. سيتم طلب المعالج عند إنشاء ملاحظات، ومن المفترَض أن يتم عرض بيانات إضافية على شكل سلسلة أو وعد سلسلة. من المفترض أن يتم حلّ الموعد المطلوب في غضون 5 ثوانٍ حتى يتم تضمين التقرير في التقرير.

المَعلمة
ملاحظات وآراء	الدالة() قد تكون القيمة فارغة.

تحديد مهلة النشاط

setInactivityTimeout(maxInactivity)

لضبط مهلة عدم نشاط المستلم. يُنصح بضبط الحدّ الأقصى لقيمة عدم النشاط عند طلب "البدء" وعدم تغييره. يتم توفير واجهة برمجة التطبيقات هذه فقط لأغراض التطوير/تصحيح الأخطاء.

المَعلمة
عدم النشاط	الرقم فترة بالثواني قبل إغلاق اتصال غير مستجيب.

SetLoggerLevel

setLoggerLevel(level)

تضبط هذه السياسة مستوى سهول السجلّ.

المَعلمة
المستوى	cast.framework.LoggerLevel مستوى التسجيل: يجب ألا تكون القيمة فارغة.

بدء

Start(options) يعرض cast.framework.CastCastrContext

يُعِدّ مدير النظام ومدير الوسائط، بحيث يمكن لتطبيق المستلِم تلقّي الطلبات من المُرسِلين.

المَعلمة
الخيارات	(غير فارغ cast.framework.CastReceivedrOptions أو عنصر اختياري غير فارغ

المرتجعات

non-null cast.framework.CastReceiverContext 

توقُّف

إيقاف()

إيقاف تطبيق المستلِم