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

cast.framework.system

مساحة الاسم   ثابت

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

الدروس

التعدادات

DeviceCapabilities

ثابتة

سلسلة

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

القيمة

AUDIO_ASSISTANT

سلسلة

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

BLUETOOTH_SUPPORTED

سلسلة

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

DISPLAY_SUPPORTED

سلسلة

إتاحة عرض المخرجات تشمل الأمثلة على الأجهزة المتوافقة مع ميزة "البث" والتي تتضمّن شاشة Chromecast وأجهزة التلفزيون المتوافقة مع ميزة "البث". تشمل أمثلة الأجهزة المتوافقة مع ميزة "البث" التي لا تتوافق مع الشاشات 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 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

ثابتة

سلسلة

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

القيمة

MODEL_NAME

سلسلة

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

BRAND_NAME

سلسلة

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

OS_NAME

سلسلة

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

OS_VERSION

سلسلة

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

البيئة

سلسلة

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

DEVICE_ID

سلسلة

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

METADATA_FROM_FIRMWARE

سلسلة

ما إذا كانت البرامج الثابتة قد قدّمت معلومات الجهاز

DisconnectReason

ثابتة

سلسلة

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

القيمة

REQUESTED_BY_SENDER

سلسلة

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

خطأ

سلسلة

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

UNKNOWN

سلسلة

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

EventType

ثابتة

سلسلة

أحداث النظام التي يتم إرسالها بواسطة cast.framework.CastReceiverContext

القيمة

هيّا بنا

سلسلة

يتم تنشيطه عندما يكون النظام جاهزًا.

SHUTDOWN

سلسلة

يتم إطلاق هذا الحدث عند إيقاف التطبيق.

SENDER_CONNECTED

سلسلة

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

SENDER_DISCONNECTED

سلسلة

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

خطأ

سلسلة

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

SYSTEM_VOLUME_CHANGED

سلسلة

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

VISIBILITY_CHANGED

سلسلة

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

STANDBY_CHANGED

سلسلة

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

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

MAX_VIDEO_RESOLUTION_CHANGED

سلسلة

FEEDBACK_STARTED

سلسلة

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

LaunchedFrom

ثابتة

سلسلة

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

القيمة

UNKNOWN

سلسلة

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

DIAL

سلسلة

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

إرسال

سلسلة

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

CLOUD

سلسلة

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

MessageType

ثابتة

سلسلة

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

القيمة

سلسلة

سلسلة

الرسائل هي سلاسل ذات تنسيق حر. ويتحمّل التطبيق مسؤولية ترميز/فك ترميز المعلومات المرسَلة.

JSON

سلسلة

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

StandbyState

ثابتة

سلسلة

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

القيمة

STANDBY

سلسلة

NOT_STANDBY

سلسلة

UNKNOWN

سلسلة

SystemState

ثابتة

سلسلة

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

القيمة

NOT_STARTED

سلسلة

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

STARTING_IN_BACKGROUND

سلسلة

التطبيق قيد التشغيل ولكنّه غير مرئي للمستخدم.

جارٍ البدء

سلسلة

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

هيّا بنا

سلسلة

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

STOPPING_IN_BACKGROUND

سلسلة

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

إيقاف

سلسلة

يتوقف التطبيق.

VisibilityState

ثابتة

سلسلة

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

القيمة

VISIBLE

سلسلة

NOT_VISIBLE

سلسلة

UNKNOWN

سلسلة

الخصائص

DeviceCapabilities

ثابتة

سلسلة

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

القيمة

AUDIO_ASSISTANT

سلسلة

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

BLUETOOTH_SUPPORTED

سلسلة

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

DISPLAY_SUPPORTED

سلسلة

إتاحة عرض المخرجات تشمل الأمثلة على الأجهزة المتوافقة مع ميزة "البث" والتي تتضمّن شاشة Chromecast وأجهزة التلفزيون المتوافقة مع ميزة "البث". تشمل أمثلة الأجهزة المتوافقة مع ميزة "البث" التي لا تتوافق مع الشاشات 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 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

ثابتة

سلسلة

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

القيمة

MODEL_NAME

سلسلة

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

BRAND_NAME

سلسلة

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

OS_NAME

سلسلة

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

OS_VERSION

سلسلة

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

البيئة

سلسلة

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

DEVICE_ID

سلسلة

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

METADATA_FROM_FIRMWARE

سلسلة

ما إذا كانت البرامج الثابتة قد قدّمت معلومات الجهاز

DisconnectReason

ثابتة

سلسلة

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

القيمة

REQUESTED_BY_SENDER

سلسلة

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

خطأ

سلسلة

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

UNKNOWN

سلسلة

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

EventType

ثابتة

سلسلة

أحداث النظام التي يتم إرسالها بواسطة cast.framework.CastReceiverContext

القيمة

هيّا بنا

سلسلة

يتم تنشيطه عندما يكون النظام جاهزًا.

SHUTDOWN

سلسلة

يتم إطلاق هذا الحدث عند إيقاف التطبيق.

SENDER_CONNECTED

سلسلة

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

SENDER_DISCONNECTED

سلسلة

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

خطأ

سلسلة

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

SYSTEM_VOLUME_CHANGED

سلسلة

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

VISIBILITY_CHANGED

سلسلة

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

STANDBY_CHANGED

سلسلة

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

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

MAX_VIDEO_RESOLUTION_CHANGED

سلسلة

FEEDBACK_STARTED

سلسلة

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

LaunchedFrom

ثابتة

سلسلة

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

القيمة

UNKNOWN

سلسلة

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

DIAL

سلسلة

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

إرسال

سلسلة

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

CLOUD

سلسلة

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

MessageType

ثابتة

سلسلة

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

القيمة

سلسلة

سلسلة

الرسائل هي سلاسل ذات تنسيق حر. ويتحمّل التطبيق مسؤولية ترميز/فك ترميز المعلومات المرسَلة.

JSON

سلسلة

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

StandbyState

ثابتة

سلسلة

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

القيمة

STANDBY

سلسلة

NOT_STANDBY

سلسلة

UNKNOWN

سلسلة

SystemState

ثابتة

سلسلة

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

القيمة

NOT_STARTED

سلسلة

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

STARTING_IN_BACKGROUND

سلسلة

التطبيق قيد التشغيل ولكنّه غير مرئي للمستخدم.

جارٍ البدء

سلسلة

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

هيّا بنا

سلسلة

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

STOPPING_IN_BACKGROUND

سلسلة

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

إيقاف

سلسلة

يتوقف التطبيق.

VisibilityState

ثابتة

سلسلة

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

القيمة

VISIBLE

سلسلة

NOT_VISIBLE

سلسلة

UNKNOWN

سلسلة

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

DeviceCapabilitiesObj

ثابتة

{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

ثابتة

{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