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

cast.framework.system

namespace   static

هذه هي مساحة الاسم cast.framework.system.

الدروس

التعدادات

DeviceCapabilities

static

سلسلة

يصف هذا القسم إمكانات الإعداد الحالي الذي يتألف من الجهاز الذي يتيح استخدام Google Cast وجهاز العرض المتصل به، إن وُجد.

القيمة

AUDIO_ASSISTANT

سلسلة

دعم "المساعد الصوتي" تشمل الأمثلة على الأجهزة التي تتيح استخدام Google Cast والمتوافقة مع "المساعد الصوتي" كلاً من Google Home وGoogle Home Mini.

BLUETOOTH_SUPPORTED

سلسلة

يتوافق مع البلوتوث.

DISPLAY_SUPPORTED

سلسلة

إتاحة إخراج العرض تشمل أمثلة الأجهزة التي تتيح استخدام Google Cast وتتضمّن شاشة أجهزة Chromecast وأجهزة التلفزيون التي تتيح استخدام Google Cast. ومن الأمثلة على الأجهزة التي تتيح استخدام Google Cast ولا تتضمّن شاشة، جهاز Chromecast Audio وGoogle Home.

HI_RES_AUDIO_SUPPORTED

سلسلة

دعم الصوت العالي الدقة (ما يصل إلى 24 بت / 96 كيلوهرتز)

IS_DV_SUPPORTED

سلسلة

دعم Dolby Vision

IS_HDR_SUPPORTED

سلسلة

دعم فيديوهات HDR

CAST_LITE_ONLY

سلسلة

ما إذا كان هذا الجهاز يعمل على نظام أساسي صوتي فقط قد لا تكون بعض واجهات برمجة التطبيقات متوافقة بشكل كامل مع هذه المنصات.

DPAD_INPUT_SUPPORTED

سلسلة

ما إذا كان هذا الجهاز يتيح استخدام آلية إدخال، مثل لوحة الاتجاهات لفتح القفل

TOUCH_INPUT_SUPPORTED

سلسلة

دعم الإدخال باللمس تشمل أمثلة الأجهزة التي تتيح استخدام Google Cast وتدعم الإدخال باللمس Google Nest Hub وGoogle Nest Hub Max.

IS_GROUP

سلسلة

إذا كان الجهاز افتراضيًا ويمثّل هدفًا لمجموعة وليس جهازًا فعليًا

IS_DEVICE_REGISTERED

سلسلة

عند ضبط هذه العلامة على true، تشير إلى أنّ جهاز Cast مسجَّل في Cast Developer Console

IS_CBCS_SUPPORTED

سلسلة

عند ضبط هذه العلامة على true، تشير إلى أنّ نظام CBCS‏ (SAMPLE-AES) متوافق.

IS_DOLBY_ATMOS_SUPPORTED

سلسلة

عند ضبط هذه العلامة على true، يشير ذلك إلى أنّ تقنية Dolby Atmos متاحة من خلال ميزة "مرور الصوت".

DeviceInformation

static

سلسلة

English: ثوابت للمفاتيح الصالحة في cast.framework.CastReceiverContext.DeviceInformationObj.

القيمة

MODEL_NAME

سلسلة

اسم طراز الجهاز (مثلاً: Google TV Streamer أو Nest Hub أو Nest Mini وما إلى ذلك) إذا كان معروفًا و"غير معروف" إذا لم تكن معروفة.

BRAND_NAME

سلسلة

اسم العلامة التجارية للجهاز (مثل Google وLG وSony وما إلى ذلك) إذا كان معروفًا وتكون السلسلة فارغة إذا لم تكن معروفة.

OS_NAME

سلسلة

اسم نظام تشغيل الجهاز (مثل Android وFuchsia وLinux وما إلى ذلك) إذا كان معروفًا سلسلة فارغة إذا لم تكن معروفة، أو "not Cast" إذا لم يكن هذا جهاز Cast.

OS_VERSION

سلسلة

إصدار نظام تشغيل الجهاز (مثلاً: 14.0، وما إلى ذلك) إذا كان معروفًا وتكون السلسلة فارغة إذا لم تكن معروفة.

البيئة

سلسلة

نوع البيئة التي يتواجد فيها الجهاز (مثل المنزل أو السيارة أو الطائرة أو الفندق أو غير ذلك) إذا كان معروفًا عادةً ما يكون "home" لمعظم الأجهزة.

DEVICE_ID

سلسلة

المعرّف الفريد لجهاز الاستقبال، إذا كان معروفًا ستكون القيمة نفسها لمعرّف جهاز استقبال البث الذي تعرضه حزمة تطوير البرامج (SDK) الخاصة بجهاز الإرسال. أو سلسلة فارغة إذا لم تكن معروفة.

METADATA_FROM_FIRMWARE

سلسلة

ما إذا كانت معلومات الجهاز قد تم توفيرها من خلال البرنامج الثابت

DisconnectReason

static

سلسلة

تمثّل سبب قطع الاتصال.

القيمة

REQUESTED_BY_SENDER

سلسلة

تم طلب إغلاق الاتصال بشكل نشط من خلال تطبيق المُرسِل (عادةً ما يتم تشغيله من خلال المستخدم).

خطأ

سلسلة

حدث خطأ في البروتوكول.

UNKNOWN

سلسلة

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

APPLICATION_STOP

سلسلة

توقّف تطبيق الاستقبال من تلقاء نفسه.

ABRUPT_SHUTDOWN

سلسلة

أغلقت المنصة التطبيق بينما كان المُرسِلون لا يزالون متصلين.

NO_SENDERS

سلسلة

تم إغلاق التطبيق عندما لم تكن هناك أجهزة إرسال متصلة.

TRANSPORT_CLOSED

سلسلة

أغلق المُرسِل مقبس طبقة المقابس الآمنة (SSL) الأساسي بدون إغلاق الاتصال الافتراضي بشكل صحيح.

TRANSPORT_ABORTED

سلسلة

تم إلغاء مقبس طبقة المقابس الآمنة (SSL) الأساسي من قِبل النظير.

TRANSPORT_TOO_LONG_INACTIVE

سلسلة

تم إغلاق مقبس طبقة المقابس الآمنة (SSL) الأساسي بسبب تعذُّر الإشارة الدورية.

CLOSED_BY_SELF

سلسلة

تم إغلاق الاتصال بشكل صحيح من خلال جهاز استقبال البث.

EventType

static

سلسلة

أحداث النظام التي يتم إرسالها من خلال cast.framework.CastReceiverContext.

القيمة

هيّا بنا

سلسلة

يتم تشغيل هذا الحدث عندما يكون النظام جاهزًا.

SHUTDOWN

سلسلة

يتم تنشيطه عند إنهاء التطبيق.

SENDER_CONNECTED

سلسلة

يتم تنشيطه عند اتصال مُرسِل جديد.

SENDER_DISCONNECTED

سلسلة

يتم تنشيطه عند قطع اتصال المُرسِل.

خطأ

سلسلة

يتم تشغيل هذا الحدث عند حدوث خطأ في النظام.

SYSTEM_VOLUME_CHANGED

سلسلة

يتم تشغيل هذا الحدث عند تغيير مستوى صوت النظام.

VISIBILITY_CHANGED

سلسلة

يتم تفعيل هذا الحدث عندما يتغيّر مستوى ظهور التطبيق (على سبيل المثال، بعد تغيير مصدر إدخال HDMI أو عند إيقاف التلفزيون أو تشغيله وكان جهاز Cast يعمل بمصدر طاقة خارجي). يُرجى العِلم أنّ واجهة برمجة التطبيقات هذه لها التأثير نفسه الذي يحدثه الحدث "webkitvisibilitychange" الذي يرسله المتصفّح. يتم توفير ذلك من خلال واجهة برمجة التطبيقات cast.framework.CastReceiverContext لتسهيل الاستخدام وتجنُّب الاعتماد على حدث مسبوق ببادئة webkit.

STANDBY_CHANGED

سلسلة

يتم تشغيل هذا الحدث عند تغيير حالة الاستعداد للتلفزيون. يرتبط هذا الحدث بالحدث cast.framework.system.EventType.VISIBILITY_CHANGED، لأنّه إذا كان التلفزيون في وضع الاستعداد، ستكون حالة العرض false.

تكون حالات الظهور أكثر دقة من حالات الاستعداد (لأنّ الظهور يتضمّن أيضًا اختيار القناة التلفزيونية)، ولكن لا يتم رصدها بشكل موثوق في جميع أجهزة التلفزيون. يمكن استخدام وضع الاستعداد في هذه الحالات لأنّ معظم أجهزة التلفزيون تستخدمه.

MAX_VIDEO_RESOLUTION_CHANGED

سلسلة

FEEDBACK_STARTED

سلسلة

يتم تشغيل هذا الحدث عندما يبدأ النظام في إنشاء تقرير ملاحظات.

LaunchedFrom

static

سلسلة

يمثّل هذا نوع الطلب الذي أطلق جهاز الاستقبال.

القيمة

UNKNOWN

سلسلة

تعذّر تحديد مالك عملية الإطلاق.

DIAL

سلسلة

تم تشغيل التطبيق من خلال طلب DIAL.

إرسال

سلسلة

تم تشغيل التطبيق من خلال طلب Cast V2.

CLOUD

سلسلة

تم تشغيل التطبيق من خلال طلب موجَّه إلى المساعد (على سبيل المثال، من خلال طلب موجَّه إلى "مساعد Google").

MessageType

static

سلسلة

أنواع الرسائل المخصّصة

القيمة

سلسلة

سلسلة

الرسائل هي سلاسل ذات تصميم مرن. يكون التطبيق مسؤولاً عن ترميز/فك ترميز المعلومات التي يتم نقلها.

JSON

سلسلة

يتم ترميز الرسائل بتنسيق JSON. ستستخدم عملية النقل الأساسية سلسلة بترميز JSON.

StandbyState

static

سلسلة

يمثّل ذلك حالة الاستعداد الحالية التي تبلّغ عنها المنصة. وقد تكون القيمة UNKNOWN إذا لم تتمكّن منصة Cast من تحديد الحالة.

القيمة

بانتظار التسجيل

سلسلة

NOT_STANDBY

سلسلة

UNKNOWN

سلسلة

SystemState

static

سلسلة

ويمثّل ذلك حالة النظام الحالية.

القيمة

NOT_STARTED

سلسلة

لم يتم طلب بدء التطبيق بعد.

STARTING_IN_BACKGROUND

سلسلة

يبدأ التطبيق في العمل ولكنه لا يظهر للمستخدم.

جارٍ البدء

سلسلة

جارٍ بدء تشغيل التطبيق.

هيّا بنا

سلسلة

التطبيق في المقدّمة وجاهز لإرسال الرسائل واستلامها.

STOPPING_IN_BACKGROUND

سلسلة

يتوقف التطبيق أثناء تشغيله في الخلفية.

جارٍ الإيقاف

سلسلة

جارٍ إيقاف التطبيق.

VisibilityState

static

سلسلة

يمثّل ذلك حالة مستوى العرض الحالية التي تبلّغ عنها المنصة. قد تكون القيمة UNKNOWN إذا لم تتمكّن منصة Cast من تحديد حالة مستوى العرض.

القيمة

مرئي

سلسلة

NOT_VISIBLE

سلسلة

UNKNOWN

سلسلة

الخصائص

DeviceCapabilities

static

سلسلة

يصف هذا القسم إمكانات الإعداد الحالي الذي يتألف من الجهاز الذي يتيح استخدام Google Cast وجهاز العرض المتصل به، إن وُجد.

القيمة

AUDIO_ASSISTANT

سلسلة

دعم "المساعد الصوتي" تشمل الأمثلة على الأجهزة التي تتيح استخدام Google Cast والمتوافقة مع "المساعد الصوتي" كلاً من Google Home وGoogle Home Mini.

BLUETOOTH_SUPPORTED

سلسلة

يتوافق مع البلوتوث.

DISPLAY_SUPPORTED

سلسلة

إتاحة إخراج العرض تشمل أمثلة الأجهزة التي تتيح استخدام Google Cast وتتضمّن شاشة أجهزة Chromecast وأجهزة التلفزيون التي تتيح استخدام Google Cast. ومن الأمثلة على الأجهزة التي تتيح استخدام Google Cast ولا تتضمّن شاشة، جهاز Chromecast Audio وGoogle Home.

HI_RES_AUDIO_SUPPORTED

سلسلة

دعم الصوت العالي الدقة (ما يصل إلى 24 بت / 96 كيلوهرتز)

IS_DV_SUPPORTED

سلسلة

دعم Dolby Vision

IS_HDR_SUPPORTED

سلسلة

دعم فيديوهات HDR

CAST_LITE_ONLY

سلسلة

ما إذا كان هذا الجهاز يعمل على نظام أساسي صوتي فقط قد لا تكون بعض واجهات برمجة التطبيقات متوافقة بشكل كامل مع هذه المنصات.

DPAD_INPUT_SUPPORTED

سلسلة

ما إذا كان هذا الجهاز يتيح استخدام آلية إدخال، مثل لوحة الاتجاهات لفتح القفل

TOUCH_INPUT_SUPPORTED

سلسلة

دعم الإدخال باللمس تشمل أمثلة الأجهزة التي تتيح استخدام Google Cast وتدعم الإدخال باللمس Google Nest Hub وGoogle Nest Hub Max.

IS_GROUP

سلسلة

إذا كان الجهاز افتراضيًا ويمثّل هدفًا لمجموعة وليس جهازًا فعليًا

IS_DEVICE_REGISTERED

سلسلة

عند ضبط هذه العلامة على true، تشير إلى أنّ جهاز Cast مسجَّل في Cast Developer Console

IS_CBCS_SUPPORTED

سلسلة

عند ضبط هذه العلامة على true، تشير إلى أنّ نظام CBCS‏ (SAMPLE-AES) متوافق.

IS_DOLBY_ATMOS_SUPPORTED

سلسلة

عند ضبط هذه العلامة على true، يشير ذلك إلى أنّ تقنية Dolby Atmos متاحة من خلال ميزة "مرور الصوت".

DeviceInformation

static

سلسلة

English: ثوابت للمفاتيح الصالحة في cast.framework.CastReceiverContext.DeviceInformationObj.

القيمة

MODEL_NAME

سلسلة

اسم طراز الجهاز (مثلاً: Google TV Streamer أو Nest Hub أو Nest Mini وما إلى ذلك) إذا كان معروفًا و"غير معروف" إذا لم تكن معروفة.

BRAND_NAME

سلسلة

اسم العلامة التجارية للجهاز (مثل Google وLG وSony وما إلى ذلك) إذا كان معروفًا وتكون السلسلة فارغة إذا لم تكن معروفة.

OS_NAME

سلسلة

اسم نظام تشغيل الجهاز (مثل Android وFuchsia وLinux وما إلى ذلك) إذا كان معروفًا سلسلة فارغة إذا لم تكن معروفة، أو "not Cast" إذا لم يكن هذا جهاز Cast.

OS_VERSION

سلسلة

إصدار نظام تشغيل الجهاز (مثلاً: 14.0، وما إلى ذلك) إذا كان معروفًا وتكون السلسلة فارغة إذا لم تكن معروفة.

البيئة

سلسلة

نوع البيئة التي يتواجد فيها الجهاز (مثل المنزل أو السيارة أو الطائرة أو الفندق أو غير ذلك) إذا كان معروفًا عادةً ما يكون "home" لمعظم الأجهزة.

DEVICE_ID

سلسلة

المعرّف الفريد لجهاز الاستقبال، إذا كان معروفًا ستكون القيمة نفسها لمعرّف جهاز استقبال البث الذي تعرضه حزمة تطوير البرامج (SDK) الخاصة بجهاز الإرسال. أو سلسلة فارغة إذا لم تكن معروفة.

METADATA_FROM_FIRMWARE

سلسلة

ما إذا كانت معلومات الجهاز قد تم توفيرها من خلال البرنامج الثابت

DisconnectReason

static

سلسلة

تمثّل سبب قطع الاتصال.

القيمة

REQUESTED_BY_SENDER

سلسلة

تم طلب إغلاق الاتصال بشكل نشط من خلال تطبيق المُرسِل (عادةً ما يتم تشغيله من خلال المستخدم).

خطأ

سلسلة

حدث خطأ في البروتوكول.

UNKNOWN

سلسلة

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

APPLICATION_STOP

سلسلة

توقّف تطبيق الاستقبال من تلقاء نفسه.

ABRUPT_SHUTDOWN

سلسلة

أغلقت المنصة التطبيق بينما كان المُرسِلون لا يزالون متصلين.

NO_SENDERS

سلسلة

تم إغلاق التطبيق عندما لم تكن هناك أجهزة إرسال متصلة.

TRANSPORT_CLOSED

سلسلة

أغلق المُرسِل مقبس طبقة المقابس الآمنة (SSL) الأساسي بدون إغلاق الاتصال الافتراضي بشكل صحيح.

TRANSPORT_ABORTED

سلسلة

تم إلغاء مقبس طبقة المقابس الآمنة (SSL) الأساسي من قِبل النظير.

TRANSPORT_TOO_LONG_INACTIVE

سلسلة

تم إغلاق مقبس طبقة المقابس الآمنة (SSL) الأساسي بسبب تعذُّر الإشارة الدورية.

CLOSED_BY_SELF

سلسلة

تم إغلاق الاتصال بشكل صحيح من خلال جهاز استقبال البث.

EventType

static

سلسلة

أحداث النظام التي يتم إرسالها من خلال cast.framework.CastReceiverContext.

القيمة

هيّا بنا

سلسلة

يتم تشغيل هذا الحدث عندما يكون النظام جاهزًا.

SHUTDOWN

سلسلة

يتم تنشيطه عند إنهاء التطبيق.

SENDER_CONNECTED

سلسلة

يتم تنشيطه عند اتصال مُرسِل جديد.

SENDER_DISCONNECTED

سلسلة

يتم تنشيطه عند قطع اتصال المُرسِل.

خطأ

سلسلة

يتم تشغيل هذا الحدث عند حدوث خطأ في النظام.

SYSTEM_VOLUME_CHANGED

سلسلة

يتم تشغيل هذا الحدث عند تغيير مستوى صوت النظام.

VISIBILITY_CHANGED

سلسلة

يتم تفعيل هذا الحدث عندما يتغيّر مستوى ظهور التطبيق (على سبيل المثال، بعد تغيير مصدر إدخال HDMI أو عند إيقاف التلفزيون أو تشغيله وكان جهاز Cast يعمل بمصدر طاقة خارجي). يُرجى العِلم أنّ واجهة برمجة التطبيقات هذه لها التأثير نفسه الذي يحدثه الحدث "webkitvisibilitychange" الذي يرسله المتصفّح. يتم توفير ذلك من خلال واجهة برمجة التطبيقات cast.framework.CastReceiverContext لتسهيل الاستخدام وتجنُّب الاعتماد على حدث مسبوق ببادئة webkit.

STANDBY_CHANGED

سلسلة

يتم تشغيل هذا الحدث عند تغيير حالة الاستعداد للتلفزيون. يرتبط هذا الحدث بالحدث cast.framework.system.EventType.VISIBILITY_CHANGED، لأنّه إذا كان التلفزيون في وضع الاستعداد، ستكون حالة العرض false.

تكون حالات الظهور أكثر دقة من حالات الاستعداد (لأنّ الظهور يتضمّن أيضًا اختيار القناة التلفزيونية)، ولكن لا يتم رصدها بشكل موثوق في جميع أجهزة التلفزيون. يمكن استخدام وضع الاستعداد في هذه الحالات لأنّ معظم أجهزة التلفزيون تستخدمه.

MAX_VIDEO_RESOLUTION_CHANGED

سلسلة

FEEDBACK_STARTED

سلسلة

يتم تشغيل هذا الحدث عندما يبدأ النظام في إنشاء تقرير ملاحظات.

LaunchedFrom

static

سلسلة

يمثّل هذا نوع الطلب الذي أطلق جهاز الاستقبال.

القيمة

UNKNOWN

سلسلة

تعذّر تحديد مالك عملية الإطلاق.

DIAL

سلسلة

تم تشغيل التطبيق من خلال طلب DIAL.

إرسال

سلسلة

تم تشغيل التطبيق من خلال طلب Cast V2.

CLOUD

سلسلة

تم تشغيل التطبيق من خلال طلب موجَّه إلى المساعد (على سبيل المثال، من خلال طلب موجَّه إلى "مساعد Google").

MessageType

static

سلسلة

أنواع الرسائل المخصّصة

القيمة

سلسلة

سلسلة

الرسائل هي سلاسل ذات تصميم مرن. يكون التطبيق مسؤولاً عن ترميز/فك ترميز المعلومات التي يتم نقلها.

JSON

سلسلة

يتم ترميز الرسائل بتنسيق JSON. ستستخدم عملية النقل الأساسية سلسلة بترميز JSON.

StandbyState

static

سلسلة

يمثّل ذلك حالة الاستعداد الحالية التي تبلّغ عنها المنصة. وقد تكون القيمة UNKNOWN إذا لم تتمكّن منصة Cast من تحديد الحالة.

القيمة

بانتظار التسجيل

سلسلة

NOT_STANDBY

سلسلة

UNKNOWN

سلسلة

SystemState

static

سلسلة

ويمثّل ذلك حالة النظام الحالية.

القيمة

NOT_STARTED

سلسلة

لم يتم طلب بدء التطبيق بعد.

STARTING_IN_BACKGROUND

سلسلة

يبدأ التطبيق في العمل ولكنه لا يظهر للمستخدم.

جارٍ البدء

سلسلة

جارٍ بدء تشغيل التطبيق.

هيّا بنا

سلسلة

التطبيق في المقدّمة وجاهز لإرسال الرسائل واستلامها.

STOPPING_IN_BACKGROUND

سلسلة

يتوقف التطبيق أثناء تشغيله في الخلفية.

جارٍ الإيقاف

سلسلة

جارٍ إيقاف التطبيق.

VisibilityState

static

سلسلة

يمثّل ذلك حالة مستوى العرض الحالية التي تبلّغ عنها المنصة. قد تكون القيمة UNKNOWN إذا لم تتمكّن منصة Cast من تحديد حالة مستوى العرض.

القيمة

مرئي

سلسلة

NOT_VISIBLE

سلسلة

UNKNOWN

سلسلة

الأنواع المجرّدة

DeviceCapabilitiesObj

static

{audio_assistant: (boolean or undefined), bluetooth_supported: (boolean or undefined), display_supported: (boolean or undefined), hi_res_audio_supported: (boolean or undefined), is_dv_supported: (boolean or undefined), is_hdr_supported: (boolean or undefined), cast_lite_only: (boolean or undefined), dpad_input_supported: (boolean or undefined), touch_input_supported: (boolean or undefined), is_group: (boolean or undefined), remote_control_overlay_supported: (boolean or undefined), sleep_timer_overlay_supported: (boolean or undefined), app_foreground: (boolean or undefined), is_device_registered: (boolean or undefined), is_cbcs_supported: (boolean or undefined), is_dolby_atmos_supported: (boolean or undefined)}

تصف هذه السمة العنصر الذي تعرضه الدالة getDeviceCapabilities

انظر أيضًا
cast.framework.system.DeviceCapabilities

DeviceInformationObj

static

{model-name: string, brand-name: string, os-name: string, os-version: string, environment: string, device-id: string, metadata-from-firmware: boolean}

يصف العنصر الذي تعرضه الدالة getDeviceInformation

انظر أيضًا
cast.framework.system.DeviceInformation