browser.system.display

الوصف

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

الأذونات

system.display

الأنواع

ActiveState

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

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

تعداد

"active"

"inactive"

Bounds

الخصائص

  • الارتفاع

    الرقم

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

  • لليسار

    الرقم

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

  • العلوية

    الرقم

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

  • العرض

    الرقم

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

DisplayLayout

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

الخصائص

  • id

    سلسلة

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

  • offset

    الرقم

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

  • parentId

    سلسلة

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

  • الموضع

    LayoutPosition

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

DisplayMode

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

الخصائص

  • 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 اختيارية

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

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

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

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

  • bounds

    الحدود

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

  • displayZoomFactor

    الرقم

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

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

  • dpiX

    الرقم

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

  • 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[]

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

    قائمة أوضاع العرض المتاحة سيكون للوضع الحالي 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

الخصائص

  • السفلية

    الرقم

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

  • لليسار

    الرقم

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

  • لليمين

    الرقم

    تمثّل هذه السمة المسافة على المحور 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

    نقطة

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

  • touchPoint

    نقطة

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

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

    الحدود

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

enableUnifiedDesktop()

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

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

المعلمات

  • مفعّلة

    قيمة منطقية

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

getDisplayLayout()

Chrome 53 والإصدارات الأحدث 
chrome.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

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

المرتجعات

  • Promise<DisplayLayout[]>

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

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

getInfo()

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

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

المعلمات

  • أعلام

    GetInfoFlags اختيارية

    Chrome 59+

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

المرتجعات

  • Promise<DisplayUnitInfo[]>

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

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

overscanCalibrationAdjust()

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

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

المعلمات

  • 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. تعيد هذه السمة ضبط هوامش overscan لشاشة العرض إلى آخر قيمة تم حفظها (أي قبل استدعاء Start).

المعلمات

  • id

    سلسلة

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

overscanCalibrationStart()

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

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

المعلمات

  • id

    سلسلة

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

setDisplayLayout()

Chrome 53 والإصدارات الأحدث 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

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

المعلمات

  • التصاميم

    DisplayLayout[]

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

المرتجعات

  • Promise<void>

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

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

setDisplayProperties()

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

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

المعلمات

  • id

    سلسلة

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

  • معلومات

    DisplayProperties

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

المرتجعات

  • Promise<void>

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

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

setMirrorMode()

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

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

المعلمات

  • معلومات

    MirrorModeInfo

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

المرتجعات

  • Promise<void>

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

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

showNativeTouchCalibration()

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

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

المعلمات

  • id

    سلسلة

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

المرتجعات

  • Promise<boolean>

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

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

startCustomTouchCalibration()

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

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

المعلمات

  • id

    سلسلة

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

الفعاليات

onDisplayChanged

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

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

المعلمات

  • callback

    دالة

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

    () => void