chrome.system.display

الوصف

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

الأذونات

system.display

الأنواع

ActiveState

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

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

التعداد

Bounds

أماكن إقامة

• الطول

  الرقم

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

• لليسار

  الرقم

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

• النصف العلوي

  الرقم

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

• العرض

  الرقم

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

DisplayLayout

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

أماكن إقامة

• id

  سلسلة

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

• فرق التوقيت

  الرقم

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

• parentId

  سلسلة

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

• الموضع

  LayoutPosition

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

DisplayMode

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

أماكن إقامة

• deviceScaleFactor

  الرقم

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

• الطول

  الرقم

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

• heightInNativePixels

  الرقم

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

• isInterlaced

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

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

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

• isNative

  boolean

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

• isSelected

  boolean

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

• 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

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

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

• isUnified

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

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

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

• mirroringSourceId

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

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

  استخدِم setMirrorMode.

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

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

  عمليات الإدراج اختيارية

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

• دوران

  الرقم اختياري

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

DisplayUnitInfo

أماكن إقامة

• activeState

  ActiveState

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

  نشطة إذا اكتشف النظام الشاشة يستخدمها.

• availableDisplayZoomFactors

  الرقم[]

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

  تمثّل هذه السمة قائمة بقيم عامل التكبير/التصغير التي يمكن ضبطها للعرض.

• حدود

  الحدود

  الحدود المنطقية للعرض.

• displayZoomFactor

  الرقم

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

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

• dpiX

  الرقم

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

• dpiY

  الرقم

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

• edid

  Edid اختيارية

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

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

• hasTouchSupport

  boolean

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

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

• id

  سلسلة

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

• isEnabled

  boolean

  True إذا كانت هذه الشاشة مفعّلة.

• isPrimary

  boolean

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

• isUnified

  boolean

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

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

• mirroringDestinationIds

  سلسلة[]

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

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

• mirroringSourceId

  سلسلة

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

• modes

  DisplayMode[]

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

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

• اسم

  سلسلة

  اسم سهل الاستخدام (على سبيل المثال "شاشة HP LCD")

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

  المساحات الداخلية

  المساحات الداخلية للعرض ضمن حدود شاشتها. يتم عرضه حاليًا على نظام التشغيل 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

أماكن إقامة

• النصف السفلي

  الرقم

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

• لليسار

  الرقم

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

• لليمين

  الرقم

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

• النصف العلوي

  الرقم

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

LayoutPosition

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

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

التعداد

MirrorMode

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

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

التعداد

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

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

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

MirrorModeInfo

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

أماكن إقامة

• mirroringDestinationIds

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

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

• mirroringSourceId

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

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

• الوضع

  MirrorMode

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

Point

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

أماكن إقامة

• x

  الرقم

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

• y

  الرقم

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

TouchCalibrationPair

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

أماكن إقامة

• displayPoint

  نقطة

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

• touchPoint

  نقطة

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

TouchCalibrationPairQuad

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

أماكن إقامة

• pair1

  TouchCalibrationPair

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

• pair2

  TouchCalibrationPair

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

• pair3

  TouchCalibrationPair

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

• pair4

  TouchCalibrationPair

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

الطُرق

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 قبل استدعاء هذه الطريقة. إذا كانت معايرة اللمس الأخرى قيد التقدّم، سيؤدي ذلك إلى ظهور خطأ.

المَعلمات

• أزواج

  TouchCalibrationPairQuad

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

• حدود

  الحدود

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

enableUnifiedDesktop()

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

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

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

المَعلمات

• مفعّلة

  boolean

  True في حال كان يجب تفعيل سطح المكتب الموحَّد.

getDisplayLayout()

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

chrome.system.display.getDisplayLayout(
  callback?: function,
)

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

المَعلمات

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (layouts: DisplayLayout[])=>void

  • التنسيقات

    DisplayLayout[]

المرتجعات

• Promise<DisplayLayout[]>

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

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

getInfo()

وعد

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

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

المَعلمات

• أعلام

  GetInfoFlags اختيارية

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (displayInfo: DisplayUnitInfo[])=>void

  • displayInfo

    DisplayUnitInfo[]

المرتجعات

• Promise<DisplayUnitInfo[]>

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

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

overscanCalibrationAdjust()

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

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

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

المَعلمات

• id

  سلسلة

  تمثّل هذه السمة المعرّف الفريد للعرض.

• دلتا

  المساحات الداخلية

  مقدار تغيير الإضافات الزائدة.

overscanCalibrationComplete()

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

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

أكمل التعديلات الزائدة في العرض عن طريق حفظ القيم الحالية وإخفاء التراكب.

المَعلمات

• id

  سلسلة

  تمثّل هذه السمة المعرّف الفريد للعرض.

overscanCalibrationReset()

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

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

إعادة ضبط الأجزاء الداخلية الزائدة لعرض الشاشة على آخر قيمة محفوظة (أي قبل طلب البدء).

المَعلمات

• id

  سلسلة

  تمثّل هذه السمة المعرّف الفريد للعرض.

overscanCalibrationStart()

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

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

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

المَعلمات

• id

  سلسلة

  تمثّل هذه السمة المعرّف الفريد للعرض.

setDisplayLayout()

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

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

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

المَعلمات

• التنسيقات

  DisplayLayout[]

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

setDisplayProperties()

وعد

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

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

المَعلمات

• id

  سلسلة

  تمثّل هذه السمة المعرّف الفريد للعرض.

• معلومات

  DisplayProperties

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

setMirrorMode()

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

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

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

المَعلمات

• معلومات

  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

  • نجاح

    boolean

المرتجعات

• 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