תאריך הרענון: 2026-09-25 robots: noindex
תיאור
אפשר להשתמש ב-system.display API כדי לשלוח שאילתה לגבי מטא-נתונים מוצגים.
הרשאות
system.displayסוגים
ActiveState
ערך enum שקובע אם המערכת מזהה את התצוגה ומשתמשת בה. המסך נחשב 'לא פעיל' אם המערכת לא מזהה אותו (יכול להיות שהוא מנותק, או שהוא נחשב מנותק בגלל מצב שינה וכו'). המצב הזה משמש לשמירת התצוגה הקיימת כשכל המסכים מנותקים, למשל.
ספירה
'פעיל'
'לא פעיל'
Bounds
מאפיינים
-
גובה
number
גובה המסך בפיקסלים.
-
שמאלה
number
הקואורדינטה x של הפינה השמאלית העליונה.
-
עליון
number
הקואורדינטה y של הפינה השמאלית העליונה.
-
רוחב
number
רוחב המסך בפיקסלים.
DisplayLayout
מאפיינים
-
id [מזהה]
מחרוזת
המזהה הייחודי של התצוגה.
-
לקזז
number
ההיסט של המסך לאורך הקצה המחובר. 0 מציין שהפינות העליונות או השמאליות ביותר מיושרות.
-
parentId
מחרוזת
המזהה הייחודי של התצוגה הראשית. אם זה השורש, השדה ריק.
-
position
מיקום הפריסה של התצוגה הזו ביחס לאלמנט האב. המערכת תתעלם מההגדרה הזו ברמת הבסיס.
DisplayMode
מאפיינים
-
deviceScaleFactor
number
הגורם לקביעת קנה מידה של המכשיר במצב התצוגה.
-
גובה
number
הגובה של מצב התצוגה בפיקסלים שאינם תלויים במכשיר (גלויים למשתמש).
-
heightInNativePixels
number
גובה מצב התצוגה בפיקסלים מקוריים.
-
isInterlaced
boolean אופציונלי
Chrome 74 ואילךהערך True אם המצב הזה הוא interlaced, אחרת הערך הוא False.
-
isNative
בוליאני
הערך יהיה True אם המצב הוא המצב המקורי של המסך.
-
isSelected
בוליאני
הערך הוא True אם מצב התצוגה נבחר כרגע.
-
refreshRate
number
Chrome 67 ואילךקצב הרענון של מצב התצוגה בהרץ.
-
uiScale
מספר אופציונלי
הוצא משימוש מאז Chrome 70שימוש ב-
displayZoomFactorהגורם לקביעת קנה מידה של ממשק המשתמש במצב התצוגה.
-
רוחב
number
רוחב מצב התצוגה בפיקסלים בלתי תלויים במכשיר (גלויים למשתמש).
-
widthInNativePixels
number
הרוחב של מצב התצוגה בפיקסלים מקוריים.
DisplayProperties
מאפיינים
-
boundsOriginX
מספר אופציונלי
אם המאפיין מוגדר, הוא מעדכן את מקור הגבולות הלוגיים של התצוגה לאורך ציר ה-x. הבקשה נשלחה ב-
boundsOriginY. אם הפרמטר לא מוגדר וboundsOriginYמוגדר, ברירת המחדל היא הערך הנוכחי. שימו לב: כשמעדכנים את מקור התצוגה, מוחלים אילוצים מסוימים, ולכן מקור הגבולות הסופי עשוי להיות שונה מזה שהוגדר. אפשר לאחזר את הגבולות הסופיים באמצעותgetInfo. אי אפשר לשנות את נקודת המוצא של הגבולות במסך הראשי. -
boundsOriginY
מספר אופציונלי
אם המאפיין מוגדר, הוא מעדכן את מקור הגבולות הלוגיים של התצוגה לאורך ציר ה-y. מידע נוסף על הפרמטר
boundsOriginX -
displayMode
DisplayMode אופציונלי
Chrome 52 ואילךאם ההגדרה הזו מוגדרת, מצב התצוגה מתעדכן למצב שמתאים לערך הזה. אם פרמטרים אחרים לא תקינים, ההגדרה הזו לא תחול. אם מצב התצוגה לא תקין, הוא לא יוחל ותוגדר שגיאה, אבל מאפיינים אחרים עדיין יוחלו.
-
displayZoomFactor
מספר אופציונלי
Chrome 65 ואילךאם ההגדרה מוגדרת, הזום שמשויך לתצוגה מתעדכן. הזום הזה מבצע פריסה מחדש וצביעה מחדש, ולכן הוא באיכות טובה יותר מאשר הגדלה פשוטה של כל פיקסל.
-
isPrimary
boolean אופציונלי
אם המדיניות מוגדרת כ-True, המסך הופך לראשי. אם המדיניות מוגדרת כ-False, היא לא מבצעת פעולה. הערה: אם ההגדרה הזו מוגדרת, התצוגה נחשבת ראשונית לכל הנכסים האחרים (כלומר, יכול להיות שההגדרה
isUnifiedתוגדר אבל לא ההגדרה של מקור הגבולות). -
isUnified
boolean אופציונלי
Chrome 59 ואילךרק ב-ChromeOS. אם המדיניות מוגדרת כ-True, מצב התצוגה משתנה למצב 'שולחן עבודה מאוחד' (פרטים נוספים מופיעים במאמר
enableUnifiedDesktop). אם המדיניות מוגדרת כ-False, מצב Unified Desktop מושבת. ההגדרה הזו תקפה רק לגבי המסך הראשי. אם ציינתם את mirroringSourceId, לא תוכלו לציין מאפיינים אחרים והמערכת תתעלם מהם. אם לא מספקים את הערך הזה, אין לו השפעה. -
mirroringSourceId
מחרוזת אופציונלי
הוצא משימוש מאז Chrome 68משתמשים ב-
setMirrorMode.רק ב-ChromeOS. אם ההגדרה מוגדרת ולא ריקה, היא מפעילה שיקוף רק בצג הזה. אחרת, שיקוף המסך מושבת בכל המסכים. הערך הזה צריך לציין את המזהה של התצוגה של המקור לשיקוף, והוא לא יכול להיות זהה למזהה שמועבר אל setDisplayProperties. אם המאפיין הזה מוגדר, אי אפשר להגדיר מאפיינים אחרים.
-
סריקת יתר
שוליים פנימיים אופציונלי
אם המדיניות מוגדרת, היא מגדירה את שוליים של ה-overscan בתצוגה לערכים שסופקו. חשוב לשים לב שערכי ה-overscan לא יכולים להיות שליליים או גדולים מחצי מגודל המסך. אי אפשר לשנות את ה-Overscan במסך הפנימי.
-
סיבוב
מספר אופציונלי
אם המדיניות מוגדרת, היא מעדכנת את סיבוב התצוגה. הערכים החוקיים הם [0, 90, 180, 270]. הסיבוב מוגדר בכיוון השעון, ביחס למיקום האנכי של המסך.
DisplayUnitInfo
מאפיינים
-
activeStateChrome 117 ואילך
פעיל אם המערכת מזהה את הצג ומשתמשת בו.
-
availableDisplayZoomFactors
number[]
Chrome 67 ואילךרשימה של ערכי גורם שינוי הגודל שאפשר להגדיר לתצוגה.
-
גבולות
הגבולות הלוגיים של התצוגה.
-
displayZoomFactor
number
Chrome 65 ואילךהיחס בין הזום הנוכחי של המסך לבין הזום שמוגדר כברירת מחדל. לדוגמה, ערך 1 שווה לזום של 100%, וערך 1.5 שווה לזום של 150%.
-
dpiX
number
מספר הפיקסלים לאינץ' לאורך ציר X.
-
dpiY
number
מספר הפיקסלים לאינץ' לאורך ציר Y.
-
edid
Edid אופציונלי
Chrome 67 ואילךהערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS.
-
hasTouchSupport
בוליאני
Chrome 57 ואילךהערך הוא True אם לתצוגה הזו משויך מכשיר קלט מגע.
-
id [מזהה]
מחרוזת
המזהה הייחודי של התצוגה.
-
isEnabled
בוליאני
הערך הוא True אם התצוגה הזו מופעלת.
-
isPrimary
בוליאני
הערך הוא True אם זה המסך הראשי.
-
isUnified
בוליאני
Chrome 59 ואילךהערך הוא True לכל המסכים כשמפעילים את מצב Unified Desktop. אפשר לעיין במסמכי התיעוד של
enableUnifiedDesktop. -
mirroringDestinationIds
string[]
Chrome 64+רק ב-ChromeOS. מזהים של המסכים שאליהם משוכפל המסך המקורי. השדה ריק אם לא מתבצע שיקוף של מסכים. הערך הזה יהיה זהה בכל התצוגות. הפירוט לא יכול לכלול
mirroringSourceId. -
mirroringSourceId
מחרוזת
רק ב-ChromeOS. מזהה של המסך שמשוקף אם השיקוף מופעל, אחרת הערך ריק. ההגדרה הזו תהיה תקפה לכל המסכים (כולל המסך שמשוכפל).
-
מצביםChrome 52 ואילך
רשימת מצבי התצוגה הזמינים. המאפיין isSelected יקבל את הערך true במצב הנוכחי. התכונה זמינה רק ב-ChromeOS. בפלטפורמות אחרות, הערך יהיה מערך ריק.
-
שם
מחרוזת
השם הידידותי למשתמש (לדוגמה, 'מסך LCD של HP').
-
סריקת יתר
השוליים הפנימיים של התצוגה נמצאים בתוך הגבולות של המסך. נחשף כרגע רק ב-ChromeOS. בפלטפורמות אחרות, הערך יהיה ריק.
-
סיבוב
number
סיבוב התצוגה בכיוון השעון במעלות ביחס למיקום האנכי. נחשף כרגע רק ב-ChromeOS. בפלטפורמות אחרות, הערך יהיה 0. ערך של -1 יפורש כסיבוב אוטומטי כשהמכשיר במצב פיזי של טאבלט.
-
workArea
אזור העבודה שניתן לשימוש במסך, בתוך גבולות המסך. האזור 'הצגת העבודה' לא כולל אזורים במסך ששמורים למערכת ההפעלה, למשל סרגל האפליקציות והמרכז לשליטה באפליקציות.
Edid
מאפיינים
-
manufacturerId
מחרוזת
קוד יצרן בן 3 תווים. ראו סעיף 3.4.1, עמוד 21. נדרש בגרסה 1.4.
-
productId
מחרוזת
קוד בן 2 בייטים שהוקצה על ידי היצרן, סעיף 3.4.2, עמוד 21. נדרש בגרסה 1.4.
-
yearOfManufacture
number
שנת הייצור, סעיף 3.4.4, עמוד 22. נדרש בגרסה 1.4.
GetInfoFlags
מאפיינים
-
singleUnified
boolean אופציונלי
אם המדיניות מוגדרת כ-True, רק
DisplayUnitInfoאחד יוחזר על ידיgetInfoכשמצב Unified Desktop מופעל (ראוenableUnifiedDesktop). ברירת המחדל היא False.
Insets
מאפיינים
-
תחתון
number
המרחק בציר ה-y מהגבול התחתון.
-
שמאלה
number
המרחק בציר ה-x מהגבול השמאלי.
-
ימינה
number
המרחק בציר ה-x מהגבול הימני.
-
עליון
number
המרחק בציר Y מהגבול העליון.
LayoutPosition
מיקום הפריסה, כלומר הקצה של רכיב ההורה שאליו מוצמד התצוגה.
ספירה
'top'
'right'
bottom
'left'
MirrorMode
מצב השתקפות במראה, כלומר דרכים שונות לשיקוף של מסך למסכים אחרים.
ספירה
off
מציין את מצב ברירת המחדל (מצב מורחב או מצב מאוחד של שולחן העבודה).
normal
מציין שתצוגת המקור תהיה משוכפלת בכל המסכים האחרים.
mixed
מציין שהתצוגה של המקור שצוין תשוכפל לתצוגות של היעד שצוין. כל שאר המסכים המחוברים יורחבו.
MirrorModeInfo
מאפיינים
-
mirroringDestinationIds
string[] אופציונלי
המזהים של מסכי היעד לשיקוף. ההגדרה הזו תקפה רק לערך 'מעורב'.
-
mirroringSourceId
מחרוזת אופציונלי
המזהה של מסך המקור לשיקוף. ההגדרה הזו תקפה רק לערך 'מעורב'.
-
מצב
מצב המראה שצריך להגדיר.
Point
מאפיינים
-
x
number
קואורדינטת ה-x של הנקודה.
-
y
number
קואורדינטת ה-y של הנקודה.
TouchCalibrationPair
מאפיינים
-
displayPoint
הקואורדינטות של נקודת התצוגה.
-
touchPoint
הקואורדינטות של נקודת המגע שמתאימות לנקודה במסך.
TouchCalibrationPairQuad
מאפיינים
-
pair1
התאמה ראשונה של נקודת מגע ונקודת תצוגה שנדרשת לכיול המגע.
-
pair2
נדרשת נקודה שנייה של מגע ותצוגה לכיול המגע.
-
pair3
נדרשת נקודת מגע ותצוגה שלישית לכיול המגע.
-
pair4
נדרשת נקודה רביעית של מגע ותצוגה לכיול המגע.
Methods
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
): void
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. מאפס את כיול המגע של המסך ומחזיר אותו למצב ברירת המחדל על ידי ניקוי כל נתוני כיול המגע שמשויכים למסך.
פרמטרים
-
id [מזהה]
מחרוזת
המזהה הייחודי של המסך.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
): void
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. מגדירה את זוגות הכיול של המסך למגע. הערכים האלה של pairs ישמשו לכיול מסך המגע לתצוגה באמצעות id שמופעל ב-startCustomTouchCalibration(). תמיד צריך להפעיל את startCustomTouchCalibration לפני שמפעילים את ה-method הזו. אם כבר מתבצעת כיול של מסך מגע, תופיע שגיאה.
פרמטרים
-
זוגות
צמדי הנקודות שמשמשים לכיול המסך.
-
גבולות
הגבולות של התצוגה בזמן ביצוע כיול המגע. המערכת מתעלמת מהערכים של
bounds.leftושלbounds.top.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
): void
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. הפעלה או השבתה של התכונה Unified Desktop. אם התכונה מופעלת בזמן שהשיקוף פעיל, מצב שולחן העבודה לא ישתנה עד שהשיקוף יושבת. אחרת, מצב שולחן העבודה ישתנה למצב מאוחד באופן מיידי.
פרמטרים
-
פעיל
בוליאני
הערך True אם צריך להפעיל את Unified Desktop.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
): Promise<DisplayLayout[]>
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. בקשה לקבלת מידע על הפריסה של כל המסכים.
פרמטרים
-
callback
פונקציה אופציונלית
הפרמטר
callbackנראה כך:(layouts: DisplayLayout[]) => void
-
פריסות
-
החזרות
-
Promise<DisplayLayout[]>
Chrome 91 ואילךהבטחה שמוחזרת עם התוצאות.
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
): Promise<DisplayUnitInfo[]>
הבקשה לקבלת מידע על כל מכשירי התצוגה שמחוברים למכשיר.
פרמטרים
-
סימונים
GetInfoFlags אופציונלי
Chrome 59 ואילךאפשרויות שמשפיעות על אופן החזרת המידע.
-
callback
פונקציה אופציונלית
הפרמטר
callbackנראה כך:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
החזרות
-
Promise<DisplayUnitInfo[]>
Chrome 91 ואילךהבטחה שמוחזרת עם התוצאות.
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
): void
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. ההגדרה הזו משנה את השוליים של ה-overscan הנוכחיים בתצוגה. בדרך כלל, הערך הזה צריך להזיז את התצוגה לאורך ציר (למשל, left+right מקבלים את אותו ערך) או לשנות את קנה המידה שלה לאורך ציר (למשל, top+bottom מקבלים ערכים הפוכים). כל קריאה של Adjust היא מצטברת עם הקריאות הקודמות מאז ההתחלה.
פרמטרים
-
id [מזהה]
מחרוזת
המזהה הייחודי של המסך.
-
delta
הסכום שבו יש לשנות את השוליים של ה-overscan.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
): void
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. כדי לסיים את ההתאמות של ה-overscan במסך, שומרים את הערכים הנוכחיים ומסתירים את שכבת העל.
פרמטרים
-
id [מזהה]
מחרוזת
המזהה הייחודי של המסך.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
): void
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. מאפס את השוליים של ה-overscan בתצוגה לערך האחרון שנשמר (כלומר, לפני הקריאה לפונקציה Start).
פרמטרים
-
id [מזהה]
מחרוזת
המזהה הייחודי של המסך.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
): void
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. מתחיל כיול של overscan בצג. תוצג שכבת-על במסך שתציין את שוליים הנוכחיים של ה-overscan. אם הכיול של ה-Overscan של התצוגה id נמצא בתהליך, הפעולה הזו תאפס את הכיול.
פרמטרים
-
id [מזהה]
מחרוזת
המזהה הייחודי של המסך.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
): Promise<void>
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. הגדרת הפריסה לכל המסכים. כל מסך שלא נכלל יציג את הפריסה שמוגדרת כברירת מחדל. אם פריסה מסוימת חופפת או לא תקינה, היא תותאם לפריסה תקינה. אחרי שהפריסה תיפתר, יופעל אירוע onDisplayChanged.
פרמטרים
-
פריסות
מידע על הפריסה, שנדרש לכל המסכים חוץ מהמסך הראשי.
-
callback
פונקציה אופציונלית
הפרמטר
callbackנראה כך:() => void
החזרות
-
Promise<void>
Chrome 91 ואילךאובייקט Promise שמוחזר כשהפונקציה מסתיימת.
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
): Promise<void>
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. מעדכן את המאפיינים של התצוגה שצוינה על ידי id, בהתאם למידע שסופק ב-info. אם הפעולה תיכשל, הערך runtime.lastError יוגדר.
פרמטרים
-
id [מזהה]
מחרוזת
המזהה הייחודי של המסך.
-
מידע
המידע על נכסי התצוגה שצריך לשנות. מאפיין ישתנה רק אם צוין עבורו ערך חדש ב-
info. -
callback
פונקציה אופציונלית
הפרמטר
callbackנראה כך:() => void
החזרות
-
Promise<void>
Chrome 91 ואילךאובייקט Promise שמוחזר כשהפונקציה מסתיימת.
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
): Promise<void>
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. הגדרת מצב התצוגה למצב השתקפות במראה שצוין. בכל שיחה, המצב מתאפס מהשיחות הקודמות. הקריאה ל-setDisplayProperties() תיכשל עבור מסכי היעד של שיקוף המסך.
פרמטרים
-
מידע
המידע על מצב המראה שצריך להחיל על מצב התצוגה.
-
callback
פונקציה אופציונלית
הפרמטר
callbackנראה כך:() => void
החזרות
-
Promise<void>
Chrome 91 ואילךאובייקט Promise שמושלם כשהפונקציה מסתיימת.
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
): Promise<boolean>
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. הצגת חוויית המשתמש המקורית של כיול המגע במסך עם id כמזהה המסך. יוצג כיסוי על המסך עם ההוראות הנדרשות להמשך. הקריאה החוזרת תופעל רק במקרה של כיול מוצלח. אם הכיול ייכשל, תופעל שגיאה.
פרמטרים
-
id [מזהה]
מחרוזת
המזהה הייחודי של המסך.
-
callback
פונקציה אופציונלית
הפרמטר
callbackנראה כך:(success: boolean) => void
-
הצלחה
בוליאני
-
החזרות
-
Promise<boolean>
Chrome 91 ואילךאובייקט promise שמוביל להודעה לפונקציית קריאה חוזרת (caller) שהכיול של מסך המגע הסתיים. הערך הבוליאני מציין אם הכיול הצליח או לא.
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
): void
הערה: האפשרות הזו זמינה רק לאפליקציות קיוסק של ChromeOS. מתחיל כיול מגע בהתאמה אישית למסך. צריך להפעיל את הפונקציה הזו כשמשתמשים בממשק משתמש בהתאמה אישית כדי לאסוף נתוני כיול. אם כבר מתבצעת כיול של מסך מגע, תופיע שגיאה.
פרמטרים
-
id [מזהה]
מחרוזת
המזהה הייחודי של המסך.
אירועים
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
האירוע מופעל כשמשהו משתנה בהגדרות התצוגה.
פרמטרים
-
callback
פונקציה
הפרמטר
callbackנראה כך:() => void