chrome.system.display

شرح

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

مجوزها

system.display

انواع

ActiveState

Chrome 117+

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

Enum

"فعال"

"غیر فعال"

Bounds

خواص

  • ارتفاع

    عدد

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

  • ترک کرد

    عدد

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

  • بالا

    عدد

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

  • عرض

    عدد

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

DisplayLayout

Chrome 53+

خواص

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر.

  • انحراف

    عدد

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

  • شناسه اصلی

    رشته

    شناسه منحصر به فرد نمایشگر والد. اگر این ریشه است خالی کنید.

  • موقعیت

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

DisplayMode

Chrome 52+

خواص

  • deviceScaleFactor

    عدد

    عامل مقیاس دستگاه حالت نمایش.

  • ارتفاع

    عدد

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

  • heightInNativePixels

    عدد

    ارتفاع حالت نمایش در پیکسل های بومی

  • درهم آمیخته است

    بولی اختیاری

    Chrome 74+

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

  • بومی است

    بولی

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

  • انتخاب شده است

    بولی

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

  • نرخ تجدید

    عدد

    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").

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

  • چرخش

    عدد

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

  • منطقه کاری

    ناحیه کاری قابل استفاده نمایشگر در محدوده نمایشگر. منطقه کاری شامل بخش هایی از صفحه نمایش است که برای سیستم عامل اختصاص داده شده است، به عنوان مثال نوار وظیفه و راه اندازی.

Edid

Chrome 67+

خواص

  • شناسه سازنده

    رشته

    کد سازنده 3 کاراکتری رجوع کنید به بخش 3.4.1 صفحه 21. مورد نیاز در v1.4.

  • شناسه محصول

    رشته

    2 بایت کد اختصاص داده شده توسط سازنده، Sec. 3.4.2 صفحه 21. مورد نیاز در v1.4.

  • سال تولید

    عدد

    سال سازنده، Sec. 3.4.4 صفحه 22. مورد نیاز در v1.4.

GetInfoFlags

Chrome 59+

خواص

  • singleUnified

    بولی اختیاری

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

Insets

خواص

  • پایین

    عدد

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

  • ترک کرد

    عدد

    فاصله محور x از کران سمت چپ.

  • درست

    عدد

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

  • بالا

    عدد

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

LayoutPosition

Chrome 53+

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

Enum

"بالا"

"درست"

"پایین"

"ترک کرد"

MirrorMode

Chrome 65+

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

Enum

"خاموش"
حالت پیش فرض (دسکتاپ توسعه یافته یا یکپارچه) را مشخص می کند.

"طبیعی"
مشخص می کند که صفحه نمایش منبع پیش فرض به همه نمایشگرهای دیگر منعکس شود.

"مخلوط"
مشخص می کند که صفحه نمایش منبع مشخص شده به نمایشگرهای مقصد ارائه شده منعکس شود. همه نمایشگرهای متصل دیگر گسترش خواهند یافت.

MirrorModeInfo

Chrome 65+

خواص

  • mirroringDestinationIds

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

    شناسه مقصد آینه‌ای نمایش داده می‌شود. این فقط برای "مخلوط" معتبر است.

  • mirroringSourceId

    رشته اختیاری

    شناسه نمایش منبع آینه. این فقط برای "مخلوط" معتبر است.

  • حالت

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

Point

Chrome 57+

خواص

  • ایکس

    عدد

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

  • y

    عدد

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

TouchCalibrationPair

Chrome 57+

خواص

  • displayPoint

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

  • نقطه تماس

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

TouchCalibrationPairQuad

Chrome 57+

خواص

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

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

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

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

مواد و روش ها

clearTouchCalibration()

Chrome 57+
chrome.system.display.clearTouchCalibration(
  id: string,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

completeCustomTouchCalibration()

Chrome 57+
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
)

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

مولفه های

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

  • محدوده

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

enableUnifiedDesktop()

Chrome 46+
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

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

مولفه های

  • فعال شد

    بولی

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

getDisplayLayout()

Promise Chrome 53+
chrome.system.display.getDisplayLayout(
  callback?: function,
)

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

مولفه های

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    (layouts: DisplayLayout[])=>void

برمی گرداند

  • Promise< DisplayLayout []>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

getInfo()

وعده
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

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

مولفه های

  • پرچم ها

    GetInfoFlags اختیاری است

    Chrome 59+

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

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    (displayInfo: DisplayUnitInfo[])=>void

برمی گرداند

  • Promise< DisplayUnitInfo []>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

overscanCalibrationAdjust()

Chrome 53+
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

  • دلتا

    مقدار برای تغییر درج های overscan.

overscanCalibrationComplete()

Chrome 53+
chrome.system.display.overscanCalibrationComplete(
  id: string,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

overscanCalibrationReset()

Chrome 53+
chrome.system.display.overscanCalibrationReset(
  id: string,
)

ورودی های اسکن بیش از حد نمایشگر را به آخرین مقدار ذخیره شده (یعنی قبل از فراخوانی Start) بازنشانی می کند.

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

overscanCalibrationStart()

Chrome 53+
chrome.system.display.overscanCalibrationStart(
  id: string,
)

کالیبراسیون اسکن بیش از حد برای نمایشگر را شروع می کند. این یک پوشش روی صفحه نمایش نشان می دهد که درج های اسکن فعلی را نشان می دهد. اگر کالیبراسیون اسکن بیش از حد برای id نمایشگر در حال انجام باشد، کالیبراسیون مجدداً تنظیم می شود.

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

setDisplayLayout()

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

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

مولفه های

  • طرح بندی ها

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

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به 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 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

setMirrorMode()

Promise Chrome 65+
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

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

مولفه های

  • اطلاعات

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

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

showNativeTouchCalibration()

Promise Chrome 57+
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    (success: boolean)=>void

    • موفقیت

      بولی

برمی گرداند

  • وعده<boolean>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

startCustomTouchCalibration()

Chrome 57+
chrome.system.display.startCustomTouchCalibration(
  id: string,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

مناسبت ها

onDisplayChanged

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

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

مولفه های

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد:

    ()=>void

،

شرح

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

مجوزها

system.display

انواع

ActiveState

Chrome 117+

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

Enum

"فعال"

"غیر فعال"

Bounds

خواص

  • ارتفاع

    عدد

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

  • ترک کرد

    عدد

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

  • بالا

    عدد

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

  • عرض

    عدد

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

DisplayLayout

Chrome 53+

خواص

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر.

  • انحراف

    عدد

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

  • شناسه اصلی

    رشته

    شناسه منحصر به فرد نمایشگر والد. اگر این ریشه است خالی کنید.

  • موقعیت

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

DisplayMode

Chrome 52+

خواص

  • deviceScaleFactor

    عدد

    عامل مقیاس دستگاه حالت نمایش.

  • ارتفاع

    عدد

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

  • heightInNativePixels

    عدد

    ارتفاع حالت نمایش در پیکسل های بومی

  • درهم آمیخته است

    بولی اختیاری

    Chrome 74+

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

  • بومی است

    بولی

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

  • انتخاب شده است

    بولی

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

  • نرخ تجدید

    عدد

    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").

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

  • چرخش

    عدد

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

  • منطقه کاری

    ناحیه کاری قابل استفاده نمایشگر در محدوده نمایشگر. منطقه کاری شامل بخش هایی از صفحه نمایش است که برای سیستم عامل اختصاص داده شده است، به عنوان مثال نوار وظیفه و راه اندازی.

Edid

Chrome 67+

خواص

  • شناسه سازنده

    رشته

    کد سازنده 3 کاراکتری رجوع کنید به بخش 3.4.1 صفحه 21. مورد نیاز در v1.4.

  • شناسه محصول

    رشته

    2 بایت کد اختصاص داده شده توسط سازنده، Sec. 3.4.2 صفحه 21. مورد نیاز در v1.4.

  • سال تولید

    عدد

    سال سازنده، Sec. 3.4.4 صفحه 22. مورد نیاز در v1.4.

GetInfoFlags

Chrome 59+

خواص

  • singleUnified

    بولی اختیاری

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

Insets

خواص

  • پایین

    عدد

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

  • ترک کرد

    عدد

    فاصله محور x از کران سمت چپ.

  • درست

    عدد

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

  • بالا

    عدد

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

LayoutPosition

Chrome 53+

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

Enum

"بالا"

"درست"

"پایین"

"ترک کرد"

MirrorMode

Chrome 65+

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

Enum

"خاموش"
حالت پیش فرض (دسکتاپ توسعه یافته یا یکپارچه) را مشخص می کند.

"طبیعی"
مشخص می کند که صفحه نمایش منبع پیش فرض به همه نمایشگرهای دیگر منعکس شود.

"مخلوط"
مشخص می کند که صفحه نمایش منبع مشخص شده به نمایشگرهای مقصد ارائه شده منعکس شود. همه نمایشگرهای متصل دیگر گسترش خواهند یافت.

MirrorModeInfo

Chrome 65+

خواص

  • mirroringDestinationIds

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

    شناسه مقصد آینه‌ای نمایش داده می‌شود. این فقط برای "مخلوط" معتبر است.

  • mirroringSourceId

    رشته اختیاری

    شناسه نمایش منبع آینه. این فقط برای "مخلوط" معتبر است.

  • حالت

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

Point

Chrome 57+

خواص

  • ایکس

    عدد

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

  • y

    عدد

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

TouchCalibrationPair

Chrome 57+

خواص

  • displayPoint

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

  • نقطه تماس

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

TouchCalibrationPairQuad

Chrome 57+

خواص

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

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

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

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

مواد و روش ها

clearTouchCalibration()

Chrome 57+
chrome.system.display.clearTouchCalibration(
  id: string,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

completeCustomTouchCalibration()

Chrome 57+
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
)

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

مولفه های

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

  • محدوده

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

enableUnifiedDesktop()

Chrome 46+
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

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

مولفه های

  • فعال شد

    بولی

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

getDisplayLayout()

Promise Chrome 53+
chrome.system.display.getDisplayLayout(
  callback?: function,
)

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

مولفه های

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    (layouts: DisplayLayout[])=>void

برمی گرداند

  • Promise< DisplayLayout []>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

getInfo()

وعده
chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

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

مولفه های

  • پرچم ها

    GetInfoFlags اختیاری است

    Chrome 59+

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

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    (displayInfo: DisplayUnitInfo[])=>void

برمی گرداند

  • Promise< DisplayUnitInfo []>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

overscanCalibrationAdjust()

Chrome 53+
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

  • دلتا

    مقدار برای تغییر درج های overscan.

overscanCalibrationComplete()

Chrome 53+
chrome.system.display.overscanCalibrationComplete(
  id: string,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

overscanCalibrationReset()

Chrome 53+
chrome.system.display.overscanCalibrationReset(
  id: string,
)

ورودی های اسکن بیش از حد نمایشگر را به آخرین مقدار ذخیره شده (یعنی قبل از فراخوانی Start) بازنشانی می کند.

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

overscanCalibrationStart()

Chrome 53+
chrome.system.display.overscanCalibrationStart(
  id: string,
)

کالیبراسیون اسکن بیش از حد برای نمایشگر را شروع می کند. این یک پوشش روی صفحه نمایش نشان می دهد که درج های اسکن فعلی را نشان می دهد. اگر کالیبراسیون اسکن بیش از حد برای id نمایشگر در حال انجام است، کالیبراسیون مجدداً تنظیم می شود.

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

setDisplayLayout()

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

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

مولفه های

  • طرح بندی ها

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

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به 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 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

setMirrorMode()

Promise Chrome 65+
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

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

مولفه های

  • اطلاعات

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

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

showNativeTouchCalibration()

Promise Chrome 57+
chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد:

    (success: boolean)=>void

    • موفقیت

      بولی

برمی گرداند

  • وعده<boolean>

    Chrome 91+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

startCustomTouchCalibration()

Chrome 57+
chrome.system.display.startCustomTouchCalibration(
  id: string,
)

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

مولفه های

  • شناسه

    رشته

    شناسه منحصر به فرد نمایشگر

مناسبت ها

onDisplayChanged

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

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

مولفه های

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد:

    ()=>void