chrome.system.display

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

system.display

الأنواع

ActiveState

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

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

تعداد

"active"

"inactive"

Bounds

الخصائص

  • الارتفاع

    الرقم

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

  • لليسار

    الرقم

    تمثّل الإحداثي السيني للزاوية العلوية اليسرى.

  • العلوية

    الرقم

    المنحنى الصادي للزاوية العلوية اليسرى

  • العرض

    الرقم

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

DisplayLayout

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

الخصائص

  • id

    سلسلة

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

  • offset

    الرقم

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

  • parentId

    سلسلة

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

  • الموضع

    LayoutPosition

    تمثّل هذه السمة موضع التصميم الخاص بهذا العرض بالنسبة إلى العنصر الرئيسي. سيتم تجاهل هذا الإعداد في الجذر.

DisplayMode

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

الخصائص

  • deviceScaleFactor

    الرقم

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

  • الارتفاع

    الرقم

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

  • heightInNativePixels

    الرقم

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

  • isInterlaced

    boolean اختياري

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

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

  • isNative

    قيمة منطقية

    تعرض القيمة "صحيح" إذا كان الوضع هو الوضع الأصلي لشاشة العرض.

  • isSelected

    قيمة منطقية

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

  • refreshRate

    الرقم

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

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

  • uiScale

    number اختياري

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

    استخدام displayZoomFactor

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

  • العرض

    الرقم

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

  • widthInNativePixels

    الرقم

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

DisplayProperties

الخصائص

  • boundsOriginX

    number اختياري

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

  • boundsOriginY

    number اختياري

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

  • displayMode

    DisplayMode اختياري

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

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

  • displayZoomFactor

    number اختياري

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

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

  • isPrimary

    boolean اختياري

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

  • isUnified

    boolean اختياري

    Chrome 59+

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

  • mirroringSourceId

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

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

    استخدِم setMirrorMode.

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

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

    الهوامش الداخلية اختيارية

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

  • التدوير

    number اختياري

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

DisplayUnitInfo

الخصائص

  • activeState

    ActiveState

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

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

  • availableDisplayZoomFactors

    number[]

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

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

  • الحدود

    الحدود

    تمثّل هذه السمة الحدود المنطقية للشاشة.

  • displayZoomFactor

    الرقم

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

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

  • dpiX

    الرقم

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

  • dpiY

    الرقم

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

  • edid

    Edid اختياري

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

    ملاحظة: لا يتوفّر هذا الخيار إلا لتطبيقات Chrome Kiosk.

  • hasTouchSupport

    قيمة منطقية

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

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

  • id

    سلسلة

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

  • isEnabled

    قيمة منطقية

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

  • isPrimary

    قيمة منطقية

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

  • isUnified

    قيمة منطقية

    Chrome 59+

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

  • mirroringDestinationIds

    string[]

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

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

  • mirroringSourceId

    سلسلة

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

  • الأوضاع

    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

    سلسلة

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

  • yearOfManufacture

    الرقم

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

GetInfoFlags

Chrome 59+

الخصائص

  • singleUnified

    boolean اختياري

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

Insets

الخصائص

  • السفلية

    الرقم

    تمثّل هذه السمة المسافة على المحور y من الحدّ الأدنى.

  • لليسار

    الرقم

    تمثّل هذه السمة المسافة على المحور x من الحد الأيسر.

  • لليمين

    الرقم

    تمثّل هذه السمة المسافة بين المحور x والحد الأيمن.

  • العلوية

    الرقم

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

LayoutPosition

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

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

تعداد

"top"

"right"

"bottom"

"left"

MirrorMode

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

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

تعداد

"off"
تحدّد هذه السمة الوضع التلقائي (الوضع الموسّع أو وضع الكمبيوتر المكتبي الموحّد).

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

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

MirrorModeInfo

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

الخصائص

  • mirroringDestinationIds

    string[] اختياري

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

  • mirroringSourceId

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

    معرّف شاشة العرض المصدر للمرآة لا يكون هذا الخيار صالحًا إلا مع القيمة "مختلط".

  • الوضع

    MirrorMode

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

Point

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

الخصائص

  • x

    الرقم

    تمثّل هذه السمة الإحداثي x للنقطة.

  • y

    الرقم

    تمثّل هذه السمة الإحداثي y للنقطة.

TouchCalibrationPair

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

الخصائص

  • displayPoint

    Point

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

  • touchPoint

    Point

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

TouchCalibrationPairQuad

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

الخصائص

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

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

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

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

الطُرق

clearTouchCalibration()

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

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

المعلمات

  • id

    سلسلة

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

completeCustomTouchCalibration()

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

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

المعلمات

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

  • الحدود

    الحدود

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

enableUnifiedDesktop()

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

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

المعلمات

  • مفعّلة

    قيمة منطقية

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

getDisplayLayout()

Promise Chrome 53+ 
chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

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

المعلمات

  • callback

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

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

    (layouts: DisplayLayout[]) => void

المرتجعات

  • Promise<DisplayLayout[]>

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

    Promise يتم تنفيذه مع النتائج.

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

getInfo()

وعد 
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
): Promise<DisplayUnitInfo[]>

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

المعلمات

  • أعلام

    ‫GetInfoFlags اختيارية

    Chrome 59+

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

  • callback

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

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

    (displayInfo: DisplayUnitInfo[]) => void

المرتجعات

  • Promise<DisplayUnitInfo[]>

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

    Promise يتم تنفيذه مع النتائج.

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

overscanCalibrationAdjust()

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

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

المعلمات

  • id

    سلسلة

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

  • مقدار تغيير مسافات الإزاحة في الحواف الخارجية للشاشة

overscanCalibrationComplete()

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

ملاحظة: لا يتوفّر هذا الخيار إلا لتطبيقات Chrome Kiosk. أكمِل تعديلات المسح الزائد لشاشة العرض من خلال حفظ القيم الحالية وإخفاء التراكب.

المعلمات

  • id

    سلسلة

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

overscanCalibrationReset()

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

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

المعلمات

  • id

    سلسلة

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

overscanCalibrationStart()

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

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

المعلمات

  • id

    سلسلة

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

setDisplayLayout()

Promise Chrome 53+ 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

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

المعلمات

  • التصاميم

    DisplayLayout[]

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

    وعد يتم تنفيذه عند انتهاء الدالة.

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

setDisplayProperties()

وعد 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
): Promise<void>

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

المعلمات

  • id

    سلسلة

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

  • معلومات

    DisplayProperties

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

    وعد يتم تنفيذه عند انتهاء الدالة.

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

setMirrorMode()

Promise Chrome 65 أو إصدار أحدث 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

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

المعلمات

  • معلومات

    MirrorModeInfo

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

    وعد يتم تنفيذه عند انتهاء الدالة.

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

showNativeTouchCalibration()

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

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

المعلمات

  • id

    سلسلة

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

  • callback

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

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

    (success: boolean) => void

    • نجاح

      قيمة منطقية

المرتجعات

  • Promise<boolean>

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

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

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

startCustomTouchCalibration()

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

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

المعلمات

  • id

    سلسلة

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

الفعاليات

onDisplayChanged

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

يتم تنشيط هذا الحدث عند إجراء أي تغيير على إعدادات الشاشة.

المعلمات

  • callback

    دالة

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

    () => void