توضیحات
از system.display
API برای پرس و جو از متادیتای نمایش استفاده کنید.
مجوزها
system.display
انواع
ActiveState
یک عدد برای تشخیص اینکه آیا نمایشگر توسط سیستم شناسایی و استفاده می شود یا خیر. نمایشگر در صورتی که توسط سیستم تشخیص داده نشود، «غیرفعال» در نظر گرفته میشود (ممکن است قطع شده باشد، یا به دلیل حالت خواب قطع شده باشد، و غیره). به عنوان مثال، هنگامی که اتصال همه نمایشگرها قطع می شود، از این حالت برای حفظ نمایش موجود استفاده می شود.
Enum
"فعال" "غیر فعال"
Bounds
خواص
- ارتفاع
شماره
ارتفاع نمایشگر بر حسب پیکسل
- سمت چپ
شماره
مختصات x گوشه سمت چپ بالا.
- بالا
شماره
مختصات y گوشه سمت چپ بالا.
- عرض
شماره
عرض نمایشگر بر حسب پیکسل
DisplayLayout
خواص
- شناسه
رشته
شناسه منحصر به فرد نمایشگر.
- جبران
شماره
افست نمایشگر در امتداد لبه متصل. 0 نشان می دهد که بالاترین یا چپ ترین گوشه ها تراز هستند.
- شناسه والدین
رشته
شناسه منحصر به فرد نمایشگر والد. اگر این ریشه است خالی کنید.
- موقعیت
موقعیت چیدمان این نمایشگر نسبت به والد. این برای ریشه نادیده گرفته می شود.
DisplayMode
خواص
- deviceScaleFactor
شماره
عامل مقیاس دستگاه حالت نمایش.
- ارتفاع
شماره
ارتفاع حالت نمایش در پیکسل های مستقل از دستگاه (قابل مشاهده توسط کاربر).
- heightInNativePixels
شماره
ارتفاع حالت نمایش در پیکسل های اصلی.
- درهم آمیخته است
بولی اختیاری
Chrome 74+اگر این حالت بهم پیوسته باشد درست است، اگر ارائه نشده باشد نادرست است.
- بومی است
بولی
اگر حالت حالت اصلی نمایشگر باشد درست است.
- انتخاب شده است
بولی
اگر حالت نمایش در حال حاضر انتخاب شده باشد درست است.
- refreshRate
شماره
Chrome 67+نرخ نوسازی حالت نمایش بر حسب هرتز.
- uiScale
شماره اختیاری
از Chrome 70 منسوخ شده استاز
displayZoomFactor
استفاده کنیدضریب مقیاس UI حالت نمایش.
- عرض
شماره
عرض حالت نمایش در پیکسل های مستقل از دستگاه (قابل مشاهده توسط کاربر).
- widthInNativePixels
شماره
عرض حالت نمایش در پیکسل های بومی.
DisplayProperties
خواص
- boundsOriginX
شماره اختیاری
در صورت تنظیم، منشاء مرزهای منطقی نمایشگر را در امتداد محور x به روز می کند. همراه با
boundsOriginY
اعمال شد. اگر تنظیم نشده باشد، مقدار فعلی پیشفرض میشود وboundsOriginY
تنظیم شده است. توجه داشته باشید که هنگام بهروزرسانی مبدا نمایش، برخی محدودیتها اعمال میشوند، بنابراین مبدا کرانهای نهایی ممکن است متفاوت از یک مجموعه باشد. کرانه های نهایی را می توان با استفاده ازgetInfo
بازیابی کرد. منشا کرانه ها را نمی توان در صفحه نمایش اصلی تغییر داد. - boundsOriginY
شماره اختیاری
در صورت تنظیم، منشاء مرزهای منطقی نمایشگر را در امتداد محور y به روز می کند. برای پارامتر
boundsOriginX
به مستندات مراجعه کنید. - حالت نمایش
DisplayMode اختیاری است
Chrome 52+در صورت تنظیم، حالت نمایش را به حالت مطابق با این مقدار به روز می کند. اگر سایر پارامترها نامعتبر باشند، این مورد اعمال نخواهد شد. اگر حالت نمایش نامعتبر باشد، اعمال نمی شود و خطایی تنظیم می شود، اما ویژگی های دیگر همچنان اعمال می شود.
- displayZoomFactor
شماره اختیاری
Chrome 65+در صورت تنظیم، بزرگنمایی مرتبط با نمایشگر را به روز می کند. این بزرگنمایی طرحبندی و رنگآمیزی مجدد را انجام میدهد و در نتیجه زوم با کیفیت بهتری نسبت به بزرگنمایی یک پیکسل به پیکسل ایجاد میکند.
- اولیه است
بولی اختیاری
اگر روی true تنظیم شود، صفحه نمایش را اصلی می کند. در صورتی که روی false تنظیم شود، No-op. توجه: در صورت تنظیم، صفحه نمایش برای همه ویژگی های دیگر اصلی در نظر گرفته می شود (یعنی
isUnified
ممکن است تنظیم شود و مبدا کران ممکن است نباشد). - متحد است
بولی اختیاری
Chrome 59+فقط سیستم عامل کروم. اگر روی درست تنظیم شود، حالت نمایش را به دسکتاپ یکپارچه تغییر میدهد (برای جزئیات به
enableUnifiedDesktop
مراجعه کنید). اگر روی false تنظیم شود، حالت دسکتاپ یکپارچه غیرفعال می شود. این فقط برای نمایشگر اصلی معتبر است. در صورت ارائه، mirroringSourceId نباید ارائه شود و سایر ویژگی ها نادیده گرفته می شوند. اگر ارائه نشود هیچ تاثیری ندارد. - mirroringSourceId
رشته اختیاری
از Chrome 68 منسوخ شده استاز
setMirrorMode
استفاده کنید.فقط سیستم عامل کروم. اگر تنظیم شود و خالی نباشد، آینهکاری را فقط برای این نمایشگر فعال میکند. در غیر این صورت، انعکاس را برای همه نمایشگرها غیرفعال می کند. این مقدار باید نشان دهنده id صفحه نمایش مبدا به آینه باشد، که نباید با شناسه ارسال شده به setDisplayProperties یکسان باشد. در صورت تنظیم، هیچ ویژگی دیگری نمیتواند تنظیم شود.
- overscan
Insets اختیاری است
در صورت تنظیم، ورودی های اسکن بیش از حد نمایشگر را روی مقادیر ارائه شده تنظیم می کند. توجه داشته باشید که مقادیر Overscan ممکن است منفی یا بزرگتر از نیمی از اندازه صفحه نمایش نباشد. Overscan را نمی توان در مانیتور داخلی تغییر داد.
- چرخش
شماره اختیاری
در صورت تنظیم، چرخش نمایشگر را به روز می کند. مقادیر قانونی [0، 90، 180، 270] هستند. چرخش در جهت عقربه های ساعت، نسبت به موقعیت عمودی نمایشگر تنظیم می شود.
DisplayUnitInfo
خواص
- وضعیت فعالChrome 117+
اگر نمایشگر توسط سیستم شناسایی و استفاده شود فعال است.
- در دسترس DisplayZoomFactors
شماره[]
Chrome 67+فهرستی از مقادیر فاکتور بزرگنمایی که می توان برای نمایشگر تنظیم کرد.
- محدوده
محدوده های منطقی نمایشگر
- displayZoomFactor
شماره
Chrome 65+نسبت بین زوم فعلی و پیش فرض نمایشگر. به عنوان مثال، مقدار 1 معادل 100% زوم و مقدار 1.5 معادل 150% زوم است.
- dpiX
شماره
تعداد پیکسل در هر اینچ در امتداد محور x.
- dpiY
شماره
تعداد پیکسل در هر اینچ در امتداد محور y.
- ادید
ویرایش اختیاری است
Chrome 67+توجه: این فقط برای برنامههای کیوسک سیستم عامل Chrome و رابط کاربری وب در دسترس است.
- دارای پشتیبانی لمسی
بولی
Chrome 57+درست است اگر این نمایشگر یک دستگاه ورودی لمسی مرتبط با آن داشته باشد.
- شناسه
رشته
شناسه منحصر به فرد نمایشگر.
- فعال است
بولی
اگر این نمایشگر فعال باشد درست است.
- اولیه است
بولی
درست است اگر این صفحه نمایش اصلی باشد.
- متحد است
بولی
Chrome 59+در حالت دسکتاپ یکپارچه برای همه نمایشگرها درست است. به مستندات
enableUnifiedDesktop
مراجعه کنید. - mirroringDestinationIds
رشته[]
Chrome 64+فقط سیستم عامل کروم. شناسه نمایشگرهایی که نمایش منبع به آنها منعکس شده است. اگر هیچ نمایشگری انعکاس داده نمی شود، خالی است. این مقدار برای همه نمایشگرها روی یک مقدار تنظیم می شود. این نباید شامل
mirroringSourceId
باشد. - mirroringSourceId
رشته
فقط سیستم عامل کروم. شناسه نمایشگری که در صورت فعال بودن انعکاس آینه می شود، در غیر این صورت خالی است. این برای همه نمایشگرها (از جمله نمایشگر در حال آینه) تنظیم می شود.
- حالت ها
حالت نمایش []
Chrome 52+لیست حالت های نمایش موجود حالت فعلی isSelected=true خواهد بود. فقط در سیستم عامل Chrome موجود است. در پلتفرم های دیگر روی یک آرایه خالی تنظیم می شود.
- نام
رشته
نام کاربر پسند (مانند "مانیتور HP LCD").
- overscan
قسمت های داخلی نمایشگر در محدوده صفحه نمایش آن است. در حال حاضر فقط در ChromeOS در معرض نمایش قرار میگیرد. در پلتفرمهای دیگر روی ورودیهای خالی تنظیم میشود.
- چرخش
شماره
چرخش نمایشگر در جهت عقربه های ساعت در درجه نسبت به موقعیت عمودی. در حال حاضر فقط در ChromeOS در معرض نمایش قرار میگیرد. در سایر پلتفرم ها روی 0 تنظیم می شود. هنگامی که دستگاه در حالت رایانه لوحی قرار دارد، مقدار -1 به عنوان چرخش خودکار تفسیر می شود.
- منطقه کاری
ناحیه کاری قابل استفاده نمایشگر در محدوده نمایشگر. منطقه کاری شامل بخش هایی از صفحه نمایش است که برای سیستم عامل اختصاص داده شده است، به عنوان مثال نوار وظیفه و راه اندازی.
Edid
خواص
- شناسه سازنده
رشته
کد سازنده 3 کاراکتری رجوع کنید به بخش 3.4.1 صفحه 21. مورد نیاز در v1.4.
- شناسه محصول
رشته
2 بایت کد اختصاص داده شده توسط سازنده، Sec. 3.4.2 صفحه 21. مورد نیاز در v1.4.
- سال تولید
شماره
سال سازنده، Sec. 3.4.4 صفحه 22. مورد نیاز در v1.4.
GetInfoFlags
خواص
- singleUnified
بولی اختیاری
اگر روی true تنظیم شود، تنها یک
DisplayUnitInfo
زمانی که در حالت دسکتاپ یکپارچه است توسطgetInfo
برگردانده می شود (بهenableUnifiedDesktop
مراجعه کنید). پیش فرض به نادرست.
Insets
خواص
- پایین
شماره
فاصله محور y از کران پایین.
- سمت چپ
شماره
فاصله محور x از کران سمت چپ.
- درست است
شماره
فاصله محور x از کران سمت راست.
- بالا
شماره
فاصله محور y از کران بالا.
LayoutPosition
موقعیت چیدمان، یعنی لبه والد که نمایشگر به آن متصل است.
Enum
"بالا" "درست" "پایین" "چپ"
MirrorMode
حالت آینهای، یعنی روشهای مختلف انعکاس نمایشگر به نمایشگرهای دیگر.
Enum
"خاموش" "عادی" "مخلوط"
حالت پیش فرض (دسکتاپ توسعه یافته یا یکپارچه) را مشخص می کند.
مشخص می کند که صفحه نمایش منبع پیش فرض به همه نمایشگرهای دیگر منعکس شود.
مشخص می کند که صفحه نمایش منبع مشخص شده به نمایشگرهای مقصد ارائه شده منعکس شود. همه نمایشگرهای متصل دیگر گسترش خواهند یافت.
MirrorModeInfo
خواص
- mirroringDestinationIds
رشته[] اختیاری است
شناسه مقصد آینهای نمایش داده میشود. این فقط برای "مخلوط" معتبر است.
- mirroringSourceId
رشته اختیاری
شناسه نمایش منبع آینه. این فقط برای "مخلوط" معتبر است.
- حالت
حالت آینه ای که باید تنظیم شود.
Point
خواص
- x
شماره
مختصات x نقطه.
- y
شماره
مختصات y نقطه.
TouchCalibrationPair
TouchCalibrationPairQuad
خواص
- جفت 1
اولین جفت نقطه لمس و نمایش برای کالیبراسیون لمسی مورد نیاز است.
- جفت 2
جفت دوم نقطه لمس و نمایش برای کالیبراسیون لمسی مورد نیاز است.
- جفت 3
سومین جفت نقطه لمس و نمایش برای کالیبراسیون لمسی مورد نیاز است.
- جفت 4
چهارمین جفت نقطه لمس و نمایش برای کالیبراسیون لمسی مورد نیاز است.
روش ها
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
کالیبراسیون لمسی نمایشگر را بازنشانی میکند و با پاک کردن دادههای کالیبراسیون لمسی مرتبط با نمایشگر، آن را به حالت پیشفرض خود برمیگرداند.
پارامترها
- شناسه
رشته
شناسه منحصر به فرد نمایشگر
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
جفت های کالیبراسیون لمسی را برای نمایشگر تنظیم می کند. این pairs
برای کالیبره کردن صفحه لمسی برای نمایش با id
که در startCustomTouchCalibration () نامیده می شود استفاده می شود. همیشه قبل از فراخوانی این روش، startCustomTouchCalibration
فراخوانی کنید. اگر کالیبراسیون لمسی دیگری از قبل در حال انجام باشد، خطا ایجاد می کند.
پارامترها
جفت نقطه مورد استفاده برای کالیبره کردن نمایشگر.
- محدوده
مرزهای صفحه نمایش زمانی که کالیبراسیون لمسی انجام شد. مقادیر
bounds.left
وbounds.top
نادیده گرفته می شوند.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
)
ویژگی دسکتاپ یکپارچه را فعال/غیرفعال می کند. اگر در زمانی که آینهسازی فعال است فعال شود، حالت دسکتاپ تا زمانی که آینهسازی خاموش نشود تغییر نمیکند. در غیر این صورت، حالت دسکتاپ بلافاصله به یکپارچه تغییر می کند. توجه: این فقط برای برنامههای کیوسک سیستم عامل Chrome و رابط کاربری وب در دسترس است.
پارامترها
- فعال شد
بولی
درست است اگر دسکتاپ یکپارچه باید فعال باشد.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
)
اطلاعات طرح بندی را برای همه نمایشگرها درخواست می کند. توجه: این فقط برای برنامههای کیوسک سیستم عامل Chrome و رابط کاربری وب در دسترس است.
پارامترها
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(layouts: DisplayLayout[]) => void
- طرح بندی ها
برمی گرداند
Promise< DisplayLayout []>
Chrome 91+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
اطلاعات مربوط به همه دستگاه های نمایشگر متصل را درخواست می کند.
پارامترها
- پرچم ها
GetInfoFlags اختیاری است
Chrome 59+گزینههایی که بر نحوه بازگرداندن اطلاعات تأثیر میگذارند.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(displayInfo: DisplayUnitInfo[]) => void
- displayInfo
برمی گرداند
Promise< DisplayUnitInfo []>
Chrome 91+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
ورودی های اسکن فعلی را برای نمایشگر تنظیم می کند. معمولاً یا باید نمایشگر را در امتداد یک محور حرکت دهد (مثلاً چپ + راست مقدار یکسانی دارند) یا مقیاس آن را در امتداد یک محور (مثلاً بالا+پایین مقادیر مخالف دارند). هر تماس Adjust با تماس های قبلی از زمان شروع تجمعی است.
پارامترها
- شناسه
رشته
شناسه منحصر به فرد نمایشگر
- دلتا
مقدار برای تغییر درج های overscan.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
با ذخیره مقادیر فعلی و پنهان کردن پوشش، تنظیمات اسکن بیش از حد نمایشگر را کامل کنید.
پارامترها
- شناسه
رشته
شناسه منحصر به فرد نمایشگر
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
ورودی های اسکن بیش از حد نمایشگر را به آخرین مقدار ذخیره شده (یعنی قبل از فراخوانی Start) بازنشانی می کند.
پارامترها
- شناسه
رشته
شناسه منحصر به فرد نمایشگر
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
)
کالیبراسیون اسکن بیش از حد برای نمایشگر را شروع می کند. این یک پوشش روی صفحه نمایش نشان می دهد که درج های اسکن فعلی را نشان می دهد. اگر کالیبراسیون اسکن بیش از حد برای id
نمایشگر در حال انجام است، کالیبراسیون مجدداً تنظیم می شود.
پارامترها
- شناسه
رشته
شناسه منحصر به فرد نمایشگر
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
)
طرح بندی را برای همه نمایشگرها تنظیم کنید. هر صفحه نمایشی که گنجانده نشده باشد از طرح بندی پیش فرض استفاده می کند. اگر یک طرح با هم همپوشانی داشته باشد یا در غیر این صورت نامعتبر باشد، به یک طرح بندی معتبر تنظیم می شود. پس از حل شدن طرح، یک رویداد onDisplayChanged فعال می شود. توجه: این فقط برای برنامههای کیوسک سیستم عامل Chrome و رابط کاربری وب در دسترس است.
پارامترها
- طرح بندی ها
اطلاعات چیدمان، برای همه نمایشگرها به جز نمایشگر اصلی مورد نیاز است.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
برمی گرداند
قول<باطل>
Chrome 91+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
)
طبق اطلاعات ارائه شده در info
، ویژگی های نمایشگر مشخص شده توسط id
را به روز می کند. در صورت شکست، runtime.lastError
تنظیم خواهد شد. توجه: این فقط برای برنامههای کیوسک سیستم عامل Chrome و رابط کاربری وب در دسترس است.
پارامترها
- شناسه
رشته
شناسه منحصر به فرد نمایشگر
- اطلاعات
اطلاعات مربوط به ویژگی های نمایشگر که باید تغییر کنند. یک ویژگی تنها در صورتی تغییر می کند که مقدار جدیدی برای آن در
info
مشخص شده باشد. - پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
برمی گرداند
قول<باطل>
Chrome 91+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
حالت نمایش را روی حالت آینه ای مشخص شده تنظیم می کند. هر تماس وضعیت تماس های قبلی را بازنشانی می کند. فراخوانی setDisplayProperties() برای نمایشگرهای مقصد انعکاسی ناموفق خواهد بود. توجه: این فقط برای برنامههای کیوسک سیستم عامل Chrome و رابط کاربری وب در دسترس است.
پارامترها
- اطلاعات
اطلاعات حالت آینه ای که باید در حالت نمایش اعمال شود.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
برمی گرداند
قول<باطل>
Chrome 91+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
UX کالیبراسیون لمسی بومی را برای نمایشگر با id
به عنوان شناسه نمایشگر نمایش می دهد. این یک پوشش روی صفحه نمایش با دستورالعمل های لازم در مورد نحوه ادامه کار نشان می دهد. تنها در صورت کالیبراسیون موفقیت آمیز، تماس برگشتی فراخوانی می شود. اگر کالیبراسیون ناموفق باشد، این یک خطا ایجاد می کند.
پارامترها
- شناسه
رشته
شناسه منحصر به فرد نمایشگر
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(success: boolean) => void
- موفقیت
بولی
برمی گرداند
وعده<boolean>
Chrome 91+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
کالیبراسیون لمسی سفارشی را برای نمایشگر شروع می کند. این باید هنگام استفاده از یک UX سفارشی برای جمع آوری داده های کالیبراسیون فراخوانی شود. اگر کالیبراسیون لمسی دیگری از قبل در حال انجام باشد، خطا ایجاد می کند.
پارامترها
- شناسه
رشته
شناسه منحصر به فرد نمایشگر
رویدادها
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
هنگامی که هر چیزی به پیکربندی نمایشگر تغییر می کند فعال می شود.
پارامترها
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:() => void