الوصف
استخدِم واجهة برمجة التطبيقات system.display للاستعلام عن البيانات الوصفية المعروضة.
الأذونات
system.displayالأنواع
ActiveState
تعداد لتحديد ما إذا كان النظام قد رصد الشاشة واستخدمها. يُعدّ العرض "غير نشط" إذا لم يرصده النظام (ربما تم فصله أو اعتباره مفصولاً بسبب وضع السكون وما إلى ذلك). يتم استخدام هذه الحالة للحفاظ على شاشة العرض الحالية عند فصل جميع شاشات العرض، على سبيل المثال.
Enum
"active"
"inactive"
Bounds
الخصائص
-
الطول
الرقم
تمثّل هذه السمة ارتفاع الشاشة بوحدة البكسل.
-
لليسار
الرقم
تمثّل الإحداثي السيني للزاوية العلوية اليسرى.
-
العلوية
الرقم
المنحنى الصادي للزاوية العلوية اليسرى
-
العرض
الرقم
تمثّل هذه السمة عرض الشاشة بالبكسل.
DisplayLayout
الخصائص
-
id
سلسلة
المعرّف الفريد للشاشة.
-
offset
الرقم
إزاحة الشاشة على طول الحافة المتصلة يشير الرقم 0 إلى أنّ الزوايا العلوية أو اليمنى محاذية.
-
parentId
سلسلة
المعرّف الفريد للشاشة الرئيسية يكون هذا الحقل فارغًا إذا كان هذا هو العنصر الجذر.
-
الموضع
تمثّل هذه السمة موضع التصميم بالنسبة إلى العنصر الرئيسي. سيتم تجاهل هذا الإعداد بالنسبة إلى الجذر.
DisplayMode
الخصائص
-
deviceScaleFactor
الرقم
عامل قياس الجهاز في وضع العرض
-
الطول
الرقم
ارتفاع وضع العرض بوحدات البكسل المستقلة عن الجهاز (المرئية للمستخدم).
-
heightInNativePixels
الرقم
ارتفاع وضع العرض بوحدات البكسل الأصلية
-
isInterlaced
boolean اختياري
Chrome 74 والإصدارات الأحدثتكون القيمة "صحيح" إذا كان هذا الوضع متداخلاً، و"خطأ" إذا لم يتم توفيرها.
-
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الإصدار 117 من Chrome والإصدارات الأحدث
تكون الشاشة نشطة إذا رصدها النظام واستخدمها.
-
availableDisplayZoomFactors
number[]
الإصدار 67 من Chrome والإصدارات الأحدثقائمة بقيم عامل التكبير/التصغير التي يمكن ضبطها للعرض
-
الحدود
تمثّل هذه السمة الحدود المنطقية للشاشة.
-
displayZoomFactor
الرقم
Chrome 65 والإصدارات الأحدثالنسبة بين مستوى التكبير الحالي ومستوى التكبير التلقائي للشاشة على سبيل المثال، القيمة 1 تعادل مستوى تكبير بنسبة% 100، والقيمة 1.5 تعادل مستوى تكبير بنسبة% 150.
-
dpiX
الرقم
عدد وحدات البكسل في البوصة الواحدة على طول المحور "س"
-
dpiY
الرقم
عدد وحدات البكسل لكل بوصة على طول المحور y
-
edid
Edid اختياري
الإصدار 67 من Chrome والإصدارات الأحدثملاحظة: لا تتوفّر هذه الميزة إلا لتطبيقات ChromeOS Kiosk وواجهة مستخدم الويب.
-
hasTouchSupport
قيمة منطقية
الإصدار 57 من Chrome أو إصدار أحدثتعرض القيمة "صحيح" إذا كانت هذه الشاشة مرتبطة بجهاز إدخال يعمل باللمس.
-
id
سلسلة
المعرّف الفريد للشاشة.
-
isEnabled
قيمة منطقية
يتم عرض القيمة "صحيح" إذا كانت شاشة العرض هذه مفعّلة.
-
isPrimary
قيمة منطقية
صحيح إذا كانت هذه هي الشاشة الأساسية.
-
isUnified
قيمة منطقية
Chrome 59+صحيح لجميع الشاشات عندما يكون وضع الكمبيوتر المكتبي الموحّد مفعّلاً. يُرجى الاطّلاع على مستندات
enableUnifiedDesktop. -
mirroringDestinationIds
string[]
الإصدار 64 من Chrome أو إصدار أحدثنظام التشغيل 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 من الحدّ الأيمن.
-
العلوية
الرقم
المسافة بين المحور y والحدّ العلوي
LayoutPosition
موضع التصميم، أي حافة العنصر الرئيسي التي يتم ربط العرض بها
Enum
"top"
"right"
"bottom"
"left"
MirrorMode
وضع المرآة، أي الطرق المختلفة لعكس الشاشة على شاشات أخرى
Enum
"off"
تحدّد هذه السمة الوضع التلقائي (الوضع الموسّع أو وضع الكمبيوتر المكتبي الموحّد).
"عادي"
يحدّد هذا الخيار أنّه سيتم عرض المصدر التلقائي بشكل مطابق على جميع الشاشات الأخرى.
"مختلط"
تحدّد هذه السمة أنّه سيتم عرض شاشة المصدر المحدّدة على شاشات الوجهة المتوفّرة. سيتم توسيع جميع الشاشات المتصلة الأخرى.
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.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 هو طلب تراكمي مع الطلبات السابقة منذ "البدء".
المعلمات
-
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