مساحة الاسم: النظام

cast.إطار العمل.النظام

namespace   ثابت

هذه هي مساحة الاسم 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	سلسلة عند الضبط على true، تشير هذه العلامة إلى أنّ جهاز البث مسجَّل في وحدة تحكّم مطوّري برامج البث.
IS_CBCS_SUPPORTED	سلسلة وعند ضبط هذه السياسة على true، تشير هذه العلامة إلى توافق نظام CBCS (نموذج-AES) .
IS_DOLBY_ATMOS_SUPPORTED	سلسلة وتشير هذه العلامة عند ضبطها على true إلى أنّ تقنية Dolby Atmos متاحة من خلال تقنية عبور الصوت.

DisconnectReason

ثابت

سلسلة

تشير إلى سبب قطع الاتصال.

القيمة
REQUESTED_BY_SENDER	سلسلة تم طلب إغلاق الاتصال بشكل نشط من خلال تطبيق المُرسِل (عادةً ما يشغّله المستخدم).
خطأ	سلسلة حدث خطأ في البروتوكول.
UNKNOWN	سلسلة من غير المعروف ما إذا طلب المُرسِل قطع الاتصال بأمان من خلال الاتصال بـ close() (على الأرجح لم يحدث ذلك، ولكن ربما تم فقدان رسالة "إغلاق الرسالة"). يحدث هذا عادةً عندما يكون هناك انتهاء مهلة للشبكة أو عند تعطُّل تطبيق المرسِل أو عند إغلاق نظام تشغيل المرسل المقبس.

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، لأنّه إذا كان التلفزيون في وضع الاستعداد، ستكون مستوى الرؤية false. تكون حالات مستوى الرؤية أكثر دقة من حالات الاستعداد (لأن مستوى الرؤية يشمل أيضًا اختيار القنوات التلفزيونية) ولكن لا يتم رصدها بشكل موثوق في جميع أجهزة التلفزيون. ويمكن استخدام وضع الاستعداد في تلك الحالات لأنّ معظم أجهزة التلفزيون تنفّذه.
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	سلسلة عند الضبط على true، تشير هذه العلامة إلى أنّ جهاز البث مسجَّل في وحدة تحكّم مطوّري برامج البث.
IS_CBCS_SUPPORTED	سلسلة وعند ضبط هذه السياسة على true، تشير هذه العلامة إلى توافق نظام CBCS (نموذج-AES) .
IS_DOLBY_ATMOS_SUPPORTED	سلسلة وتشير هذه العلامة عند ضبطها على true إلى أنّ تقنية Dolby Atmos متاحة من خلال تقنية عبور الصوت.

DisconnectReason

ثابت

سلسلة

تشير إلى سبب قطع الاتصال.

القيمة
REQUESTED_BY_SENDER	سلسلة تم طلب إغلاق الاتصال بشكل نشط من خلال تطبيق المُرسِل (عادةً ما يشغّله المستخدم).
خطأ	سلسلة حدث خطأ في البروتوكول.
UNKNOWN	سلسلة من غير المعروف ما إذا طلب المُرسِل قطع الاتصال بأمان من خلال الاتصال بـ close() (على الأرجح لم يحدث ذلك، ولكن ربما تم فقدان رسالة "إغلاق الرسالة"). يحدث هذا عادةً عندما يكون هناك انتهاء مهلة للشبكة أو عند تعطُّل تطبيق المرسِل أو عند إغلاق نظام تشغيل المرسل المقبس.

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، لأنّه إذا كان التلفزيون في وضع الاستعداد، ستكون مستوى الرؤية false. تكون حالات مستوى الرؤية أكثر دقة من حالات الاستعداد (لأن مستوى الرؤية يشمل أيضًا اختيار القنوات التلفزيونية) ولكن لا يتم رصدها بشكل موثوق في جميع أجهزة التلفزيون. ويمكن استخدام وضع الاستعداد في تلك الحالات لأنّ معظم أجهزة التلفزيون تنفّذه.
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	سلسلة