الوصف
استخدِم واجهة برمجة تطبيقات system.display
لطلب البحث عن البيانات الوصفية المعروضة.
الأذونات
system.display
الأنواع
ActiveState
تعداد لمعرفة ما إذا تم اكتشاف الشاشة واستخدامها من قِبل النظام تُعتبر الشاشة "غير نشطة" إذا لم يتعرّف عليها النظام (ربما تكون غير متصلة أو تُعتبر غير متصلة بسبب وضع السكون، إلخ). يتم استخدام هذه الحالة للاحتفاظ بالشاشة الحالية عند فصل جميع شاشات العرض، مثلاً.
التعداد
Bounds
أماكن إقامة
-
الطول
الرقم
ارتفاع الشاشة بالبكسل.
-
لليسار
الرقم
الإحداثي x في الزاوية العلوية اليسرى.
-
النصف العلوي
الرقم
الإحداثي الصادي في الزاوية العلوية اليسرى.
-
العرض
الرقم
عرض الشاشة بالبكسل
DisplayLayout
أماكن إقامة
-
id
سلسلة
المعرّف الفريد للشاشة
-
فرق التوقيت
الرقم
إزاحة الشاشة على طول الحافة المتصلة. يشير الرقم 0 إلى أنّه تمت محاذاة الزوايا العلوية أو اليسرى.
-
parentId
سلسلة
المعرّف الفريد للعرض الرئيسي. يكون هذا الحقل فارغًا إذا كان هذا هو الجذر.
-
الموضع
تمثّل هذه السمة موضع تصميم هذه الشاشة بالنسبة إلى الشاشة الرئيسية. وسيتم تجاهل ذلك بالنسبة إلى الجذر.
DisplayMode
أماكن إقامة
-
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
أماكن إقامة
-
activeStateChrome 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 فقط. معرّف الشاشة التي يتم مزامنتها على الجهاز وفي حال تفعيل ميزة "المزامنة على الجهاز وفي السحابة الإلكترونية" أو تركها فارغة سيتم ضبط هذا الإعداد لجميع الشاشات (بما في ذلك عكس الشاشة).
-
modesChrome 52 والإصدارات الأحدث
قائمة أوضاع العرض المتاحة وسيحدّد الوضع الحالي isselect=true. تتوفّر هذه الميزة فقط على نظام التشغيل Chrome. سيتم ضبطها على مصفوفة فارغة على الأنظمة الأساسية الأخرى.
-
اسم
سلسلة
اسم سهل الاستخدام (على سبيل المثال "شاشة HP LCD")
-
الخروج عن إطار الشاشة
المساحات الداخلية للعرض ضمن حدود شاشتها. يتم عرضه حاليًا على نظام التشغيل ChromeOS فقط. سيتم تعيينها على مساحات داخلية فارغة على الأنظمة الأساسية الأخرى.
-
دوران
الرقم
دوران الشاشة في اتجاه عقارب الساعة بالدرجات بالنسبة إلى الموضع الرأسي يتم عرضه حاليًا على نظام التشغيل ChromeOS فقط. سيتم ضبطها على 0 في المنصات الأخرى. سيتم اعتبار القيمة -1 على أنّها دوران تلقائي عندما يكون الجهاز في حالة الجهاز اللوحي الفعلية.
-
workArea
مساحة العمل القابلة للاستخدام على الشاشة ضمن حدود الشاشة تستبعد مساحة العمل مناطق العرض المحجوزة لنظام التشغيل، مثل شريط التطبيقات ومشغّل التطبيقات.
Edid
أماكن إقامة
-
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
أماكن إقامة
-
singleUnified
منطقية اختيارية
في حال ضبطها على "صحيح"، سيتم عرض
DisplayUnitInfo
واحدة فقط من خلالgetInfo
عندما تكون في وضع سطح المكتب الموحّد (راجِعenableUnifiedDesktop
). ويتم ضبط الإعدادات التلقائية على "خطأ".
Insets
أماكن إقامة
-
النصف السفلي
الرقم
مسافة المحور y من الحد السفلي.
-
لليسار
الرقم
مسافة المحور x من الحد الأيسر.
-
لليمين
الرقم
مسافة المحور x من الحد الأيمن.
-
النصف العلوي
الرقم
مسافة المحور y من الحد العلوي.
LayoutPosition
موضع التصميم، أي حافة العنصر الرئيسي التي يتم إرفاق الشاشة بها
التعداد
MirrorMode
وضع المرآة، أي الطرق المختلفة لكيفية عكس الشاشة على شاشات العرض الأخرى.
التعداد
"إيقاف"
يحدد هذا الإعداد الوضع التلقائي (كمبيوتر مكتبي موسّع أو موحَّد).
"normal"
يحدد إجراء نسخ مطابق لعرض المصدر التلقائي إلى جميع الشاشات الأخرى.
"مختلط"
يحدد هذا الخيار أنّه سيتم نسخ شاشة المصدر المحددة نسخًا مطابقًا إلى شاشة عرض الوجهة المقدّمة. وسيتم تمديد جميع الشاشات المتصلة الأخرى.
MirrorModeInfo
أماكن إقامة
-
mirroringDestinationIds
سلسلة[] اختيارية
يتم عرض أرقام تعريف وجهة النسخ المطابق. ويصلح هذا الخيار فقط مع كلمة "مختلطة".
-
mirroringSourceId
سلسلة اختيارية
رقم تعريف عرض مصدر النسخ المطابق. ويصلح هذا الخيار فقط مع كلمة "مختلطة".
-
الوضع
وضع المرآة التي يجب ضبطها.
Point
أماكن إقامة
-
x
الرقم
تمثّل هذه السمة الإحداثي x للنقطة.
-
y
الرقم
تمثّل هذه السمة الإحداثي y للنقطة.
TouchCalibrationPair
أماكن إقامة
-
displayPoint
تمثّل هذه السمة إحداثيات نقطة العرض.
-
touchPoint
تمثّل هذه السمة إحداثيات نقطة اللمس المقابلة لنقطة العرض.
TouchCalibrationPairQuad
أماكن إقامة
-
pair1
يجب توصيل أول زوج من اللمس ونقطة العرض لإجراء معايرة اللمس.
-
pair2
يجب استخدام الزوج الثاني من اللمس ونقطة العرض لإجراء معايرة اللمس.
-
pair3
يجب استخدام الزوج الثالث من نقطة اللمس ونقطة العرض لإجراء معايرة اللمس.
-
pair4
يجب استخدام الزوج الرابع من نقاط اللمس ونقطة العرض لإجراء معايرة اللمس.
الطُرق
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
تتيح هذه الميزة إعادة ضبط معايرة اللمس على الشاشة وإعادتها إلى حالتها التلقائية من خلال محو أي بيانات معايرة اللمس مرتبطة بالشاشة.
المَعلمات
-
id
سلسلة
تمثّل هذه السمة المعرّف الفريد للعرض.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
لضبط أزواج معايرة اللمس لشاشة العرض سيتم استخدام pairs
لمعايرة الشاشة التي تعمل باللمس للعرض باستخدام id
التي تُسمى startCustomTouchCalibration(). ويجب دائمًا استدعاء startCustomTouchCalibration
قبل استدعاء هذه الطريقة. إذا كانت معايرة اللمس الأخرى قيد التقدّم، سيؤدي ذلك إلى ظهور خطأ.
المَعلمات
-
أزواج
أزواج النقاط المستخدمة لمعايرة الشاشة.
-
حدود
حدود الشاشة أثناء إجراء المعايرة باللمس يتم تجاهل قيم
bounds.left
وbounds.top
.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
)
لتفعيل/إيقاف ميزة سطح المكتب الموحّد. في حال تفعيل ميزة "المزامنة على الجهاز وفي السحابة الإلكترونية" أثناء تفعيل ميزة "المزامنة على الجهاز وفي السحابة الإلكترونية"، لن يتغيّر وضع سطح المكتب إلى أن يتم إيقاف ميزة "المزامنة على الجهاز وفي السحابة الإلكترونية"، وإلا سيتم تبديل وضع سطح المكتب إلى الوضع "موحد" على الفور. ملاحظة: لا يتوفر هذا إلا لتطبيقات Kiosk على نظام التشغيل Chrome وواجهة مستخدم الويب.
المَعلمات
-
مفعّلة
boolean
True في حال كان يجب تفعيل سطح المكتب الموحَّد.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
)
لطلب معلومات التنسيق لجميع شاشات العرض. ملاحظة: لا يتوفر هذا إلا لتطبيقات Kiosk على نظام التشغيل Chrome وواجهة مستخدم الويب.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(layouts: DisplayLayout[]) => void
-
التنسيقات
-
المرتجعات
-
Promise<DisplayLayout[]>
Chrome 91 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
يتم طلب الحصول على المعلومات من جميع أجهزة العرض المرفقة.
المَعلمات
-
أعلام
GetInfoFlags اختيارية
الإصدار 59 من Chrome والإصدارات الأحدثخيارات تؤثّر في كيفية عرض المعلومات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
المرتجعات
-
Promise<DisplayUnitInfo[]>
Chrome 91 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
لضبط الأجزاء الداخلية الحالية الزائدة لعرض الشاشة. عادةً ما يؤدي ذلك إلى تحريك الشاشة على طول أحد المحورين (على سبيل المثال، القيم ذاتها من اليسار إلى اليمين) أو تغيير حجمه على طول محور (على سبيل المثال، القيم المعاكسة للجزء العلوي + الأيمن). تكون كل مكالمة في ميزة "تعديل" تراكمية مع المكالمات السابقة منذ البدء.
المَعلمات
-
id
سلسلة
تمثّل هذه السمة المعرّف الفريد للعرض.
-
دلتا
مقدار تغيير الإضافات الزائدة.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
أكمل التعديلات الزائدة في العرض عن طريق حفظ القيم الحالية وإخفاء التراكب.
المَعلمات
-
id
سلسلة
تمثّل هذه السمة المعرّف الفريد للعرض.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
إعادة ضبط الأجزاء الداخلية الزائدة لعرض الشاشة على آخر قيمة محفوظة (أي قبل طلب البدء).
المَعلمات
-
id
سلسلة
تمثّل هذه السمة المعرّف الفريد للعرض.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
)
لبدء معايرة الخروج عن إطار الشاشة سيؤدي هذا إلى عرض تراكب على الشاشة يشير إلى الأجزاء الداخلية الحالية الزائدة عن الحد. إذا كانت معايرة الخروج عن إطار الشاشة صالحة لعرض id
، سيؤدي ذلك إلى إعادة ضبط المعايرة.
المَعلمات
-
id
سلسلة
تمثّل هذه السمة المعرّف الفريد للعرض.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
)
ضبط التنسيق لجميع شاشات العرض. ستستخدم أي شاشة غير مضمّنة التنسيق التلقائي. إذا كان التنسيق متداخلاً أو غير صالح، سيتم تعديله إلى تنسيق صالح. بعد حلّ التنسيق، سيتم بدء حدث onDisplayChanged. ملاحظة: لا يتوفر هذا إلا لتطبيقات Kiosk على نظام التشغيل Chrome وواجهة مستخدم الويب.
المَعلمات
-
التنسيقات
معلومات التنسيق المطلوبة لجميع شاشات العرض باستثناء شاشة العرض الأساسية.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
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
سلسلة
تمثّل هذه السمة المعرّف الفريد للعرض.
-
معلومات
المعلومات حول خصائص العرض التي يجب تغييرها. لن يتم تغيير الخاصية إلا إذا تم تحديد قيمة جديدة لها في
info
. -
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
لضبط وضع العرض على وضع المرآة المحدّدة. تعيد كل مكالمة ضبط الحالة من المكالمات السابقة. سيتعذر استدعاء setDisplayProperties() عند عرض وجهة النسخ المطابق. ملاحظة: لا يتوفر هذا إلا لتطبيقات Kiosk على نظام التشغيل Chrome وواجهة مستخدم الويب.
المَعلمات
-
معلومات
معلومات وضع النسخ المطابق التي يجب تطبيقها على وضع العرض.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
يعرض هذا الخيار تجربة المستخدم معايرة اللمس الأصلية على الشاشة باستخدام id
كمعرّف عرض. سيؤدي ذلك إلى عرض زرّ مركّب على الشاشة يتضمّن التعليمات المطلوبة حول كيفية المتابعة. سيتم استدعاء معاودة الاتصال في حال نجاح المعايرة فقط. إذا تعذّرت المعايرة، سيؤدي ذلك إلى ظهور خطأ.
المَعلمات
-
id
سلسلة
تمثّل هذه السمة المعرّف الفريد للعرض.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(success: boolean) => void
-
نجاح
boolean
-
المرتجعات
-
Promise<boolean>
Chrome 91 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
يؤدي هذا الاختصار إلى بدء معايرة مخصّصة تعمل باللمس على الشاشة. يجب طلب ذلك عند استخدام تجربة مستخدم مخصصة لجمع بيانات المعايرة. إذا كانت معايرة اللمس الأخرى قيد التقدّم، سيؤدي ذلك إلى ظهور خطأ.
المَعلمات
-
id
سلسلة
تمثّل هذه السمة المعرّف الفريد للعرض.
فعاليات
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
يتم تنشيطها عند حدوث أي تغيير في إعدادات العرض.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:() => void