chrome.system.display

refresh date: 2026-09-25 robots: noindex

شرح

از system.display API برای پرسمان فراداده نمایش استفاده کنید.

اجازه‌ها

system.display

انواع

ActiveState

Chrome نسخه ۱۱۷ و بالاتر

یک شمارش برای اینکه مشخص شود آیا نمایشگر توسط سیستم شناسایی و استفاده می‌شود یا نه. اگر نمایشگر توسط سیستم شناسایی نشود (شاید اتصال آن قطع شده باشد یا به‌دلیل حالت خواب و غیره اتصال آن قطع‌شده درنظر گرفته شود)، «غیرفعال» درنظر گرفته می‌شود. برای مثال، از این حالت برای حفظ نمایشگر موجود درصورت قطع اتصال همه نمایشگرها استفاده می‌شود.

شمارشی

«فعال»

«غیرفعال»

Bounds

مشخصات

  • ارتفاع

    شماره

    ارتفاع نمایشگر به پیکسل.

  • چپ

    شماره

    مختصات x گوشه بالا سمت چپ.

  • بالا

    شماره

    مختصات y گوشه بالا سمت چپ.

  • عرض

    شماره

    عرض نمایشگر به پیکسل.

DisplayLayout

Chrome نسخه ۵۳ و بالاتر

مشخصات

  • id

    رشته

    شناسه یکتای نمایشگر.

  • جبران کردن

    شماره

    انحراف نمایشگر در امتداد لبه متصل. ‫0 نشان می‌دهد که بالاترین یا چپ‌ترین گوشه‌ها هم‌تراز هستند.

  • parentId

    رشته

    شناسه یکتای نمایشگر اصلی. اگر این ریشه است، خالی بگذارید.

  • جایگاه

    LayoutPosition

    موقعیت چیدمان این نمایشگر نسبت به والد. این مورد برای ریشه نادیده گرفته خواهد شد.

DisplayMode

Chrome نسخه ۵۲ و بالاتر

مشخصات

  • deviceScaleFactor

    شماره

    ضریب مقیاس دستگاه حالت نمایش.

  • ارتفاع

    شماره

    ارتفاع حالت نمایش در پیکسل‌های مستقل از دستگاه (قابل‌مشاهده برای کاربر).

  • heightInNativePixels

    شماره

    ارتفاع حالت نمایش به پیکسل‌های اصلی.

  • isInterlaced

    بولی اختیاری

    Chrome نسخه ۷۴ و بالاتر

    اگر این حالت درهم‌بافته باشد درست است، اگر ارائه نشده باشد نادرست است.

  • isNative

    بولی

    اگر حالت نمایشگر حالت اصلی باشد، True است.

  • isSelected

    بولی

    اگر حالت نمایش درحال‌حاضر انتخاب شده باشد، درست است.

  • refreshRate

    شماره

    Chrome نسخه ۶۷ و بالاتر

    نرخ بازآوری حالت نمایشگر برحسب هرتز.

  • uiScale

    شماره اختیاری

    از Chrome 70 منسوخ شده است

    استفاده از displayZoomFactor

    ضریب مقیاس میانای کاربر حالت نمایش.

  • عرض

    شماره

    عرض حالت نمایش در پیکسل‌های مستقل از دستگاه (قابل‌مشاهده برای کاربر).

  • widthInNativePixels

    شماره

    عرض حالت نمایش به پیکسل‌های اصلی.

DisplayProperties

مشخصات

  • boundsOriginX

    شماره اختیاری

    اگر تنظیم شود، مبدأ مرزهای منطقی نمایشگر را در امتداد محور x به‌روز می‌کند. همراه با boundsOriginY اعمال شد. اگر تنظیم نشده باشد و boundsOriginY تنظیم شده باشد، به‌طور پیش‌فرض روی مقدار فعلی تنظیم می‌شود. توجه داشته باشید که هنگام به‌روزرسانی مبدأ نمایشگر، برخی محدودیت‌ها اعمال خواهد شد، بنابراین مبدأ مرزهای نهایی ممکن است با مبدأ تنظیم‌شده متفاوت باشد. مرزهای نهایی را می‌توان بااستفاده از getInfo بازیابی کرد. مبدأ مرزها را نمی‌توان در نمایشگر اصلی تغییر داد.

  • boundsOriginY

    شماره اختیاری

    اگر تنظیم شود، مبدأ مرزهای منطقی نمایشگر را در امتداد محور y به‌روز می‌کند. اسناد مربوط به پارامتر boundsOriginX را ببینید.

  • displayMode

    DisplayMode اختیاری

    Chrome نسخه ۵۲ و بالاتر

    اگر تنظیم شود، حالت نمایش را به حالتی که با این مقدار مطابقت دارد به‌روز می‌کند. اگر پارامترهای دیگر نامعتبر باشند، این مورد اعمال نخواهد شد. اگر حالت نمایش نامعتبر باشد، اعمال نخواهد شد و خطایی تنظیم می‌شود، اما سایر ویژگی‌ها همچنان اعمال خواهند شد.

  • displayZoomFactor

    شماره اختیاری

    Chrome نسخه ۶۵ و بالاتر

    اگر تنظیم شده باشد، بزرگ‌نمایی مرتبط با نمایشگر را به‌روز می‌کند. این بزرگ‌نمایی چیدمان مجدد و رنگ‌آمیزی مجدد انجام می‌دهد، بنابراین بزرگ‌نمایی با کیفیت بهتری نسبت‌به بزرگ‌نمایی کششی پیکسل به پیکسل ارائه می‌دهد.

  • isPrimary

    بولی اختیاری

    اگر روی «درست» تنظیم شود، نمایشگر را اصلی می‌کند. اگر روی نادرست تنظیم شود، No-op است. توجه: اگر تنظیم شود، نمایشگر برای همه ویژگی‌های دیگر اصلی درنظر گرفته می‌شود (یعنی ممکن است isUnified تنظیم شود و مبدأ مرزها تنظیم نشود).

  • isUnified

    بولی اختیاری

    Chrome نسخه ۵۹ و بالاتر

    فقط ChromeOS. اگر روی «درست» تنظیم شود، حالت نمایش را به میزکار یکپارچه تغییر می‌دهد (برای جزئیات، enableUnifiedDesktop را ببینید). اگر روی نادرست تنظیم شود، حالت رایانه یکپارچه غیرفعال خواهد شد. این فقط برای نمایشگر اصلی معتبر است. اگر ارائه شود، mirroringSourceId نباید ارائه شود و سایر ویژگی‌ها نادیده گرفته خواهند شد. اگر ارائه نشود، تأثیری ندارد.

  • mirroringSourceId

    رشته اختیاری

    از Chrome 68 منسوخ شده است

    از setMirrorMode استفاده کنید.

    فقط ChromeOS. اگر تنظیم شده باشد و خالی نباشد، آینه‌سازی را فقط برای این نمایشگر فعال می‌کند. درغیراین‌صورت، آینه‌سازی را برای همه نمایشگرها غیرفعال می‌کند. این مقدار باید شناسه نمایشگر منبع را برای قرینه‌سازی نشان دهد، که نباید با شناسه ارسال‌شده به setDisplayProperties یکسان باشد. اگر تنظیم شود، هیچ ویژگی دیگری را نمی‌توان تنظیم کرد.

  • تصویر بزرگ‌تر از صفحه

    Insets اختیاری

    اگر تنظیم شود، حاشیه‌های داخلی بیش‌اسکن نمایشگر را روی مقادیر ارائه‌شده تنظیم می‌کند. توجه داشته باشید که مقادیر اسکن بیش‌ازاندازه نباید منفی یا بزرگ‌تر از نصف اندازه صفحه‌نمایش باشد. «اسکن بیش‌ازاندازه» را نمی‌توان در مانیتور داخلی تغییر داد.

  • چرخش

    شماره اختیاری

    اگر تنظیم شده باشد، چرخش نمایشگر را به‌روز می‌کند. مقادیر مجاز [0, 90, 180, 270] است. چرخش در جهت عقربه‌های ساعت نسبت به موقعیت عمودی نمایشگر تنظیم شده است.

DisplayUnitInfo

مشخصات

  • activeState

    ActiveState

    Chrome نسخه ۱۱۷ و بالاتر

    اگر نمایشگر شناسایی شود و سیستم از آن استفاده کند، فعال است.

  • availableDisplayZoomFactors

    عدد[]

    Chrome نسخه ۶۷ و بالاتر

    فهرستی از مقادیر ضریب بزرگ‌نمایی که می‌توان برای نمایشگر تنظیم کرد.

  • حدود

    مرزها

    محدوده‌های منطقی نمایشگر.

  • displayZoomFactor

    شماره

    Chrome نسخه ۶۵ و بالاتر

    نسبت بین بزرگ‌نمایی فعلی و پیش‌فرض نمایشگر. برای مثال، مقدار ۱ معادل بزرگ‌نمایی ۱۰۰٪ و مقدار ۱٫۵ معادل بزرگ‌نمایی ۱۵۰٪ است.

  • dpiX

    شماره

    تعداد پیکسل‌ها در هر اینچ در امتداد محور x.

  • dpiY

    شماره

    تعداد پیکسل‌ها در هر اینچ در امتداد محور y.

  • edid

    Edid اختیاری

    Chrome نسخه ۶۷ و بالاتر

    توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است.

  • hasTouchSupport

    بولی

    Chrome نسخه ۵۷ و بالاتر

    اگر این نمایشگر دستگاه ورودی لمسی مرتبط با خود داشته باشد، مقدار درست را برمی‌گرداند.

  • id

    رشته

    شناسه یکتای نمایشگر.

  • isEnabled

    بولی

    اگر این نمایشگر فعال باشد، درست است.

  • isPrimary

    بولی

    اگر این نمایشگر اصلی باشد، درست است.

  • isUnified

    بولی

    Chrome نسخه ۵۹ و بالاتر

    در حالت میزکار یکپارچه، برای همه نمایشگرها درست است. سند enableUnifiedDesktop را ببینید.

  • mirroringDestinationIds

    string[]

    Chrome نسخه ۶۴ به بالا

    فقط ChromeOS. شناسه‌های نمایشگرهایی که نمایشگر منبع در آن‌ها آینه‌سازی می‌شود. اگر هیچ نمایشگری آینه‌سازی نمی‌شود، خالی است. این مقدار برای همه نمایشگرها یکسان تنظیم خواهد شد. این نباید شامل mirroringSourceId باشد.

  • mirroringSourceId

    رشته

    فقط ChromeOS. شناسه نمایشگری که درحال آینه‌سازی است (اگر آینه‌سازی فعال باشد)، درغیراین‌صورت خالی است. این تنظیم برای همه نمایشگرها (ازجمله نمایشگری که قرینه‌سازی می‌شود) اعمال خواهد شد.

  • حالت‌ها

    DisplayMode[]

    Chrome نسخه ۵۲ و بالاتر

    فهرست حالت‌های نمایش دردسترس. حالت فعلی isSelected=true خواهد داشت. فقط در ChromeOS دردسترس است. در پلاتفرم‌های دیگر روی آرایه خالی تنظیم خواهد شد.

  • نام

    رشته

    نام کاربرپسند (مثلاً «نمایشگر HP LCD»).

  • تصویر بزرگ‌تر از صفحه

    درج‌ها

    تورفتگی‌های نمایشگر در محدوده صفحه‌نمایش آن. درحال‌حاضر فقط در ChromeOS نمایش داده می‌شود. در پلاتفرم‌های دیگر روی درج‌های خالی تنظیم خواهد شد.

  • چرخش

    شماره

    چرخش ساعت‌گرد نمایشگر برحسب درجه نسبت به موقعیت عمودی. درحال‌حاضر فقط در ChromeOS نمایش داده می‌شود. در پلاتفرم‌های دیگر روی ۰ تنظیم خواهد شد. مقدار ۱- به‌عنوان چرخش خودکار تفسیر می‌شود وقتی دستگاه در حالت فیزیکی رایانه لوحی باشد.

  • workArea

    مرزها

    ناحیه کاری قابل‌استفاده نمایشگر در محدوده نمایشگر. فضای کاری شامل قسمت‌هایی از نمایشگر که برای سیستم‌عامل رزرو شده است (برای مثال، نوار وظیفه و راه‌انداز) نمی‌شود.

Edid

Chrome نسخه ۶۷ و بالاتر

مشخصات

  • manufacturerId

    رشته

    کد سازنده ۳ نویسه‌ای. به بخش ۳.۴.۱ صفحه ۲۱ مراجعه کنید. در نسخه ۱.۴ الزامی است.

  • productId

    رشته

    کد ۲ بایتی اختصاص‌داده‌شده توسط سازنده، بخش ۳.۴.۲ صفحه ۲۱. در نسخه ۱.۴ الزامی است.

  • yearOfManufacture

    شماره

    سال تولید، بخش ۳.۴.۴ صفحه ۲۲. در نسخه ۱.۴ الزامی است.

GetInfoFlags

Chrome نسخه ۵۹ و بالاتر

مشخصات

  • singleUnified

    بولی اختیاری

    اگر روی «درست» تنظیم شود، فقط یک DisplayUnitInfo توسط getInfo در حالت میزکار یکپارچه برگردانده می‌شود (enableUnifiedDesktop را ببینید). به‌طور پیش‌فرض روی «نادرست» تنظیم شده است.

Insets

مشخصات

  • پایین

    شماره

    فاصله محور y از مرز پایین.

  • چپ

    شماره

    فاصله محور x از مرز چپ.

  • راست

    شماره

    فاصله محور x از مرز راست.

  • بالا

    شماره

    فاصله محور y از کران بالا.

LayoutPosition

Chrome نسخه ۵۳ و بالاتر

موقعیت چیدمان، یعنی لبه والد که نمایشگر به آن متصل است.

شمارشی

«بالا»

«right»

"bottom"

"left"

MirrorMode

Chrome نسخه ۶۵ و بالاتر

حالت آینه‌ای، یعنی روش‌های مختلفی که یک نمایشگر در نمایشگرهای دیگر آینه‌سازی می‌شود.

شمارشی

«off»
حالت پیش‌فرض را مشخص می‌کند (میز کار گسترده یا یکپارچه).

«normal»
مشخص می‌کند که نمایشگر منبع پیش‌فرض در همه نمایشگرهای دیگر آینه‌سازی خواهد شد.

«مختلط»
مشخص می‌کند که نمایشگر منبع مشخص‌شده در نمایشگرهای مقصد ارائه‌شده آینه‌ای خواهد شد. همه نمایشگرهای متصل دیگر گسترش خواهند یافت.

MirrorModeInfo

Chrome نسخه ۶۵ و بالاتر

مشخصات

  • mirroringDestinationIds

    رشته[] اختیاری

    شناسه‌های نمایشگرهای مقصد قرینه‌سازی. این فقط برای «مختلط» معتبر است.

  • mirroringSourceId

    رشته اختیاری

    شناسه نمایشگر منبع قرینه‌سازی. این فقط برای «مختلط» معتبر است.

  • حالت حمل‌ونقل

    MirrorMode

    حالت آینه‌ای که باید تنظیم شود.

Point

Chrome نسخه ۵۷ و بالاتر

مشخصات

  • x

    شماره

    مختصات x نقطه.

  • y

    شماره

    مختصات y نقطه.

TouchCalibrationPair

Chrome نسخه ۵۷ و بالاتر

مشخصات

  • displayPoint

    نقطه

    مختصات نقطه نمایش.

  • touchPoint

    نقطه

    مختصات نقطه لمس مربوط به نقطه نمایش.

TouchCalibrationPairQuad

Chrome نسخه ۵۷ و بالاتر

مشخصات

  • برای واسنجی لمس، اولین جفت نقطه لمس و نمایش لازم است.

  • برای واسنجی لمس، جفت دوم نقطه لمس و نمایش لازم است.

  • برای واسنجی لمس، جفت سوم نقطه لمس و نمایش لازم است.

  • برای واسنجی لمس، جفت چهارم نقطه لمس و نمایش لازم است.

روش‌ها

clearTouchCalibration()

Chrome نسخه ۵۷ و بالاتر 
chrome.system.display.clearTouchCalibration(
  id: string,
): void

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. واسنجی لمسی نمایشگر را بازنشانی می‌کند و با پاک کردن همه داده‌های واسنجی لمسی مرتبط با نمایشگر، آن را به حالت پیش‌فرض برمی‌گرداند.

پارامترها

  • id

    رشته

    شناسه یکتای نمایشگر.

completeCustomTouchCalibration()

Chrome نسخه ۵۷ و بالاتر 
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. جفت‌های واسنجی لمسی را برای نمایشگر تنظیم می‌کند. این pairs برای واسنجی صفحه‌نمایش لمسی برای نمایش با id که در startCustomTouchCalibration()‎ فراخوانی شده است استفاده می‌شود. همیشه قبل‌از فراخوانی این روش، startCustomTouchCalibration را فراخوانی کنید. اگر کالیبره کردن لمسی دیگری درحال انجام باشد، این کار باعث ایجاد خطا می‌شود.

پارامترها

  • جفت‌ها

    TouchCalibrationPairQuad

    جفت نقطه‌هایی که برای کالیبره کردن نمایشگر استفاده می‌شود.

  • حدود

    مرزها

    مرزهای نمایشگر هنگام انجام واسنجی لمسی. مقادیر bounds.left و bounds.top نادیده گرفته می‌شوند.

enableUnifiedDesktop()

Chrome نسخه ۴۶ و بالاتر 
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. ویژگی میز کار یکپارچه را فعال/غیرفعال می‌کند. اگر درحین فعال بودن آینه‌سازی فعال شود، حالت رایانه تا زمانی که آینه‌سازی خاموش نشود تغییر نخواهد کرد. درغیراین‌صورت، حالت رایانه بلافاصله به حالت یکپارچه تغییر خواهد کرد.

پارامترها

  • فعال شد

    بولی

    اگر میزکار یکپارچه باید فعال شود، درست است.

getDisplayLayout()

Promise Chrome 53+ 
chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. اطلاعات چیدمان را برای همه نمایشگرها درخواست می‌کند.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (layouts: DisplayLayout[]) => void

بازگشتی‌ها

  • Promise<DisplayLayout[]>

    Chrome نسخه ۹۱ به بالا

    Promise که با نتایج حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getInfo()

قول 
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
): Promise<DisplayUnitInfo[]>

اطلاعات همه دستگاه‌های نمایشگر متصل را درخواست می‌کند.

پارامترها

  • پرچم‌ها

    GetInfoFlags اختیاری

    Chrome نسخه ۵۹ و بالاتر

    گزینه‌هایی که بر نحوه برگرداندن اطلاعات تأثیر می‌گذارند.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (displayInfo: DisplayUnitInfo[]) => void

بازگشتی‌ها

  • Promise<DisplayUnitInfo[]>

    Chrome نسخه ۹۱ به بالا

    Promise که با نتایج حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

overscanCalibrationAdjust()

Chrome نسخه ۵۳ و بالاتر 
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. تنظیمات کنونی حاشیه بیش‌اسکن را برای نمایشگر تنظیم می‌کند. معمولاً این کار باید نمایشگر را در امتداد یک محور حرکت دهد (مثلاً چپ+راست مقدار یکسانی داشته باشند) یا آن را در امتداد یک محور مقیاس‌بندی کند (مثلاً بالا+پایین مقادیر متضادی داشته باشند). هر فراخوانی Adjust با فراخوانی‌های قبلی از زمان «شروع» تجمعی است.

پارامترها

  • id

    رشته

    شناسه یکتای نمایشگر.

  • دلتا

    درج‌ها

    مقدار تغییر حاشیه‌های اسکن بیش‌ازاندازه.

overscanCalibrationComplete()

Chrome نسخه ۵۳ و بالاتر 
chrome.system.display.overscanCalibrationComplete(
  id: string,
): void

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. با ذخیره کردن مقادیر فعلی و پنهان کردن هم‌پوشانی، تنظیمات اسکن بیش‌ازحد را برای نمایشگر تکمیل کنید.

پارامترها

  • id

    رشته

    شناسه یکتای نمایشگر.

overscanCalibrationReset()

Chrome نسخه ۵۳ و بالاتر 
chrome.system.display.overscanCalibrationReset(
  id: string,
): void

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. حاشیه‌های داخلی بیش‌اسکن را برای نمایشگر به آخرین مقدار ذخیره‌شده (یعنی قبل‌از فراخوانی «شروع») بازنشانی می‌کند.

پارامترها

  • id

    رشته

    شناسه یکتای نمایشگر.

overscanCalibrationStart()

Chrome نسخه ۵۳ و بالاتر 
chrome.system.display.overscanCalibrationStart(
  id: string,
): void

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. واسنجی بیش‌اسکن را برای نمایشگر شروع می‌کند. با این کار، رونهادی روی صفحه نشان داده می‌شود که حاشیه‌های داخلی بیش‌اسکن فعلی را نشان می‌دهد. اگر واسنجی بیش‌اسکن برای نمایشگر id درحال انجام باشد، این کار واسنجی را بازنشانی می‌کند.

پارامترها

  • id

    رشته

    شناسه یکتای نمایشگر.

setDisplayLayout()

Promise Chrome 53+ 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. چیدمان را برای همه نمایشگرها تنظیم کنید. هر نمایشگری که اضافه نشده باشد از چیدمان پیش‌فرض استفاده خواهد کرد. اگر چیدمانی هم‌پوشانی داشته باشد یا به‌نحوی نامعتبر باشد، به چیدمانی معتبر تبدیل خواهد شد. پس‌از حل شدن چیدمان، رویداد onDisplayChanged راه‌اندازی خواهد شد.

پارامترها

  • چیدمان‌ها

    DisplayLayout[]

    اطلاعات چیدمان، برای همه نمایشگرها به‌جز نمایشگر اصلی الزامی است.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۹۱ به بالا

    Promise که وقتی تابع تمام می‌شود حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

setDisplayProperties()

قول 
chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
): Promise<void>

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. ویژگی‌های نمایشگر مشخص‌شده با id را براساس اطلاعات ارائه‌شده در info به‌روز می‌کند. درصورت ناموفق بودن، runtime.lastError تنظیم خواهد شد.

پارامترها

  • id

    رشته

    شناسه یکتای نمایشگر.

  • اطلاعات

    DisplayProperties

    اطلاعات مربوط به ویژگی‌های نمایش که باید تغییر کند. دارایی فقط درصورتی تغییر خواهد کرد که مقدار جدیدی برای آن در info مشخص شده باشد.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۹۱ به بالا

    Promise که وقتی تابع تمام می‌شود حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

setMirrorMode()

Promise Chrome نسخه ۶۵ و بالاتر 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. حالت نمایش را روی حالت قرینه مشخص‌شده تنظیم می‌کند. هر تماس وضعیت تماس‌های قبلی را بازنشانی می‌کند. فراخوانی()setDisplayProperties برای نمایشگرهای مقصد آینه‌سازی ناموفق خواهد بود.

پارامترها

  • اطلاعات

    MirrorModeInfo

    اطلاعات حالت آینه که باید در حالت نمایش اعمال شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۹۱ به بالا

    Promise که وقتی تابع تمام می‌شود حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

showNativeTouchCalibration()

Promise Chrome نسخه ۵۷ و بالاتر 
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. تجربه کاربری واسنجی لمسی بومی را برای نمایشگر با شناسه نمایشگر id نمایش می‌دهد. با این کار، هم‌پوشانی‌ای روی صفحه نشان داده می‌شود که حاوی دستورالعمل‌های لازم برای ادامه دادن است. فراخوانی برگشتی فقط درصورت واسنجی موفقیت‌آمیز فراخوانده خواهد شد. اگر هم‌سو کردن ناموفق باشد، این کار باعث ایجاد خطا می‌شود.

پارامترها

  • id

    رشته

    شناسه یکتای نمایشگر.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (success: boolean) => void

    • موفقیت‌آمیز

      بولی

بازگشتی‌ها

  • Promise<boolean>

    Chrome نسخه ۹۱ به بالا

    قولی که برای اطلاع دادن به تماس‌گیرنده درباره پایان واسنجی لمسی حل می‌شود. مقدار بولی نشان می‌دهد که واسنجی موفقیت‌آمیز بوده است یا نه.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

startCustomTouchCalibration()

Chrome نسخه ۵۷ و بالاتر 
chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

توجه: این ویژگی فقط برای برنامه‌های کیوسک ChromeOS دردسترس است. واسنجی لمسی سفارشی را برای نمایشگر شروع می‌کند. این مورد باید هنگام استفاده از UX سفارشی برای جمع‌آوری داده‌های واسنجی فراخوانی شود. اگر کالیبره کردن لمسی دیگری درحال انجام باشد، این کار باعث ایجاد خطا می‌شود.

پارامترها

  • id

    رشته

    شناسه یکتای نمایشگر.

رویدادها

onDisplayChanged

chrome.system.display.onDisplayChanged.addListener(
  callback: function,
)

وقتی هر چیزی در پیکربندی نمایشگر تغییر کند، فعال می‌شود.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    () => void