chrome.system.display

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

system.display

الأنواع

ActiveState

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

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

Enum

"active"

"inactive"

Bounds

الخصائص

• الارتفاع

  الرقم

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

• لليسار

  الرقم

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

• العلوية

  الرقم

  الإحداثي الصادي للزاوية العلوية اليمنى

• العرض

  الرقم

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

DisplayLayout

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

الخصائص

• id

  سلسلة

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

• اقتطاع

  الرقم

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

• parentId

  سلسلة

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

• الموضع

  LayoutPosition

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

DisplayMode

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

الخصائص

• deviceScaleFactor

  الرقم

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

• الارتفاع

  الرقم

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

• heightInNativePixels

  الرقم

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

• isInterlaced

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

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

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

• isNative

  قيمة منطقية

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

• isSelected

  قيمة منطقية

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

• refreshRate

  الرقم

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

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

• uiScale

  number اختيارية

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

  استخدام ميزة "displayZoomFactor"

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

• العرض

  الرقم

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

• widthInNativePixels

  الرقم

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

DisplayProperties

الخصائص

• boundsOriginX

  number اختيارية

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

• boundsOriginY

  number اختيارية

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

• displayMode

  DisplayMode اختياري

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

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

• displayZoomFactor

  number اختيارية

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

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

• isPrimary

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

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

• isUnified

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

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

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

• mirroringSourceId

  string اختياري

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

  استخدِم setMirrorMode.

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

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

  Insets اختيارية

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

• دوران

  number اختيارية

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

DisplayUnitInfo

الخصائص

• activeState

  ActiveState

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

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

• availableDisplayZoomFactors

  number[]

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

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

• bounds

  الحدود

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

• displayZoomFactor

  الرقم

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

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

• dpiX

  الرقم

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

• dpiY

  الرقم

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

• edid

  Edid اختياري

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

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

• hasTouchSupport

  قيمة منطقية

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

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

• id

  سلسلة

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

• isEnabled

  قيمة منطقية

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

• isPrimary

  قيمة منطقية

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

• isUnified

  قيمة منطقية

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

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

• mirroringDestinationIds

  string[]

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

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

• mirroringSourceId

  سلسلة

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

• الأوضاع

  DisplayMode[]

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

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

• الاسم

  سلسلة

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

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

  Insets

  الصور المُدرَجة في الشاشة ضمن حدودها تتوفّر هذه الميزة حاليًا على 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

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

الخصائص

• singleUnified

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

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

Insets

الخصائص

• السفلية

  الرقم

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

• لليسار

  الرقم

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

• لليمين

  الرقم

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

• العلوية

  الرقم

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

LayoutPosition

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

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

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

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

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

Enum

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

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

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

MirrorModeInfo

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

الخصائص

• mirroringDestinationIds

  string[] اختياري

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

• mirroringSourceId

  string اختياري

  رقم تعريف شاشة المصدر التي يتم نسخها هذا الخيار صالح فقط للقيمة "mixed".

• الوضع

  MirrorMode

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

Point

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

الخصائص

• x

  الرقم

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

• y

  الرقم

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

TouchCalibrationPair

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

الخصائص

• displayPoint

  Point

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

• touchPoint

  Point

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

TouchCalibrationPairQuad

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

الخصائص

• pair1

  TouchCalibrationPair

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

• pair2

  TouchCalibrationPair

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

• pair3

  TouchCalibrationPair

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

• pair4

  TouchCalibrationPair

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

الطُرق

clearTouchCalibration()

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

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

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

المعلمات

• id

  سلسلة

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

completeCustomTouchCalibration()

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

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

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

المعلمات

• أزواج

  TouchCalibrationPairQuad

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

• bounds

  الحدود

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

enableUnifiedDesktop()

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

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

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

المعلمات

• مفعّلة

  قيمة منطقية

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

getDisplayLayout()

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

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

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

المعلمات

• callback

  function اختياري

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

  (layouts: DisplayLayout[]) => void

  • تنسيقات

    DisplayLayout[]

المرتجعات

• Promise<DisplayLayout[]>

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

  وعد يتم حله بالنتائج.

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

getInfo()

Promise

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

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

المعلمات

• أعلام

  GetInfoFlags اختياري

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

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

• callback

  function اختياري

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

  (displayInfo: DisplayUnitInfo[]) => void

  • displayInfo

    DisplayUnitInfo[]

المرتجعات

• Promise<DisplayUnitInfo[]>

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

  وعد يتم حله بالنتائج.

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

overscanCalibrationAdjust()

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

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

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

المعلمات

• id

  سلسلة

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

• دلتا

  Insets

  المقدار المطلوب لتغيير هوامش العرض الزائد

overscanCalibrationComplete()

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

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

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

المعلمات

• id

  سلسلة

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

overscanCalibrationReset()

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

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

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

المعلمات

• id

  سلسلة

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

overscanCalibrationStart()

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

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

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

المعلمات

• id

  سلسلة

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

setDisplayLayout()

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

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

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

المعلمات

• تنسيقات

  DisplayLayout[]

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

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

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

setDisplayProperties()

Promise

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

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

المعلمات

• id

  سلسلة

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

• معلومات

  DisplayProperties

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

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

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

setMirrorMode()

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

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

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

المعلمات

• معلومات

  MirrorModeInfo

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

• callback

  function اختياري

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

  () => void

المرتجعات

• وعد<فراغ>

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

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

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

showNativeTouchCalibration()

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

chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

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

المعلمات

• id

  سلسلة

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

• callback

  function اختياري

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

  (success: boolean) => void

  • نجاح

    قيمة منطقية

المرتجعات

• Promise<boolean>

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

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

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

startCustomTouchCalibration()

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

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

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

المعلمات

• id

  سلسلة

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

الفعاليات

onDisplayChanged

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

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

المعلمات

• callback

  دالة

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

  () => void