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 أو الإصدارات الأحدث

أماكن إقامة

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

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

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

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

الطُرق

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 قبل طلب هذه الطريقة. وفي حال إجراء معايرة أخرى باللمس، ستظهر رسالة خطأ.

المعلمات

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

  • حدود

    الحدود

    حدود الشاشة عند إجراء معايرة اللمس. ويتم تجاهل قيمتَي 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

المرتجعات

  • Promise<DisplayLayout[]>

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

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

getInfo()

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

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

المعلمات

  • أعلام

    GetInfoFlags اختيارية

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

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

  • رد الاتصال

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

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

    (displayInfo: DisplayUnitInfo[]) => void

المرتجعات

  • 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