chrome.system.display

الوصف

استخدِم واجهة برمجة التطبيقات system.display لطلب البيانات الوصفية المعروضة.

الأذونات

system.display

الأنواع

ActiveState

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

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

تعداد

"active"

"غير نشط"

Bounds

الخصائص

  • الطول

    الرقم

    ارتفاع الشاشة بالبكسل

  • اليسرى

    الرقم

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

  • العلوية

    الرقم

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

  • العرض

    الرقم

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

DisplayLayout

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

الخصائص

  • id

    سلسلة

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

  • offset

    الرقم

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

  • parentId

    سلسلة

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

  • الموضع

    LayoutPosition

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

DisplayMode

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

الخصائص

  • deviceScaleFactor

    الرقم

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

  • الطول

    الرقم

    ارتفاع وضع العرض بوحدات البكسل المستقلة عن الجهاز (الظاهرة للمستخدم)

  • heightInNativePixels

    الرقم

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

  • isInterlaced

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

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

    صحيح إذا كان هذا الوضع متداخلًا، خطأ إذا لم يتم تقديمه.

  • isNative

    قيمة منطقية

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

  • isSelected

    قيمة منطقية

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

  • refreshRate

    الرقم

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

    معدّل إعادة تحميل وضع العرض بالهرتز

  • uiScale

    رقم اختياري

    تم إيقافها نهائيًا منذ الإصدار 70 من Chrome

    استخدام displayZoomFactor

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

  • العرض

    الرقم

    عرض وضع العرض بالبكسل (المرئي للمستخدم) المستقل عن الجهاز

  • widthInNativePixels

    الرقم

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

DisplayProperties

الخصائص

  • boundsOriginX

    رقم اختياري

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

  • boundsOriginY

    رقم اختياري

    في حال ضبطه، يؤدي ذلك إلى تعديل منشأ الحدود المنطقية للعرض على طول محور y. راجِع مستندات المَعلمة boundsOriginX.

  • displayMode

    ‫DisplayMode اختياري

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

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

  • displayZoomFactor

    رقم اختياري

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

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

  • isPrimary

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

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

  • isUnified

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

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

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

  • mirroringSourceId

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

    تم إيقافها نهائيًا بدءًا من الإصدار 68 من Chrome

    استخدِم setMirrorMode.

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

  • عرض مُضخّم

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

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

  • التدوير

    رقم اختياري

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

DisplayUnitInfo

الخصائص

  • activeState

    ActiveState

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

    نشطة إذا رصد النظام الشاشة واستخدامها

  • availableDisplayZoomFactors

    number[]

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

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

  • الحدود

    الحدود

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

  • displayZoomFactor

    الرقم

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

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

  • dpiX

    الرقم

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

  • dpiY

    الرقم

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

  • edid

    ‫Edid اختياري

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

    ملاحظة: لا يتوفّر هذا الخيار إلا لتطبيقات ChromeOS Kiosk وواجهة المستخدم على الويب.

  • hasTouchSupport

    قيمة منطقية

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

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

  • id

    سلسلة

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

  • isEnabled

    قيمة منطقية

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

  • isPrimary

    قيمة منطقية

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

  • isUnified

    قيمة منطقية

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

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

  • mirroringDestinationIds

    string[]

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

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

  • mirroringSourceId

    سلسلة

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

  • الأوضاع

    DisplayMode[]

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

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

  • الاسم

    سلسلة

    الاسم السهل الاستخدام (مثل "شاشة LCD من HP").

  • عرض مُضخّم

    المُدمَجة

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

  • التدوير

    الرقم

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

  • workArea

    الحدود

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

Edid

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

الخصائص

  • manufacturerId

    سلسلة

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

  • productId

    سلسلة

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

  • yearOfManufacture

    الرقم

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

GetInfoFlags

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

الخصائص

  • singleUnified

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

    في حال ضبطها على true، سيعرض getInfo DisplayUnitInfo واحدًا فقط في وضع سطح المكتب الموحّد (راجِع enableUnifiedDesktop). القيمة التلقائية هي false.

Insets

الخصائص

  • السفلية

    الرقم

    المسافة على محور y من الحدّ الأدنى

  • اليسرى

    الرقم

    المسافة على محور x من الحد الأيسر

  • لليمين

    الرقم

    المسافة على محور x من الحد الأيمن

  • العلوية

    الرقم

    مسافة محور y من الحدّ العلوي

LayoutPosition

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

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

تعداد

"top"

"right"

"bottom"

"left"

MirrorMode

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

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

تعداد

"off"
تُحدِّد الوضع التلقائي (سطح المكتب الموسَّع أو الموحَّد).

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

"مختلط"
يُحدِّد أنّه سيتم نسخ شاشة المصدر المحدَّدة على شاشات الوجهة المقدَّمة. سيتم تمديد جميع الشاشات المتصلة الأخرى.

MirrorModeInfo

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

الخصائص

  • mirroringDestinationIds

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

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

  • mirroringSourceId

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

    رقم تعريف شاشة مصدر النسخ المطابق لا ينطبق ذلك إلا على "مختلط".

  • الوضع

    MirrorMode

    وضع عكس الصورة الذي يجب ضبطه

Point

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

الخصائص

  • x

    الرقم

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

  • y

    الرقم

    الإحداثي الصادي للنقطة

TouchCalibrationPair

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

الخصائص

  • displayPoint

    نقطة

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

  • touchPoint

    نقطة

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

TouchCalibrationPairQuad

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

الخصائص

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

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

  • يجب توفُّر زوج ثالث من نقاط اللمس والشاشة لمعايرة اللمس.

  • يجب توفُّر زوج رابع من نقاط اللمس والشاشة لمعايرة اللمس.

الطُرق

clearTouchCalibration()

Chrome 57 والإصدارات الأحدث 
chrome.system.display.clearTouchCalibration(
  id: string,
)

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

المعلمات

  • id

    سلسلة

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

completeCustomTouchCalibration()

Chrome 57 والإصدارات الأحدث 
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
)

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

المعلمات

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

  • الحدود

    الحدود

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

enableUnifiedDesktop()

Chrome 46 والإصدارات الأحدث 
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

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

المعلمات

  • مفعّلة

    قيمة منطقية

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

getDisplayLayout()

الوعد Chrome 53 والإصدارات الأحدث 
chrome.system.display.getDisplayLayout(
  callback?: function,
)

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

المعلمات

  • ردّ الاتصال

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

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

    (layouts: DisplayLayout[]) => void

المرتجعات

  • Promise<DisplayLayout[]>

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

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

getInfo()

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

يطلب هذا الإذن المعلومات عن جميع أجهزة العرض المُرفَقة.

المعلمات

  • أعلام

    GetInfoFlags اختيارية

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

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

  • ردّ الاتصال

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

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

    (displayInfo: DisplayUnitInfo[]) => void

المرتجعات

  • Promise<DisplayUnitInfo[]>

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

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

overscanCalibrationAdjust()

Chrome 53 والإصدارات الأحدث 
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
)

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

المعلمات

  • id

    سلسلة

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

  • المبلغ المطلوب لتغيير الأجزاء المضمّنة في وضع "تمويه الحواف"

overscanCalibrationComplete()

Chrome 53 والإصدارات الأحدث 
chrome.system.display.overscanCalibrationComplete(
  id: string,
)

أكمِل تعديلات "التمويه" لشاشة معيّنة من خلال حفظ القيم الحالية وإخفاء العنصر المتراكب.

المعلمات

  • id

    سلسلة

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

overscanCalibrationReset()

Chrome 53 والإصدارات الأحدث 
chrome.system.display.overscanCalibrationReset(
  id: string,
)

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

المعلمات

  • id

    سلسلة

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

overscanCalibrationStart()

Chrome 53 والإصدارات الأحدث 
chrome.system.display.overscanCalibrationStart(
  id: string,
)

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

المعلمات

  • id

    سلسلة

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

setDisplayLayout()

الوعد Chrome 53 والإصدارات الأحدث 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
)

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

المعلمات

  • layouts

    DisplayLayout[]

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

setDisplayProperties()

الوعد 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
)

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

المعلمات

  • id

    سلسلة

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

  • معلومات

    DisplayProperties

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

setMirrorMode()

الوعد الإصدار 65 من Chrome والإصدارات الأحدث 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

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

المعلمات

  • معلومات

    MirrorModeInfo

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

showNativeTouchCalibration()

الوعد Chrome 57 والإصدارات الأحدث 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

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

المعلمات

  • id

    سلسلة

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

  • ردّ الاتصال

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

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

    (success: boolean) => void

    • النجاح

      قيمة منطقية

المرتجعات

  • Promise<boolean>

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

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

startCustomTouchCalibration()

Chrome 57 والإصدارات الأحدث 
chrome.system.display.startCustomTouchCalibration(
  id: string,
)

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

المعلمات

  • id

    سلسلة

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

الفعاليات

onDisplayChanged

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

يتم تشغيله عند حدوث أي تغيير في إعدادات العرض.

المعلمات

  • ردّ الاتصال

    دالة

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

    () => void