cast. إطار العمل. النظام
هذه هي مساحة الاسم cast.framework.system
.
صفوف
ApplicationData
بيانات التعريف التي تصف بيانات التطبيق الذي تم تشغيله.
الحدث
حدث تم إرساله بواسطة cast.framework.CastReceiverContext والذي يحتوي على معلومات النظام.
FeedbackStartedEvent
يشير ذلك المصطلح إلى حدث يتم إرساله بواسطة cast.framework.CastReceiverContext عندما يبدأ النظام في إنشاء تقرير ملاحظات.
MaxVideoResolutionChangedEvent
يشير ذلك المصطلح إلى حدث يتم إرساله باستخدام cast.framework.CastReceiverContext عندما يحتاج النظام إلى تعديل القيود المفروضة على أقصى درجة لدقة الفيديو.
مراسلة
رسالة مخصصة تم استلامها من مُرسِل. للاستماع إلى الأحداث المخصّصة، استخدِم الطريقة cast.framework.CastReceiverContext#addCustomMessageListener.
ReadyEvent
يشير ذلك المصطلح إلى حدث يتم إرساله باستخدام cast.framework.CastReceiverContext عندما يكون النظام جاهزًا.
المُرسِل
تمثل هذه البيانات بيانات جهاز مُرسِل متصل.
SenderConnectedEvent
يشير ذلك المصطلح إلى حدث يتم إرساله باستخدام cast.framework.CastReceiverContext عند اتصال مُرسِل.
SenderDisconnectedEvent
يشير ذلك المصطلح إلى حدث يتم إرساله باستخدام cast.framework.CastReceiverContext عندما يكون المرسِل غير متصل.
ShutdownEvent
يشير ذلك المصطلح إلى حدث يتم إرساله بواسطة cast.framework.CastReceiverContext عند إيقاف التطبيق.
StandbyChangedEvent
يشير هذا المصطلح إلى حدث يتم إرساله باستخدام cast.framework.CastReceiverContext عند دخول
التلفزيون في حالة الاستعداد أو مغادرتها، لذا يجب أن يتحقّق التطبيق دائمًا من
السمة isStandby
. لمعرفة ما إذا كانت الحالة الفعلية غير معروفة،
يمكن للتطبيق استدعاء الطريقة
cast.framework.CastReceiverContext#getStandbyState.
SystemVolumeChangedEvent
يشير ذلك المصطلح إلى حدث يتم إرساله باستخدام cast.framework.CastReceiverContext عند تغيير مستوى صوت النظام.
SystemVolumeData
ويمثّل ذلك بيانات حجم النظام.
VisibilityChangedEvent
يشير هذا المصطلح إلى حدث يتم إرساله باستخدام cast.framework.CastReceiverContext عند تغيير مستوى رؤية التطبيق، مثلاً عند تغيير إدخال HDMI أو إيقاف التلفزيون.
عمليات التعداد
DeviceCapabilities
سلسلة
تصف إمكانات الإعداد الحالي الذي يتكوّن من جهاز يعمل بتكنولوجيا Google Cast، وجهاز الشاشة المتصل به، حيثما أمكن.
القيمة |
|
---|---|
AUDIO_ASSISTANT |
سلسلة دعم "مساعد Google" الصوتي تشمل الأمثلة على الأجهزة التي تعمل بتكنولوجيا Google Cast مع ميزة "مساعد الصوت" جهاز Google Home وGoogle Home Mini. |
BLUETOOTH_SUPPORTED |
سلسلة إتاحة البلوتوث |
DISPLAY_SUPPORTED |
سلسلة عرض دعم الإخراج ومن أمثلة الأجهزة التي تعمل بتكنولوجيا Google Cast مع دعم الشاشة Chromecast وأجهزة تلفزيون البث. ومن أمثلة الأجهزة التي تعمل بتكنولوجيا Google Cast والتي لا تتوافق مع ميزة العرض بجهاز Chromecast Audio وGoogle Home. |
HI_RES_AUDIO_SUPPORTED |
سلسلة دعم صوت عالي الدقة (يصل إلى 24 بت / 96 كيلوهرتز). |
IS_DV_SUPPORTED |
سلسلة الحصول على الدعم من خلال تقنية Dolby Vision |
IS_HDR_SUPPORTED |
سلسلة إتاحة استخدام الفيديو بنطاق عالي الديناميكية (HDR) |
TOUCH_INPUT_SUPPORTED |
سلسلة دعم الإدخال باللمس من أمثلة الأجهزة التي تعمل بتكنولوجيا Google Cast والتي تتيح الإدخال باللمس Google Nest Hub وGoogle Nest Hub Max. |
IS_GROUP |
سلسلة إذا كان الجهاز جهازًا افتراضيًا ويمثل هدفًا جماعيًا وليس جهازًا ماديًا. |
IS_DEVICE_REGISTERED |
سلسلة عند الضبط على |
IS_CBCS_SUPPORTED |
سلسلة وعند ضبط هذه السياسة على |
IS_DOLBY_ATMOS_SUPPORTED |
سلسلة وتشير هذه العلامة عند ضبطها على |
DisconnectReason
سلسلة
تشير إلى سبب قطع الاتصال.
القيمة |
|
---|---|
REQUESTED_BY_SENDER |
سلسلة تم طلب إغلاق الاتصال بشكل نشط من خلال تطبيق المُرسِل (عادةً ما يشغّله المستخدم). |
خطأ |
سلسلة حدث خطأ في البروتوكول. |
UNKNOWN |
سلسلة من غير المعروف ما إذا طلب المُرسِل قطع الاتصال بأمان من خلال الاتصال بـ |
EventType
سلسلة
أحداث النظام التي تم إرسالها بواسطة cast.framework.CastReceiverContext.
القيمة |
|
---|---|
هيّا بنا |
سلسلة يتم تنشيطها عندما يكون النظام جاهزًا. |
SHUTDOWN |
سلسلة يتم تنشيطها عند إنهاء التطبيق. |
SENDER_CONNECTED |
سلسلة يتم الإطلاق عند اتصال مرسِل جديد. |
SENDER_DISCONNECTED |
سلسلة يتم تنشيطها عندما يتم قطع اتصال أحد المرسلين. |
خطأ |
سلسلة يتم تنشيطها عند حدوث خطأ في النظام. |
SYSTEM_VOLUME_CHANGED |
سلسلة يتم تنشيطها عند تغيير مستوى صوت النظام. |
VISIBILITY_CHANGED |
سلسلة يتم تنشيطها عند تغيير مستوى رؤية التطبيق (على سبيل المثال، بعد تغيير إدخال HDMI أو عند إيقاف التلفزيون أو تشغيله وعندما يكون جهاز البث يعمل خارجيًا). يُرجى العِلم أنّ واجهة برمجة التطبيقات هذه لها التأثير نفسه الذي يؤدي إليه الحدث "webkitvisionchange" الذي طرحه المتصفّح. يتم توفير ذلك على أنه واجهة برمجة التطبيقات cast.framework.CastReceiverContext لتسهيل الأمر ولتجنُّب الاعتماد على حدث يحمل بادئة واجهة برمجة التطبيقات. |
STANDBY_CHANGED |
سلسلة يتم تنشيطه عند تغيّر وضع الاستعداد للتلفزيون. هذا الحدث مرتبط
بالحدث cast.framework.system.EventType.VISIBILITY_CHANGED،
لأنّه إذا كان التلفزيون في وضع الاستعداد، ستكون مستوى الرؤية تكون حالات مستوى الرؤية أكثر دقة من حالات الاستعداد (لأن مستوى الرؤية يشمل أيضًا اختيار القنوات التلفزيونية) ولكن لا يتم رصدها بشكل موثوق في جميع أجهزة التلفزيون. ويمكن استخدام وضع الاستعداد في تلك الحالات لأنّ معظم أجهزة التلفزيون تنفّذه. |
MAX_VIDEO_RESOLUTION_CHANGED |
سلسلة |
FEEDBACK_STARTED |
سلسلة يتم تنشيطها عندما يبدأ النظام في إنشاء تقرير بالملاحظات. |
LaunchedFrom
سلسلة
يمثّل ذلك نوع الطلب الذي أرسل المُستلِم.
القيمة |
|
---|---|
UNKNOWN |
سلسلة تعذّر تحديد مالك الإطلاق. |
الاتصال |
سلسلة تم تشغيل التطبيق من خلال طلب DIAL. |
CAST |
سلسلة تم تشغيل التطبيق من خلال طلب الإصدار الثاني من Cast. |
غَيْمَة |
سلسلة تم تشغيل التطبيق بناءً على طلب من مساعد Google (على سبيل المثال، بطلب من مساعد Google). |
MessageType
سلسلة
أنواع الرسائل المخصصة.
القيمة |
|
---|---|
سلسلة |
سلسلة الرسائل هي سلاسل حرة. ويكون التطبيق مسؤولاً عن ترميز/فك ترميز المعلومات المنقولة. |
JSON |
سلسلة وتكون الرسائل بترميز JSON. ستستخدم عملية النقل الأساسية سلسلة مرمّزة بتنسيق JSON. |
StandbyState
سلسلة
يمثّل ذلك حالة الاستعداد الحالية التي تقدّمها المنصة. وقد تكون الحالة UNKNOWN
إذا لم يتمكن النظام الأساسي للبث من تحديد الحالة.
القيمة |
|
---|---|
وضع الاستعداد |
سلسلة |
NOT_STANDBY |
سلسلة |
UNKNOWN |
سلسلة |
SystemState
سلسلة
ويمثّل ذلك حالة النظام الحالية.
القيمة |
|
---|---|
NOT_STARTED |
سلسلة لم يتم طلب تشغيل التطبيق بعد. |
STARTING_IN_BACKGROUND |
سلسلة جارٍ تشغيل التطبيق ولكنه غير مرئي للمستخدم. |
البدء |
سلسلة جارٍ بدء التطبيق. |
هيّا بنا |
سلسلة التطبيق في المقدّمة وهو جاهز لإرسال الرسائل واستلامها. |
STOPPING_IN_BACKGROUND |
سلسلة يتوقف التطبيق أثناء تشغيله في الخلفية. |
جارٍ الإيقاف |
سلسلة التطبيق متوقف الآن. |
VisibilityState
سلسلة
يمثّل ذلك حالة الظهور الحالية التي توفّرها المنصّة. قد تكون المشكلة هي UNKNOWN
إذا لم تتمكّن منصة Google Cast من تحديد حالة مستوى الرؤية.
القيمة |
|
---|---|
مرئية |
سلسلة |
NOT_VISIBLE |
سلسلة |
UNKNOWN |
سلسلة |
أماكن إقامة
DeviceCapabilities
سلسلة
تصف إمكانات الإعداد الحالي الذي يتكوّن من جهاز يعمل بتكنولوجيا Google Cast، وجهاز الشاشة المتصل به، حيثما أمكن.
القيمة |
|
---|---|
AUDIO_ASSISTANT |
سلسلة دعم "مساعد Google" الصوتي تشمل الأمثلة على الأجهزة التي تعمل بتكنولوجيا Google Cast مع ميزة "مساعد الصوت" جهاز Google Home وGoogle Home Mini. |
BLUETOOTH_SUPPORTED |
سلسلة إتاحة البلوتوث |
DISPLAY_SUPPORTED |
سلسلة عرض دعم الإخراج ومن أمثلة الأجهزة التي تعمل بتكنولوجيا Google Cast مع دعم الشاشة Chromecast وأجهزة تلفزيون البث. ومن أمثلة الأجهزة التي تعمل بتكنولوجيا Google Cast والتي لا تتوافق مع ميزة العرض بجهاز Chromecast Audio وGoogle Home. |
HI_RES_AUDIO_SUPPORTED |
سلسلة دعم صوت عالي الدقة (يصل إلى 24 بت / 96 كيلوهرتز). |
IS_DV_SUPPORTED |
سلسلة الحصول على الدعم من خلال تقنية Dolby Vision |
IS_HDR_SUPPORTED |
سلسلة إتاحة استخدام الفيديو بنطاق عالي الديناميكية (HDR) |
TOUCH_INPUT_SUPPORTED |
سلسلة دعم الإدخال باللمس من أمثلة الأجهزة التي تعمل بتكنولوجيا Google Cast والتي تتيح الإدخال باللمس Google Nest Hub وGoogle Nest Hub Max. |
IS_GROUP |
سلسلة إذا كان الجهاز جهازًا افتراضيًا ويمثل هدفًا جماعيًا وليس جهازًا ماديًا. |
IS_DEVICE_REGISTERED |
سلسلة عند الضبط على |
IS_CBCS_SUPPORTED |
سلسلة وعند ضبط هذه السياسة على |
IS_DOLBY_ATMOS_SUPPORTED |
سلسلة وتشير هذه العلامة عند ضبطها على |
DisconnectReason
سلسلة
تشير إلى سبب قطع الاتصال.
القيمة |
|
---|---|
REQUESTED_BY_SENDER |
سلسلة تم طلب إغلاق الاتصال بشكل نشط من خلال تطبيق المُرسِل (عادةً ما يشغّله المستخدم). |
خطأ |
سلسلة حدث خطأ في البروتوكول. |
UNKNOWN |
سلسلة من غير المعروف ما إذا طلب المُرسِل قطع الاتصال بأمان من خلال الاتصال بـ |
EventType
سلسلة
أحداث النظام التي تم إرسالها بواسطة cast.framework.CastReceiverContext.
القيمة |
|
---|---|
هيّا بنا |
سلسلة يتم تنشيطها عندما يكون النظام جاهزًا. |
SHUTDOWN |
سلسلة يتم تنشيطها عند إنهاء التطبيق. |
SENDER_CONNECTED |
سلسلة يتم الإطلاق عند اتصال مرسِل جديد. |
SENDER_DISCONNECTED |
سلسلة يتم تنشيطها عندما يتم قطع اتصال أحد المرسلين. |
خطأ |
سلسلة يتم تنشيطها عند حدوث خطأ في النظام. |
SYSTEM_VOLUME_CHANGED |
سلسلة يتم تنشيطها عند تغيير مستوى صوت النظام. |
VISIBILITY_CHANGED |
سلسلة يتم تنشيطها عند تغيير مستوى رؤية التطبيق (على سبيل المثال، بعد تغيير إدخال HDMI أو عند إيقاف التلفزيون أو تشغيله وعندما يكون جهاز البث يعمل خارجيًا). يُرجى العِلم أنّ واجهة برمجة التطبيقات هذه لها التأثير نفسه الذي يؤدي إليه الحدث "webkitvisionchange" الذي طرحه المتصفّح. يتم توفير ذلك على أنه واجهة برمجة التطبيقات cast.framework.CastReceiverContext لتسهيل الأمر ولتجنُّب الاعتماد على حدث يحمل بادئة واجهة برمجة التطبيقات. |
STANDBY_CHANGED |
سلسلة يتم تنشيطه عند تغيّر وضع الاستعداد للتلفزيون. هذا الحدث مرتبط
بالحدث cast.framework.system.EventType.VISIBILITY_CHANGED،
لأنّه إذا كان التلفزيون في وضع الاستعداد، ستكون مستوى الرؤية تكون حالات مستوى الرؤية أكثر دقة من حالات الاستعداد (لأن مستوى الرؤية يشمل أيضًا اختيار القنوات التلفزيونية) ولكن لا يتم رصدها بشكل موثوق في جميع أجهزة التلفزيون. ويمكن استخدام وضع الاستعداد في تلك الحالات لأنّ معظم أجهزة التلفزيون تنفّذه. |
MAX_VIDEO_RESOLUTION_CHANGED |
سلسلة |
FEEDBACK_STARTED |
سلسلة يتم تنشيطها عندما يبدأ النظام في إنشاء تقرير بالملاحظات. |
LaunchedFrom
سلسلة
يمثّل ذلك نوع الطلب الذي أرسل المُستلِم.
القيمة |
|
---|---|
UNKNOWN |
سلسلة تعذّر تحديد مالك الإطلاق. |
الاتصال |
سلسلة تم تشغيل التطبيق من خلال طلب DIAL. |
CAST |
سلسلة تم تشغيل التطبيق من خلال طلب الإصدار الثاني من Cast. |
غَيْمَة |
سلسلة تم تشغيل التطبيق بناءً على طلب من مساعد Google (على سبيل المثال، بطلب من مساعد Google). |
MessageType
سلسلة
أنواع الرسائل المخصصة.
القيمة |
|
---|---|
سلسلة |
سلسلة الرسائل هي سلاسل حرة. ويكون التطبيق مسؤولاً عن ترميز/فك ترميز المعلومات المنقولة. |
JSON |
سلسلة وتكون الرسائل بترميز JSON. ستستخدم عملية النقل الأساسية سلسلة مرمّزة بتنسيق JSON. |
StandbyState
سلسلة
يمثّل ذلك حالة الاستعداد الحالية التي تقدّمها المنصة. وقد تكون الحالة UNKNOWN
إذا لم يتمكن النظام الأساسي للبث من تحديد الحالة.
القيمة |
|
---|---|
وضع الاستعداد |
سلسلة |
NOT_STANDBY |
سلسلة |
UNKNOWN |
سلسلة |
SystemState
سلسلة
ويمثّل ذلك حالة النظام الحالية.
القيمة |
|
---|---|
NOT_STARTED |
سلسلة لم يتم طلب تشغيل التطبيق بعد. |
STARTING_IN_BACKGROUND |
سلسلة جارٍ تشغيل التطبيق ولكنه غير مرئي للمستخدم. |
البدء |
سلسلة جارٍ بدء التطبيق. |
هيّا بنا |
سلسلة التطبيق في المقدّمة وهو جاهز لإرسال الرسائل واستلامها. |
STOPPING_IN_BACKGROUND |
سلسلة يتوقف التطبيق أثناء تشغيله في الخلفية. |
جارٍ الإيقاف |
سلسلة التطبيق متوقف الآن. |
VisibilityState
سلسلة
يمثّل ذلك حالة الظهور الحالية التي توفّرها المنصّة. قد تكون المشكلة هي UNKNOWN
إذا لم تتمكّن منصة Google Cast من تحديد حالة مستوى الرؤية.
القيمة |
|
---|---|
مرئية |
سلسلة |
NOT_VISIBLE |
سلسلة |
UNKNOWN |
سلسلة |