cast. framework. CastCastrContext
تتم إدارة تحميل المكتبات الأساسية وإعداد حزمة تطوير برامج (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)
تضبط هذه السياسة مستوى سهول السجلّ.
المَعلمة |
|
---|---|
المستوى |
مستوى التسجيل: يجب ألا تكون القيمة فارغة. |
بدء
Start(options) يعرض cast.framework.CastCastrContext
يُعِدّ مدير النظام ومدير الوسائط، بحيث يمكن لتطبيق المستلِم تلقّي الطلبات من المُرسِلين.
المَعلمة |
|
---|---|
الخيارات |
(غير فارغ cast.framework.CastReceivedrOptions أو عنصر اختياري غير فارغ |
- المرتجعات
-
non-null cast.framework.CastReceiverContext
توقُّف
إيقاف()
إيقاف تطبيق المستلِم