chrome.system.display

الوصف

استخدِم system.display API لطلب البحث عن البيانات الوصفية المعروضة.

الأذونات

system.display

الأنواع

ActiveState

الإصدار 117 من Chrome أو الإصدارات الأحدث

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

Enum

"نشط"

"غير نشِط"

Bounds

أماكن إقامة

• الطول

  الرقم

  تمثّل هذه السمة ارتفاع الشاشة بالبكسل.

• اليسرى

  الرقم

  الإحداثي x للزاوية العلوية اليسرى.

• العلوية

  الرقم

  الإحداثي الصادي (y) للزاوية العلوية اليسرى.

• العرض

  الرقم

  عرض شاشة العرض بالبكسل.

DisplayLayout

الإصدار 53 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• id

  سلسلة

  المعرّف الفريد للشاشة

• اقتطاع

  الرقم

  إزاحة الشاشة على طول الحافة المتصلة 0 يشير إلى محاذاة الزوايا العلوية أو اليسرى.

• parentId

  سلسلة

  المعرّف الفريد للشاشة الرئيسية يكون فارغًا إذا كان هذا هو الجذر.

• الموضع

  LayoutPosition

  موضع تنسيق هذه الشاشة بالنسبة إلى العنصر الرئيسي وسيتم تجاهله بالنسبة إلى الجذر.

DisplayMode

الإصدار 52 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• deviceScaleFactor

  الرقم

  عامل مقياس الجهاز في وضع العرض.

• الطول

  الرقم

  تمثّل هذه السمة ارتفاع وضع العرض بوحدات بكسل مستقلة (مرئية للمستخدم).

• heightInNativePixels

  الرقم

  ارتفاع وضع العرض بالبكسل الأصلي.

• isInterlaced

  قيمة منطقية اختيارية

  الإصدار 74 من Chrome أو الإصدارات الأحدث

  صحيح إذا كان هذا الوضع متداخلاً، ويتم ضبطه على "خطأ" إذا لم يتم توفيره.

• isNative

  منطقي

  صحيح إذا كان الوضع هو الوضع الأصلي للشاشة.

• isSelected

  منطقي

  True إذا كان وضع العرض محددًا حاليًا.

• refreshRate

  الرقم

  الإصدار 67 من Chrome أو الإصدارات الأحدث

  معدّل تحديث وضع العرض بالهرتز.

• uiScale

  الرقم اختياري

  متوقّف منذ إصدار Chrome 70

  استخدام displayZoomFactor

  عامل قياس واجهة المستخدم في وضع العرض.

• العرض

  الرقم

  يشير ذلك إلى عرض وضع العرض بوحدات بكسل مستقلة (مرئية للمستخدم) على الجهاز.

• widthInNativePixels

  الرقم

  عرض وضع العرض بوحدات البكسل الأصلية.

DisplayProperties

أماكن إقامة

• boundsOriginX

  الرقم اختياري

  في حال ضبط هذه السياسة، سيتم تعديل مصدر الحدود المنطقية للشاشة على طول المحور "س". يتم تطبيقها مع boundsOriginY. يتم ضبط القيمة تلقائيًا على القيمة الحالية إذا لم يتم ضبطها وتم ضبط boundsOriginY. يُرجى العِلم أنّه عند تعديل مصدر العرض، سيتم تطبيق بعض القيود، لذا قد يختلف مصدر الحدود النهائية عن مجموعة البيانات الأصلية. يمكن استرداد الحدود النهائية باستخدام getInfo. لا يمكن تغيير مصدر الحدود على الشاشة الأساسية.

• boundsOriginY

  الرقم اختياري

  في حال ضبط هذه السياسة، سيتم تعديل مصدر الحدود المنطقية للشاشة على طول المحور "ص". اطّلِع على مستندات حول المَعلمة boundsOriginX.

• displayMode

  DisplayMode اختياري

  الإصدار 52 من Chrome أو الإصدارات الأحدث

  وفي حال ضبطها، سيتم تعديل وضع العرض إلى الوضع المطابق لهذه القيمة. إذا كانت المَعلمات الأخرى غير صالحة، لن يتم تطبيق ذلك. إذا كان وضع العرض غير صالح، لن يتم تطبيقه وسيتم ضبط خطأ، ولكن سيستمر تطبيق الخصائص الأخرى.

• displayZoomFactor

  الرقم اختياري

  الإصدار 65 من Chrome أو الإصدارات الأحدث

  في حال ضبط هذه السياسة، يتم تعديل مستوى التكبير/التصغير المرتبط بالشاشة. يؤدي هذا التكبير أو التصغير إلى إعادة التخطيط وإعادة الطلاء مما يؤدي إلى الحصول على تكبير/تصغير ذي جودة أفضل من مجرد تنفيذ تكبير تمدد بكسل ببكسل.

• أساسي

  قيمة منطقية اختيارية

  في حال ضبطها على "صحيح"، سيتم ضبط الشاشة على أنّها أساسية. No-op في حال الضبط على false. ملاحظة: في حال ضبط هذه السياسة، سيتم اعتبار العرض أساسيًا لجميع السمات الأخرى (أي أنّه قد يتم ضبط السمة isUnified وقد لا يحدّ من الأصل).

• isUnified

  قيمة منطقية اختيارية

  الإصدار 59 من Chrome أو الإصدارات الأحدث

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

• mirroringSourceId

  سلسلة اختيارية

  متوقّف منذ إصدار Chrome 68

  استخدام setMirrorMode

  نظام التشغيل Chrome فقط. في حال ضبط هذه السياسة ولم تكن فارغة، سيتم تفعيل ميزة "المزامنة على الجهاز وفي السحابة الإلكترونية" لهذه الشاشة فقط. من ناحية أخرى، يتم إيقاف النسخ المطابق لجميع الشاشات. يجب أن تشير هذه القيمة إلى معرّف شاشة المصدر المراد مزامنتها على الجهاز وفي السحابة الإلكترونية، ويجب ألا يكون مطابقًا لرقم التعريف الذي تم تمريره إلى setDisplayProperties. وفي حال ضبطها، لا يمكن ضبط أي سمة أخرى.

• الخروج عن إطار الشاشة

  العناصر الداخلية اختيارية

  في حال ضبط هذه السياسة، يتم ضبط القيم الداخلية المدرَجة في الشاشة الخارجية على القيم المقدَّمة. يُرجى العلم أنّ قيم الخروج عن إطار الشاشة قد لا تكون سالبة أو أكبر من نصف حجم الشاشة. لا يمكن تغيير الخروج عن الشاشة على الشاشة الداخلية.

• تدوير

  الرقم اختياري

  في حال ضبط هذه السياسة، يتم تعديل دوران الشاشة. القيم القانونية هي [0، 90، 180، 270]. يتم ضبط التدوير في اتجاه عقارب الساعة، بالنسبة إلى الوضع العمودي للشاشة.

DisplayUnitInfo

أماكن إقامة

• activeState

  ActiveState

  الإصدار 117 من Chrome أو الإصدارات الأحدث

  نشطة إذا اكتشف النظام الشاشة واستخدمها.

• availableDisplayZoomFactors

  رقم[]

  الإصدار 67 من Chrome أو الإصدارات الأحدث

  قائمة بقيم عامل التكبير/التصغير التي يمكن ضبطها للشاشة.

• حدود

  الحدود

  الحدود المنطقية للشاشة

• displayZoomFactor

  الرقم

  الإصدار 65 من Chrome أو الإصدارات الأحدث

  يشير إلى النسبة بين مستوى التكبير أو التصغير الحالي والتلقائي للشاشة. على سبيل المثال، تعادل القيمة 1 نسبة التكبير أو التصغير بنسبة 100%، وتساوي القيمة 1.5 نسبة التكبير أو التصغير بنسبة 150%.

• dpiX

  الرقم

  عدد وحدات البكسل لكل بوصة على طول المحور x.

• dpiY

  الرقم

  عدد وحدات البكسل في البوصة على طول المحور ص.

• عيد الفطر

  Edid اختيارية

  الإصدار 67 من Chrome أو الإصدارات الأحدث

  ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات Kiosk لنظام التشغيل Chrome وواجهة مستخدم الويب.

• hasTouchSupport

  منطقي

  الإصدار 57 من Chrome أو الإصدارات الأحدث

  صحيح إذا كانت هذه الشاشة تتضمن جهاز إدخال باللمس مرتبطًا بها.

• id

  سلسلة

  المعرّف الفريد للشاشة

• isEnabled

  منطقي

  صحيح إذا تم تفعيل هذه الشاشة.

• أساسي

  منطقي

  True إذا كانت هذه هي الشاشة الأساسية.

• isUnified

  منطقي

  الإصدار 59 من Chrome أو الإصدارات الأحدث

  صحيح لجميع الشاشات عند استخدام وضع سطح المكتب الموحّد. اطّلِع على مستندات حول enableUnifiedDesktop.

• mirroringDestinationIds

  سلسلة[]

  الإصدار 64 من Chrome أو الإصدارات الأحدث

  نظام التشغيل Chrome فقط. معرّفات شاشات العرض التي يتم إنشاء نسخة مطابقة من العرض المصدر عليها. تكون هذه السمة فارغة في حال عدم استخدام ميزة "المزامنة على الجهاز وفي السحابة الإلكترونية" للشاشات. سيتم ضبطها على القيمة نفسها لجميع الشاشات. ويجب ألا يشمل ذلك mirroringSourceId.

• mirroringSourceId

  سلسلة

  نظام التشغيل Chrome فقط. معرّف الشاشة التي يتم مزامنتها على الجهاز وفي السحابة الإلكترونية في حال تفعيل ميزة "المزامنة على الجهاز وفي السحابة الإلكترونية"، وتكون فارغة إذا لم تكن هذه المعلومات مفعّلة سيتم ضبط ذلك على جميع الشاشات (بما في ذلك الشاشة التي يتم إجراء نسخ مطابق لها).

• وسائل النقل

  DisplayMode[]

  الإصدار 52 من Chrome أو الإصدارات الأحدث

  قائمة أوضاع العرض المتاحة. سيحتوي الوضع الحالي على isSelected=true. لا تتوفّر هذه الميزة إلا على نظام التشغيل ChromeOS. سيتم ضبطها على مصفوفة فارغة على الأنظمة الأساسية الأخرى.

• الاسم

  سلسلة

  اسم سهل الاستخدام (على سبيل المثال، "شاشة LCD HP").

• الخروج عن إطار الشاشة

  مساحات داخلية

  الأجزاء الداخلية للشاشة ضمن حدود الشاشة يتم عرضه حاليًا على نظام التشغيل ChromeOS فقط. سيتم ضبطها على مساحات داخلية فارغة على الأنظمة الأساسية الأخرى.

• تدوير

  الرقم

  دوران الشاشة في اتجاه عقارب الساعة بالدرجات بالنسبة إلى الموضع الرأسي يتم عرضه حاليًا على نظام التشغيل ChromeOS فقط. سيتم ضبطها على 0 على الأنظمة الأساسية الأخرى. سيتم تفسير القيمة -1 على أنّها "تدوير تلقائي" عندما يكون الجهاز في حالة فعلية للجهاز اللوحي.

• workArea

  الحدود

  مساحة العمل القابلة للاستخدام على الشاشة داخل حدود الشاشة. تستبعد مساحة العمل مناطق العرض المحجوزة لنظام التشغيل، على سبيل المثال شريط التطبيقات ومشغّل التطبيقات.

Edid

الإصدار 67 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• manufacturerId

  سلسلة

  رمز الشركة المصنّعة المكوَّن من 3 أحرف راجع قسم 3.4.1 الصفحة 21. مطلوبة في الإصدار 1.4

• productId

  سلسلة

  رمز برمجي محدد من الشركة المصنّعة بسعة 2 بايت، Sec. 3.4.2 الصفحة 21. مطلوبة في الإصدار 1.4

• yearOfManufacture

  الرقم

  سنة التصنيع، ثانية 3.4.4 الصفحة 22. مطلوبة في الإصدار 1.4

GetInfoFlags

الإصدار 59 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• singleUnified

  قيمة منطقية اختيارية

  وفي حال ضبطها على "صحيح"، سيتم عرض رمز DisplayUnitInfo واحد فقط من خلال getInfo عند استخدام وضع سطح المكتب الموحّد (راجِع enableUnifiedDesktop). وتكون القيمة التلقائية على "خطأ".

Insets

أماكن إقامة

• السفلية

  الرقم

  مسافة المحور ص من الحد السفلي.

• اليسرى

  الرقم

  مسافة المحور س من الحد الأيسر.

• لليمين

  الرقم

  مسافة المحور س من الحد الأيمن.

• العلوية

  الرقم

  مسافة المحور ص من الحد العلوي.

LayoutPosition

الإصدار 53 من Chrome أو الإصدارات الأحدث

موضع التصميم، أي حافة العنصر الرئيسي الذي يتم ربط الشاشة به

Enum

"الأعلى"

يمين

"أسفل"

"اليسار"

MirrorMode

الإصدار 65 من Chrome أو الإصدارات الأحدث

وضع المرآة، أي الطرق المختلفة لكيفية عكس الشاشة على الشاشات الأخرى.

Enum

"إيقاف"
يحدد هذا الإعداد الوضع التلقائي (سطح المكتب الموسّع أو الموحَّد).

"عادي"
يحدد هذا الإعداد أنّ عرض المصدر التلقائي سيتم عكسه على جميع الشاشات الأخرى.

"mixed"
يحدد هذا الإعداد أنّ عرض المصدر المحدّد سيتم عكسه مع شاشات الوجهة التي تم تقديمها. وسيتم توسيع نطاق جميع الشاشات المرتبطة الأخرى.

MirrorModeInfo

الإصدار 65 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• mirroringDestinationIds

  string[] اختيارية

  يتم عرض معرّفات وجهة النسخ المطابق. ينطبق هذا على "المختلط" فقط.

• mirroringSourceId

  سلسلة اختيارية

  معرّف عرض المصدر على الجهاز وفي السحابة الإلكترونية ينطبق هذا على "المختلط" فقط.

• الوضع

  MirrorMode

  وضع المرآة الذي يجب ضبطه

Point

الإصدار 57 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• x

  الرقم

  إحداثي x للنقطة.

• y

  الرقم

  إحداثي y للنقطة.

TouchCalibrationPair

الإصدار 57 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• displayPoint

  نقطة

  إحداثيات نقطة العرض.

• touchPoint

  نقطة

  إحداثيات نقطة اللمس المقابلة لنقطة العرض

TouchCalibrationPairQuad

الإصدار 57 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• pair1

  TouchCalibrationPair

  يجب أول زوج من نقاط اللمس ونقطة العرض للمعايرة باللمس.

• pair2

  TouchCalibrationPair

  يجب توصيل زوج ثانٍ من اللمس ونقطة العرض للمعايرة باللمس.

• pair3

  TouchCalibrationPair

  يجب استخدام الزوج الثالث من نقطة اللمس ونقطة العرض للمعايرة باللمس.

• pair4

  TouchCalibrationPair

  يجب توصيل الزوج الرابع من نقاط اللمس ونقطة العرض للمعايرة باللمس.

الطُرق

clearTouchCalibration()

الإصدار 57 من Chrome أو الإصدارات الأحدث

chrome.system.display.clearTouchCalibration(
  id: string,
)

يؤدي هذا الإجراء إلى إعادة ضبط معايرة اللمس على الشاشة وإعادتها إلى حالتها التلقائية من خلال محو أي بيانات خاصة بمعايرة اللمس ومرتبطة بالشاشة.

المعلمات

• id

  سلسلة

  المعرّف الفريد للشاشة

completeCustomTouchCalibration()

الإصدار 57 من Chrome أو الإصدارات الأحدث

chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
)

تتيح هذه السياسة ضبط أزواج معايرة الشاشة باللمس. سيتم استخدام "pairs" هذه لمعايرة الشاشة التي تعمل باللمس للعرض باستخدام id التي يتم استدعاؤها في startCustomTouchCalibration(). عليك دائمًا طلب startCustomTouchCalibration قبل طلب هذه الطريقة. وفي حال إجراء معايرة أخرى باللمس، ستظهر رسالة خطأ.

المعلمات

• أزواج

  TouchCalibrationPairQuad

  أزواج النقاط المستخدمة لمعايرة الشاشة.

• حدود

  الحدود

  حدود الشاشة عند إجراء معايرة اللمس. ويتم تجاهل قيمتَي bounds.left وbounds.top.

enableUnifiedDesktop()

الإصدار 46 من Chrome أو الإصدارات الأحدث

chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

لتفعيل/إيقاف ميزة سطح المكتب الموحّد. في حال تفعيل ميزة "المزامنة على الجهاز وفي السحابة الإلكترونية" وتفعيلها، لن يتغيّر وضع سطح المكتب إلى أن يتم إيقافها. وبخلاف ذلك، سيتم تبديل وضع سطح المكتب إلى الوضع الموحّد على الفور. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات Kiosk لنظام التشغيل Chrome وواجهة مستخدم الويب.

المعلمات

• مفعّلة

  منطقي

  صحيح إذا كان يجب تفعيل سطح المكتب الموحّد.

getDisplayLayout()

وعود الإصدار 53 من Chrome أو الإصدارات الأحدث

chrome.system.display.getDisplayLayout(
  callback?: function,
)

تطلب معلومات التنسيق لجميع الشاشات. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات Kiosk لنظام التشغيل Chrome وواجهة مستخدم الويب.

المعلمات

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (layouts: DisplayLayout[]) => void

  • التنسيقات

    DisplayLayout[]

المرتجعات

• Promise<DisplayLayout[]>

  الإصدار 91 من Chrome أو الإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

getInfo()

وعود

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

تطلب الحصول على معلومات عن جميع أجهزة العرض المتصلة.

المعلمات

• أعلام

  GetInfoFlags اختيارية

  الإصدار 59 من Chrome أو الإصدارات الأحدث

  الخيارات التي تؤثّر في كيفية عرض المعلومات.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (displayInfo: DisplayUnitInfo[]) => void

  • displayInfo

    DisplayUnitInfo[]

المرتجعات

• Promise<DisplayUnitInfo[]>

  الإصدار 91 من Chrome أو الإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

overscanCalibrationAdjust()

الإصدار 53 من Chrome أو الإصدارات الأحدث

chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
)

يؤدي هذا الإجراء إلى ضبط الأجزاء الداخلية الحالية لميزة الخروج عن إطار الشاشة للعرض. من المفترض أن يؤدي هذا عادةً إما إلى تحريك الشاشة على طول محور (على سبيل المثال، لهما القيمة نفسها من اليسار واليمين) أو تغيير حجمه على محور (على سبيل المثال، يحتوي الجزء العلوي + السفلي على قيم معاكسة). تظل كل مكالمة Adjust تراكمية مع المكالمات السابقة منذ البدء.

المعلمات

• id

  سلسلة

  المعرّف الفريد للشاشة

• دلتا

  مساحات داخلية

  المبلغ المطلوب تغيير الإدخالات المرتبطة بالجزء الخارجي.

overscanCalibrationComplete()

الإصدار 53 من Chrome أو الإصدارات الأحدث

chrome.system.display.overscanCalibrationComplete(
  id: string,
)

أكمل تعديلات الخروج عن الشاشة لأحد الشاشات من خلال حفظ القيم الحالية وإخفاء التراكب.

المعلمات

• id

  سلسلة

  المعرّف الفريد للشاشة

overscanCalibrationReset()

الإصدار 53 من Chrome أو الإصدارات الأحدث

chrome.system.display.overscanCalibrationReset(
  id: string,
)

يعيد هذا الإعداد ضبط الإدخالات الخاصة بإظهار الشاشة على آخر قيمة محفوظة (أي قبل طلب بدء العملية).

المعلمات

• id

  سلسلة

  المعرّف الفريد للشاشة

overscanCalibrationStart()

الإصدار 53 من Chrome أو الإصدارات الأحدث

chrome.system.display.overscanCalibrationStart(
  id: string,
)

لبدء معايرة الخروج عن الشاشة لأحد الشاشات سيؤدي ذلك إلى ظهور تراكب على الشاشة يشير إلى الأجزاء الداخلية الحالية الخروج عن إطار الشاشة. إذا كانت معايرة الخروج عن إطار الشاشة لجهاز العرض id قيد التقدّم، سيؤدي ذلك إلى إعادة ضبط المعايرة.

المعلمات

• id

  سلسلة

  المعرّف الفريد للشاشة

setDisplayLayout()

وعود الإصدار 53 من Chrome أو الإصدارات الأحدث

chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
)

يمكنك ضبط التنسيق لجميع الشاشات. وسيتم استخدام التنسيق التلقائي في أي شاشة عرض غير مضمّنة. إذا كان هناك تخطيط يتداخل أو يكون غير صالح، فسيتم تعديله إلى تنسيق صالح. بعد حلّ التنسيق، سيتمّ تشغيل حدث onDisplayChanged. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات Kiosk لنظام التشغيل Chrome وواجهة مستخدم الويب.

المعلمات

• التنسيقات

  DisplayLayout[]

  معلومات التنسيق، المطلوبة لجميع الشاشات باستثناء الشاشة الأساسية.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعود <باطلة>

  الإصدار 91 من Chrome أو الإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

setDisplayProperties()

وعود

chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
)

يعدِّل خصائص الشاشة المحددة من قِبل id، وفقًا للمعلومات المُقدّمة في info. في حال تعذُّر العملية، سيتم ضبط runtime.lastError. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات Kiosk لنظام التشغيل Chrome وواجهة مستخدم الويب.

المعلمات

• id

  سلسلة

  المعرّف الفريد للشاشة

• معلومات

  DisplayProperties

  المعلومات المتعلقة بخصائص العرض التي يجب تغييرها. لن يتم تغيير السمة إلا إذا تم تحديد قيمة جديدة لها في info.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعود <باطلة>

  الإصدار 91 من Chrome أو الإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

setMirrorMode()

وعود الإصدار 65 من Chrome والإصدارات الأحدث

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

لضبط وضع العرض على وضع المرآة المحدّد. تؤدي كل مكالمة إلى إعادة ضبط الحالة من المكالمات السابقة. سيفشل استدعاء setDisplayProperties() في شاشات وجهة النسخ المطابق. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات Kiosk لنظام التشغيل Chrome وواجهة مستخدم الويب.

المعلمات

• معلومات

  MirrorModeInfo

  معلومات وضع المرآة التي يجب تطبيقها على وضع العرض.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعود <باطلة>

  الإصدار 91 من Chrome أو الإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

showNativeTouchCalibration()

وعود الإصدار 57 من Chrome أو الإصدارات الأحدث

chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

تعرض هذه السياسة تجربة معايرة الشاشة الأصلية التي تعمل باللمس للشاشة باستخدام id كرقم تعريف معروض. سيؤدي هذا إلى ظهور طبقة متراكبة على الشاشة تتضمن التعليمات المطلوبة حول كيفية المتابعة. سيتم استدعاء هذه الدالة في حال إجراء المعايرة بنجاح فقط. وإذا فشلت المعايرة، سيؤدي ذلك إلى حدوث خطأ.

المعلمات

• id

  سلسلة

  المعرّف الفريد للشاشة

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    منطقي

المرتجعات

• Promise&lt;boolean&gt;

  الإصدار 91 من Chrome أو الإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

startCustomTouchCalibration()

الإصدار 57 من Chrome أو الإصدارات الأحدث

chrome.system.display.startCustomTouchCalibration(
  id: string,
)

لبدء معايرة اللمس المخصّصة لإحدى الشاشات ويجب طلب ذلك عند استخدام تجربة مستخدم مخصّصة لجمع بيانات المعايرة. وفي حال إجراء معايرة أخرى باللمس، ستظهر رسالة خطأ.

المعلمات

• id

  سلسلة

  المعرّف الفريد للشاشة

فعاليات

onDisplayChanged

chrome.system.display.onDisplayChanged.addListener(
  callback: function,
)

يتم الإطلاق عند إجراء أي تغيير على إعدادات العرض.

المعلمات

• رد الاتصال

  دالة

  تظهر المَعلمة callback على النحو التالي:

  () => void