الوصف
استخدِم واجهة برمجة التطبيقات system.display
للاستعلام عن البيانات الوصفية المعروضة.
الأذونات
system.display
الأنواع
ActiveState
تعداد لتحديد ما إذا كان النظام قد رصد الشاشة واستخدمها. يُعدّ العرض "غير نشط" إذا لم يرصده النظام (ربما تم فصله أو اعتباره مفصولاً بسبب وضع السكون وما إلى ذلك). تُستخدَم هذه الحالة للحفاظ على شاشة العرض الحالية عند فصل جميع شاشات العرض، على سبيل المثال.
Enum
"active"
"inactive"
Bounds
الخصائص
-
الطول
الرقم
تمثّل هذه السمة ارتفاع الشاشة بوحدة البكسل.
-
لليسار
الرقم
تمثّل الإحداثي x للزاوية العلوية اليسرى.
-
العلوية
الرقم
المنحنى الصادي للزاوية العلوية اليسرى
-
العرض
الرقم
تمثّل هذه السمة عرض الشاشة بالبكسل.
DisplayLayout
الخصائص
-
id
سلسلة
المعرّف الفريد للشاشة.
-
offset
الرقم
إزاحة الشاشة على طول الحافة المتصلة يشير الرقم 0 إلى أنّ الزوايا العلوية أو اليمنى محاذية.
-
parentId
سلسلة
المعرّف الفريد للشاشة الرئيسية. يكون هذا الحقل فارغًا إذا كان هذا هو الجذر.
-
الموضع
تمثّل هذه السمة موضع التصميم الخاص بهذا العرض بالنسبة إلى العنصر الرئيسي. سيتم تجاهل هذا الخيار بالنسبة إلى الجذر.
DisplayMode
الخصائص
-
deviceScaleFactor
الرقم
عامل قياس الجهاز في وضع العرض
-
الطول
الرقم
ارتفاع وضع العرض بوحدات البكسل المستقلة عن الجهاز (المرئية للمستخدم).
-
heightInNativePixels
الرقم
ارتفاع وضع العرض بوحدات البكسل الأصلية
-
isInterlaced
boolean اختياري
الإصدار 74 من Chrome والإصدارات الأحدثتُعرض القيمة "صحيح" إذا كان هذا الوضع متداخلاً، و"خطأ" إذا لم يتم توفيره.
-
isNative
قيمة منطقية
تكون القيمة صحيحة إذا كان الوضع هو الوضع الأصلي لشاشة العرض.
-
isSelected
قيمة منطقية
قيمة True إذا كان وضع العرض محدّدًا حاليًا
-
refreshRate
الرقم
Chrome 67 والإصدارات الأحدثمعدّل إعادة تحميل وضع العرض بالهرتز.
-
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الإصدار 117 من Chrome والإصدارات الأحدث
نشط إذا رصد النظام الشاشة واستخدمها.
-
availableDisplayZoomFactors
number[]
Chrome 67 والإصدارات الأحدثقائمة بقيم عامل التكبير/التصغير التي يمكن ضبطها للعرض
-
bounds
تمثّل هذه السمة الحدود المنطقية للشاشة.
-
displayZoomFactor
الرقم
Chrome 65 والإصدارات الأحدثالنسبة بين مستوى التكبير الحالي ومستوى التكبير التلقائي للشاشة على سبيل المثال، القيمة 1 تعادل مستوى تكبير بنسبة% 100، والقيمة 1.5 تعادل مستوى تكبير بنسبة% 150.
-
dpiX
الرقم
عدد وحدات البكسل في البوصة الواحدة على طول المحور "س"
-
dpiY
الرقم
عدد وحدات البكسل لكل بوصة على طول المحور y
-
edid
Edid اختياري
Chrome 67 والإصدارات الأحدثملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات ChromeOS Kiosk وواجهة مستخدم الويب.
-
hasTouchSupport
قيمة منطقية
Chrome 57 والإصدارات الأحدثتعرض القيمة "صحيح" إذا كانت هذه الشاشة تتضمّن جهاز إدخال يعمل باللمس.
-
id
سلسلة
المعرّف الفريد للشاشة.
-
isEnabled
قيمة منطقية
يتم عرض القيمة "صحيح" إذا كانت شاشة العرض هذه مفعَّلة.
-
isPrimary
قيمة منطقية
صحيح إذا كانت هذه هي الشاشة الأساسية.
-
isUnified
قيمة منطقية
Chrome 59 والإصدارات الأحدثصحيح لجميع الشاشات عند تفعيل وضع الكمبيوتر المكتبي الموحّد يُرجى الاطّلاع على مستندات
enableUnifiedDesktop
. -
mirroringDestinationIds
string[]
Chrome 64 والإصدارات الأحدثنظام التشغيل ChromeOS فقط معرّفات الشاشات التي يتم عرض الشاشة المصدر عليها تكون فارغة إذا لم يتم عرض أي شاشات بشكل متطابق. سيتم ضبط هذه السمة على القيمة نفسها لجميع العروض. يجب ألا يتضمّن ذلك
mirroringSourceId
. -
mirroringSourceId
سلسلة
نظام التشغيل ChromeOS فقط معرّف الشاشة التي يتم عرض المحتوى عليها بشكل مطابق في حال تفعيل ميزة عرض المحتوى بشكل مطابق، وإلا يكون فارغًا. سيتم ضبط هذا الخيار لجميع الشاشات (بما في ذلك الشاشة التي يتم عرض المحتوى عليها).
-
الأوضاعChrome 52 والإصدارات الأحدث
قائمة أوضاع العرض المتاحة سيكون للوضع الحالي isSelected=true. لا تتوفّر هذه الميزة إلا على ChromeOS. سيتم ضبطها على مصفوفة فارغة على المنصات الأخرى.
-
الاسم
سلسلة
الاسم السهل الاستخدام (مثل "شاشة LCD من HP").
-
الخروج عن إطار الشاشة
تمثّل هذه السمة المسافات البادئة للشاشة ضمن حدودها. تتوفّر هذه الميزة حاليًا على ChromeOS فقط. سيتم ضبطها على هوامش داخلية فارغة على المنصات الأخرى.
-
التدوير
الرقم
تمثّل هذه السمة مقدار تدوير الشاشة في اتجاه عقارب الساعة بالدرجات مقارنةً بالوضع العمودي. تتوفّر هذه الميزة حاليًا على ChromeOS فقط. سيتم ضبطها على 0 على المنصات الأخرى. سيتم تفسير القيمة -1 على أنّها تدوير تلقائي عندما يكون الجهاز في حالة جهاز لوحي.
-
workArea
مساحة العمل القابلة للاستخدام على الشاشة ضمن حدودها لا تشمل مساحة العمل المساحات المحجوزة لنظام التشغيل على الشاشة، مثل شريط التطبيقات والمشغّل.
Edid
الخصائص
-
manufacturerId
سلسلة
رمز الشركة المصنّعة المكوّن من 3 أحرف راجِع القسم 3.4.1، الصفحة 21. مطلوب في الإصدار 1.4
-
productId
سلسلة
رمز من بايتَين تحدّده الشركة المصنّعة، الفقرة 3.4.2، الصفحة 21 مطلوب في الإصدار 1.4
-
yearOfManufacture
الرقم
سنة التصنيع، الفقرة 3.4.4، الصفحة 22 مطلوب في الإصدار 1.4
GetInfoFlags
الخصائص
-
singleUnified
boolean اختياري
في حال ضبطها على "صحيح"، سيتم عرض
DisplayUnitInfo
واحد فقط من خلالgetInfo
عند استخدام وضع سطح المكتب الموحّد (راجِعenableUnifiedDesktop
). القيمة التلقائية هي "خطأ".
Insets
الخصائص
-
السفلية
الرقم
المسافة على المحور y من الحدّ الأدنى.
-
لليسار
الرقم
المسافة على المحور س من الحد الأيسر
-
لليمين
الرقم
تمثّل هذه السمة المسافة على المحور x من الحدّ الأيمن.
-
العلوية
الرقم
المسافة على المحور ص من الحد العلوي
LayoutPosition
موضع التصميم، أي حافة العنصر الرئيسي التي يتم إرفاق العرض بها
Enum
"top"
"right"
"bottom"
"left"
MirrorMode
وضع المرآة، أي الطرق المختلفة لعكس الشاشة على شاشات أخرى
Enum
"off"
تحدّد الوضع التلقائي (الوضع الموسّع أو وضع الكمبيوتر المكتبي الموحّد).
"عادي"
يحدّد هذا الخيار أنّه سيتم عرض المصدر التلقائي على جميع الشاشات الأخرى.
"mixed"
تحدّد هذه القيمة أنّه سيتم عرض مصدر الشاشة المحدّد على شاشات الوجهة المتوفّرة. سيتم توسيع جميع الشاشات المتصلة الأخرى.
MirrorModeInfo
الخصائص
-
mirroringDestinationIds
string[] اختياري
تعرض هذه السمة أرقام تعريف شاشات العرض التي يمكن عرض المحتوى عليها. هذا صالح فقط للقيمة "مختلط".
-
mirroringSourceId
سلسلة اختيارية
معرّف شاشة العرض المصدر للمرآة. هذا صالح فقط للقيمة "مختلط".
-
الوضع
وضع عكس الصورة الذي يجب ضبطه
Point
الخصائص
-
x
الرقم
الإحداثي x للنقطة.
-
y
الرقم
الإحداثي y للنقطة.
TouchCalibrationPair
الخصائص
-
displayPoint
إحداثيات نقطة العرض
-
touchPoint
إحداثيات نقطة اللمس المقابلة لنقطة العرض
TouchCalibrationPairQuad
الخصائص
-
pair1
يجب توفير أول زوج من نقاط اللمس والعرض لمعايرة اللمس.
-
pair2
مطلوب زوج ثانٍ من نقاط اللمس والعرض لمعايرة اللمس.
-
pair3
يجب توفير نقطة لمس وعرض ثالثة لمعايرة اللمس.
-
pair4
مطلوب زوج رابع من نقاط اللمس والعرض لمعايرة اللمس.
الطُرق
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
): void
تعيد هذه السياسة ضبط معايرة اللمس لشاشة العرض إلى حالتها التلقائية من خلال محو أي بيانات معايرة لمس مرتبطة بشاشة العرض.
المعلمات
-
id
سلسلة
المعرّف الفريد للشاشة
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
): void
تضبط هذه السمة أزواج معايرة اللمس لشاشة العرض. سيتم استخدام هذه pairs
لمعايرة شاشة اللمس للعرض باستخدام id
التي يتم استدعاؤها في startCustomTouchCalibration(). يجب دائمًا استدعاء startCustomTouchCalibration
قبل استدعاء هذه الطريقة. سيؤدي ذلك إلى ظهور خطأ إذا كانت عملية معايرة أخرى للمس قيد التقدم.
المعلمات
-
أزواج
أزواج النقاط المستخدَمة لمعايرة الشاشة
-
bounds
حدود الشاشة عند إجراء معايرة اللمس يتم تجاهل قيم
bounds.left
وbounds.top
.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
): void
تفعيل ميزة "سطح المكتب الموحَّد" أو إيقافها في حال تفعيل وضع سطح المكتب أثناء تفعيل ميزة "عرض المحتوى على شاشة خارجية"، لن يتغير وضع سطح المكتب إلى أن يتم إيقاف ميزة "عرض المحتوى على شاشة خارجية". وفي حال عدم تفعيل ميزة "عرض المحتوى على شاشة خارجية"، سيتم التبديل إلى وضع سطح المكتب الموحّد على الفور. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات ChromeOS Kiosk وواجهة مستخدم الويب.
المعلمات
-
مفعّلة
قيمة منطقية
تكون القيمة "صحيح" إذا كان من المفترض تفعيل سطح المكتب الموحّد.
getDisplayLayout()
chrome.system.display.getDisplayLayout(): Promise<DisplayLayout[]>
يطلب معلومات التنسيق لجميع الشاشات. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات ChromeOS Kiosk وواجهة مستخدم الويب.
المرتجعات
-
Promise<DisplayLayout[]>
الإصدار 91 من Chrome والإصدارات الأحدث
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
): Promise<DisplayUnitInfo[]>
يطلب هذا الإذن الحصول على معلومات عن جميع أجهزة العرض المتصلة.
المعلمات
-
أعلام
GetInfoFlags اختيارية
Chrome 59 والإصدارات الأحدثخيارات تؤثّر في طريقة عرض المعلومات.
المرتجعات
-
Promise<DisplayUnitInfo[]>
الإصدار 91 من Chrome والإصدارات الأحدث
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
): void
تعدّل هذه السمة إعدادات التجاوز الحالية لشاشة العرض. عادةً ما يؤدي ذلك إلى تحريك العرض على طول أحد المحاور (مثلاً، يجب أن تكون قيمة اليمين واليسار هي نفسها) أو تغيير حجمه على طول أحد المحاور (مثلاً، يجب أن تكون قيمة الأعلى والأسفل عكس بعضهما). كل طلب من Adjust هو طلب تراكمي مع الطلبات السابقة منذ Start.
المعلمات
-
id
سلسلة
المعرّف الفريد للشاشة
-
دلتا
مقدار تغيير مسافات الإزاحة في الحواف الخارجية.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
): void
أكمِل تعديلات المسح الزائد لشاشة العرض من خلال حفظ القيم الحالية وإخفاء الطبقة المتراكبة.
المعلمات
-
id
سلسلة
المعرّف الفريد للشاشة
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
): void
تعيد ضبط هوامش overscan لشاشة العرض إلى آخر قيمة تم حفظها (أي قبل استدعاء Start).
المعلمات
-
id
سلسلة
المعرّف الفريد للشاشة
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
): void
يبدأ معايرة المسح الزائد لشاشة العرض. سيؤدي ذلك إلى عرض طبقة على الشاشة تشير إلى الهوامش الداخلية الحالية لعملية المسح الضوئي الزائد. إذا كانت عملية معايرة التجاوز الحدودي لشاشة العرض id
قيد التقدّم، سيؤدي ذلك إلى إعادة ضبط المعايرة.
المعلمات
-
id
سلسلة
المعرّف الفريد للشاشة
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
): Promise<void>
ضبط التنسيق لجميع شاشات العرض سيتم استخدام التنسيق التلقائي مع أي شاشة عرض غير مضمّنة. إذا كان التنسيق سيتداخل أو سيكون غير صالح بأي شكل آخر، سيتم تعديله إلى تنسيق صالح. بعد تحديد التنسيق، سيتم بدء حدث onDisplayChanged. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات ChromeOS Kiosk وواجهة مستخدم الويب.
المعلمات
-
التنسيقات
معلومات التنسيق، وهي مطلوبة لجميع الشاشات باستثناء الشاشة الأساسية
المرتجعات
-
Promise<void>
الإصدار 91 من Chrome والإصدارات الأحدث
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
): Promise<void>
تعدّل هذه الطريقة خصائص العرض المحدّدة بواسطة id
، وفقًا للمعلومات المقدَّمة في info
. في حال حدوث خطأ، سيتم ضبط runtime.lastError
. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات ChromeOS Kiosk وواجهة مستخدم الويب.
المعلمات
-
id
سلسلة
المعرّف الفريد للشاشة
-
معلومات
المعلومات حول خصائص العرض التي يجب تغييرها لن يتم تغيير إحدى السمات إلا إذا تم تحديد قيمة جديدة لها في
info
.
المرتجعات
-
Promise<void>
الإصدار 91 من Chrome والإصدارات الأحدث
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
): Promise<void>
يضبط وضع العرض على وضع المرآة المحدّد. تعمل كل مكالمة على إعادة ضبط الحالة من المكالمات السابقة. سيؤدي استدعاء setDisplayProperties() إلى حدوث خطأ في شاشات وجهة العرض المتطابق. ملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات ChromeOS Kiosk وواجهة مستخدم الويب.
المعلمات
-
معلومات
معلومات وضع المرآة التي يجب تطبيقها على وضع العرض
المرتجعات
-
Promise<void>
الإصدار 91 من Chrome والإصدارات الأحدث
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
): Promise<boolean>
تعرِض هذه السمة تجربة المستخدم الأصلية لمعايرة اللمس على الشاشة التي تحمل id
كمعرّف للشاشة. سيؤدي ذلك إلى عرض تراكب على الشاشة يتضمّن التعليمات المطلوبة حول كيفية المتابعة. سيتم استدعاء دالة الرجوع في حال نجاح المعايرة فقط. إذا فشلت عملية المعايرة، سيظهر خطأ.
المعلمات
-
id
سلسلة
المعرّف الفريد للشاشة
المرتجعات
-
Promise<boolean>
الإصدار 91 من Chrome والإصدارات الأحدث
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
): void
يبدأ عملية معايرة اللمس المخصّصة لشاشة العرض. يجب استدعاء هذه الطريقة عند استخدام تجربة مستخدم مخصّصة لجمع بيانات المعايرة. سيؤدي ذلك إلى ظهور خطأ إذا كانت عملية معايرة أخرى للمس قيد التقدم.
المعلمات
-
id
سلسلة
المعرّف الفريد للشاشة
الفعاليات
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
يتم تنشيط هذا الحدث عند حدوث أي تغيير في إعدادات العرض.
المعلمات
-
callback
دالة
تظهر المَعلمة
callback
على النحو التالي:() => void