browser.system.display

Mô tả

Sử dụng API system.display để truy vấn siêu dữ liệu đang hiển thị.

Quyền

system.display

Loại

ActiveState

Chrome 117 trở lên browser.* kể từ Chrome 148

Một enum cho biết liệu màn hình có được hệ thống phát hiện và sử dụng hay không. Màn hình được coi là "không hoạt động" nếu hệ thống không phát hiện thấy màn hình (có thể đã ngắt kết nối hoặc được coi là đã ngắt kết nối do chế độ ngủ, v.v.). Ví dụ: trạng thái này được dùng để giữ màn hình hiện có khi tất cả màn hình đều bị ngắt kết nối.

Enum

"đang hoạt động"

"inactive"

Bounds

Thuộc tính

  • chiều cao

    số

    Chiều cao của màn hình tính bằng pixel.

  • trái

    số

    Toạ độ x của góc trên bên trái.

  • trên cùng

    số

    Toạ độ y của góc trên bên trái.

  • chiều rộng

    số

    Chiều rộng của màn hình tính bằng pixel.

DisplayLayout

Chrome 53 trở lên trình duyệt.* kể từ Chrome 148

Thuộc tính

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

  • độ lệch

    số

    Độ lệch của màn hình dọc theo cạnh được kết nối. 0 cho biết các góc trên cùng hoặc ngoài cùng bên trái được căn chỉnh.

  • parentId

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình mẹ. Để trống nếu đây là thư mục gốc.

  • position

    LayoutPosition

    Vị trí bố cục của màn hình này so với màn hình chính. Thao tác này sẽ bị bỏ qua đối với thư mục gốc.

DisplayMode

Trình duyệt Chrome 52 trở lên .* kể từ Chrome 148

Thuộc tính

  • deviceScaleFactor

    số

    Hệ số tỷ lệ thiết bị của chế độ hiển thị.

  • chiều cao

    số

    Chiều cao của chế độ hiển thị tính theo pixel không phụ thuộc vào thiết bị (người dùng nhìn thấy).

  • heightInNativePixels

    số

    Chiều cao của chế độ hiển thị tính bằng pixel gốc.

  • isInterlaced

    boolean không bắt buộc

    Chrome 74 trở lên trình duyệt.* kể từ Chrome 148

    Đúng nếu chế độ này được xen kẽ, sai nếu không được cung cấp.

  • isNative

    boolean

    Đúng nếu chế độ này là chế độ gốc của màn hình.

  • isSelected

    boolean

    Đúng nếu chế độ hiển thị hiện đang được chọn.

  • refreshRate

    số

    Chrome 67 trở lên browser.* kể từ Chrome 148

    Tốc độ làm mới của chế độ hiển thị tính bằng hertz.

  • uiScale

    number không bắt buộc

    Ngừng sử dụng kể từ Chrome 70

    Sử dụng displayZoomFactor

    Hệ số tỷ lệ giao diện người dùng của chế độ hiển thị.

  • chiều rộng

    số

    Chiều rộng của chế độ hiển thị tính theo pixel không phụ thuộc vào thiết bị (người dùng nhìn thấy).

  • widthInNativePixels

    số

    Chiều rộng của chế độ hiển thị tính theo pixel gốc.

DisplayProperties

Thuộc tính

  • boundsOriginX

    number không bắt buộc

    Nếu được đặt, thuộc tính này sẽ cập nhật gốc ranh giới logic của màn hình dọc theo trục x. Được áp dụng cùng với boundsOriginY. Mặc định là giá trị hiện tại nếu không được đặt và boundsOriginY được đặt. Xin lưu ý rằng khi cập nhật gốc hiển thị, một số quy tắc ràng buộc sẽ được áp dụng, vì vậy, gốc ranh giới cuối cùng có thể khác với gốc đã đặt. Bạn có thể truy xuất các giới hạn cuối cùng bằng getInfo. Không thể thay đổi gốc ranh giới trên màn hình chính.

  • boundsOriginY

    number không bắt buộc

    Nếu được đặt, hãy cập nhật gốc ranh giới logic của màn hình dọc theo trục y. Xem tài liệu về tham số boundsOriginX.

  • displayMode

    DisplayMode không bắt buộc

    Trình duyệt Chrome 52 trở lên .* kể từ Chrome 148

    Nếu được đặt, chế độ hiển thị sẽ được cập nhật thành chế độ khớp với giá trị này. Nếu các tham số khác không hợp lệ, thì tham số này sẽ không được áp dụng. Nếu chế độ hiển thị không hợp lệ, thì chế độ đó sẽ không được áp dụng và lỗi sẽ được đặt, nhưng các thuộc tính khác vẫn sẽ được áp dụng.

  • displayZoomFactor

    number không bắt buộc

    Chrome 65 trở lên trình duyệt.* kể từ Chrome 148

    Nếu được đặt, chính sách này sẽ cập nhật mức thu phóng liên kết với màn hình. Tính năng thu phóng này thực hiện bố cục lại và vẽ lại, do đó mang lại chất lượng thu phóng tốt hơn so với việc chỉ thực hiện phóng to từng pixel.

  • isPrimary

    boolean không bắt buộc

    Nếu bạn đặt thành true, thì màn hình sẽ trở thành màn hình chính. Không hoạt động nếu được đặt thành false. Lưu ý: Nếu được đặt, màn hình sẽ được coi là màn hình chính cho tất cả các thuộc tính khác (tức là isUnified có thể được đặt và gốc giới hạn có thể không được đặt).

  • isUnified

    boolean không bắt buộc

    Chrome 59 trở lên trình duyệt.* kể từ Chrome 148

    Chỉ dành cho ChromeOS. Nếu bạn đặt chính sách này thành true, thì chế độ hiển thị sẽ thay đổi thành màn hình hợp nhất (xem enableUnifiedDesktop để biết thông tin chi tiết). Nếu bạn đặt chính sách này thành false, thì chế độ màn hình hợp nhất sẽ bị tắt. Chế độ này chỉ áp dụng cho màn hình chính. Nếu bạn cung cấp, thì bạn không được cung cấp mirroringSourceId và các thuộc tính khác sẽ bị bỏ qua. Giá trị này không có hiệu lực nếu không được cung cấp.

  • mirroringSourceId

    chuỗi không bắt buộc

    Không dùng nữa kể từ Chrome 68

    Sử dụng setMirrorMode.

    Chỉ dành cho ChromeOS. Nếu bạn đặt và không để trống, thì chế độ này chỉ bật tính năng phản chiếu cho màn hình này. Nếu không, hãy tắt tính năng phản chiếu cho tất cả màn hình. Giá trị này phải cho biết mã nhận dạng của màn hình nguồn cần phản chiếu, mã này không được giống với mã nhận dạng được truyền đến setDisplayProperties. Nếu bạn đặt thuộc tính này, thì không được đặt thuộc tính nào khác.

  • quét quá mức

    Phần lồng ghép không bắt buộc

    Nếu được đặt, hãy đặt phần lề quét quá của màn hình thành các giá trị được cung cấp. Xin lưu ý rằng giá trị quét quá mức không được là số âm hoặc lớn hơn một nửa kích thước màn hình. Không thể thay đổi chế độ quét quá mức trên màn hình trong.

  • xoay vòng

    number không bắt buộc

    Nếu được đặt, chính sách này sẽ cập nhật chế độ xoay của màn hình. Các giá trị hợp lệ là [0, 90, 180, 270]. Góc xoay được đặt theo chiều kim đồng hồ, tương ứng với vị trí thẳng đứng của màn hình.

DisplayUnitInfo

Thuộc tính

  • activeState

    ActiveState

    Chrome 117 trở lên browser.* kể từ Chrome 148

    Đang hoạt động nếu hệ thống phát hiện và sử dụng màn hình.

  • availableDisplayZoomFactors

    number[]

    Chrome 67 trở lên browser.* kể từ Chrome 148

    Danh sách các giá trị hệ số thu phóng có thể đặt cho màn hình.

  • ranh giới

    Ranh giới

    Ranh giới logic của màn hình.

  • displayZoomFactor

    số

    Chrome 65 trở lên trình duyệt.* kể từ Chrome 148

    Tỷ lệ giữa mức thu phóng hiện tại và mặc định của màn hình. Ví dụ: giá trị 1 tương đương với mức thu phóng 100% và giá trị 1,5 tương đương với mức thu phóng 150%.

  • dpiX

    số

    Số pixel trên mỗi inch dọc theo trục x.

  • dpiY

    số

    Số pixel trên mỗi inch dọc theo trục y.

  • edid

    Edid không bắt buộc

    Chrome 67 trở lên browser.* kể từ Chrome 148

    LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS.

  • hasTouchSupport

    boolean

    Chrome 57 trở lên browser.* kể từ Chrome 148

    True nếu màn hình này có thiết bị nhập bằng cách chạm được liên kết với màn hình.

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

  • isEnabled

    boolean

    Đúng nếu màn hình này được bật.

  • isPrimary

    boolean

    Đúng nếu đây là màn hình chính.

  • isUnified

    boolean

    Chrome 59 trở lên trình duyệt.* kể từ Chrome 148

    Đúng cho tất cả màn hình khi ở chế độ màn hình hợp nhất. Xem tài liệu về enableUnifiedDesktop.

  • mirroringDestinationIds

    string[]

    Chrome 64 trở lên browser.* kể từ Chrome 148

    Chỉ dành cho ChromeOS. Giá trị nhận dạng của màn hình mà màn hình nguồn đang phản chiếu. Để trống nếu không có màn hình nào đang được phản chiếu. Giá trị này sẽ được đặt giống nhau cho tất cả màn hình. Thông tin này không được bao gồm mirroringSourceId.

  • mirroringSourceId

    chuỗi

    Chỉ dành cho ChromeOS. Giá trị nhận dạng của màn hình đang được phản chiếu nếu tính năng phản chiếu được bật, nếu không thì để trống. Chế độ này sẽ được đặt cho tất cả màn hình (bao gồm cả màn hình đang được phản chiếu).

  • chế độ

    DisplayMode[]

    Trình duyệt Chrome 52 trở lên .* kể từ Chrome 148

    Danh sách các chế độ hiển thị hiện có. Chế độ hiện tại sẽ có isSelected=true. Chỉ có trên ChromeOS. Sẽ được đặt thành một mảng trống trên các nền tảng khác.

  • tên

    chuỗi

    Tên thân thiện với người dùng (ví dụ: "Màn hình LCD HP").

  • quét quá mức

    Phần lồng ghép

    Phần lồng ghép của màn hình trong ranh giới của màn hình. Hiện chỉ hiển thị trên ChromeOS. Sẽ được đặt thành các phần lồng ghép trống trên các nền tảng khác.

  • xoay vòng

    số

    Góc xoay theo chiều kim đồng hồ của màn hình (tính bằng độ) so với vị trí thẳng đứng. Hiện chỉ hiển thị trên ChromeOS. Sẽ được đặt thành 0 trên các nền tảng khác. Giá trị -1 sẽ được hiểu là tự động xoay khi thiết bị ở trạng thái máy tính bảng thực tế.

  • workArea

    Ranh giới

    Vùng làm việc có thể sử dụng của màn hình trong ranh giới màn hình. Khu vực làm việc không bao gồm các khu vực của màn hình dành riêng cho hệ điều hành, ví dụ: thanh tác vụ và trình chạy.

Edid

Chrome 67 trở lên browser.* kể từ Chrome 148

Thuộc tính

  • manufacturerId

    chuỗi

    Mã nhà sản xuất gồm 3 ký tự. Xem Mục 3.4.1 trang 21. Bắt buộc trong phiên bản 1.4.

  • productId

    chuỗi

    Mã 2 byte do nhà sản xuất chỉ định, Mục 3.4.2 trang 21. Bắt buộc trong phiên bản 1.4.

  • yearOfManufacture

    số

    Năm sản xuất, Mục 3.4.4 trang 22. Bắt buộc trong phiên bản 1.4.

GetInfoFlags

Chrome 59 trở lên trình duyệt.* kể từ Chrome 148

Thuộc tính

  • singleUnified

    boolean không bắt buộc

    Nếu bạn đặt thành true, thì getInfo sẽ chỉ trả về một DisplayUnitInfo khi ở chế độ màn hình hợp nhất (xem enableUnifiedDesktop). Giá trị mặc định là false.

Insets

Thuộc tính

  • dưới cùng

    số

    Khoảng cách trục y từ ranh giới dưới cùng.

  • trái

    số

    Khoảng cách trục x từ ranh giới bên trái.

  • phải

    số

    Khoảng cách trục x từ ranh giới bên phải.

  • trên cùng

    số

    Khoảng cách theo trục y từ ranh giới trên cùng.

LayoutPosition

Chrome 53 trở lên trình duyệt.* kể từ Chrome 148

Vị trí bố cục, tức là cạnh của thành phần mẹ mà màn hình được gắn vào.

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65 trở lên trình duyệt.* kể từ Chrome 148

Chế độ phản chiếu, tức là các cách khác nhau để phản chiếu một màn hình sang các màn hình khác.

Enum

"off"
Chỉ định chế độ mặc định (màn hình mở rộng hoặc màn hình hợp nhất).

"normal"
Chỉ định rằng màn hình nguồn mặc định sẽ được phản chiếu cho tất cả các màn hình khác.

"mixed"
Chỉ định rằng màn hình nguồn được chỉ định sẽ được phản chiếu tới các màn hình đích được cung cấp. Tất cả các màn hình khác được kết nối sẽ được mở rộng.

MirrorModeInfo

Chrome 65 trở lên trình duyệt.* kể từ Chrome 148

Thuộc tính

  • mirroringDestinationIds

    string[] không bắt buộc

    Mã nhận dạng của màn hình đích phản chiếu. Giá trị này chỉ hợp lệ cho "mixed".

  • mirroringSourceId

    chuỗi không bắt buộc

    Mã nhận dạng của màn hình nguồn phản chiếu. Giá trị này chỉ hợp lệ cho "hỗn hợp".

  • chế độ

    MirrorMode

    Chế độ phản chiếu cần đặt.

Point

Chrome 57 trở lên browser.* kể từ Chrome 148

Thuộc tính

  • x

    số

    Toạ độ x của điểm.

  • năm

    số

    Toạ độ y của điểm.

TouchCalibrationPair

Chrome 57 trở lên browser.* kể từ Chrome 148

Thuộc tính

  • displayPoint

    Điểm

    Toạ độ của điểm hiển thị.

  • touchPoint

    Point

    Toạ độ của điểm chạm tương ứng với điểm hiển thị.

TouchCalibrationPairQuad

Chrome 57 trở lên browser.* kể từ Chrome 148

Thuộc tính

  • Cần có cặp điểm chạm và điểm hiển thị đầu tiên để hiệu chỉnh cảm ứng.

  • Cần có cặp điểm chạm và điểm hiển thị thứ hai để hiệu chỉnh cảm ứng.

  • Cần có cặp điểm chạm và điểm hiển thị thứ ba để hiệu chỉnh cảm ứng.

  • Cần có cặp điểm chạm và điểm hiển thị thứ tư để hiệu chỉnh thao tác chạm.

Phương thức

clearTouchCalibration()

Chrome 57 trở lên browser.* kể từ Chrome 148 
browser.system.display.clearTouchCalibration(
  id: string,
): void

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Đặt lại chế độ hiệu chỉnh cảm ứng cho màn hình và đưa màn hình về trạng thái mặc định bằng cách xoá mọi dữ liệu hiệu chỉnh cảm ứng liên quan đến màn hình.

Thông số

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

completeCustomTouchCalibration()

Chrome 57 trở lên browser.* kể từ Chrome 148 
browser.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Đặt các cặp hiệu chỉnh cảm ứng cho màn hình. pairs này sẽ được dùng để hiệu chỉnh màn hình cảm ứng cho màn hình có id được gọi trong startCustomTouchCalibration(). Luôn gọi startCustomTouchCalibration trước khi gọi phương thức này. Nếu một quá trình hiệu chỉnh cảm ứng khác đang diễn ra, thì thao tác này sẽ báo lỗi.

Thông số

  • Các cặp điểm dùng để hiệu chỉnh màn hình.

  • ranh giới

    Ranh giới

    Ranh giới của màn hình khi thực hiện hiệu chỉnh cảm ứng. Các giá trị bounds.left và bounds.top sẽ bị bỏ qua.

enableUnifiedDesktop()

Chrome 46 trở lên browser.* kể từ Chrome 148 
browser.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Bật/tắt tính năng màn hình hợp nhất. Nếu được bật trong khi chế độ phản chiếu đang hoạt động, thì chế độ máy tính sẽ không thay đổi cho đến khi chế độ phản chiếu tắt. Nếu không, chế độ máy tính sẽ chuyển sang chế độ hợp nhất ngay lập tức.

Thông số

  • đang bật

    boolean

    Đúng nếu bạn muốn bật chế độ máy tính hợp nhất.

getDisplayLayout()

Chrome 53 trở lên trình duyệt.* kể từ Chrome 148 
browser.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Yêu cầu thông tin bố cục cho tất cả màn hình.

Giá trị trả về

  • Promise<DisplayLayout[]>

    Chrome 91 trở lên browser.* kể từ Chrome 148

    Lời hứa sẽ giải quyết bằng kết quả.

getInfo()

browser.system.display.getInfo(
  flags?: GetInfoFlags,
): Promise<DisplayUnitInfo[]>

Yêu cầu thông tin cho tất cả thiết bị hiển thị được kết nối.

Thông số

  • flags

    GetInfoFlags không bắt buộc

    Chrome 59 trở lên trình duyệt.* kể từ Chrome 148

    Các lựa chọn ảnh hưởng đến cách trả về thông tin.

Giá trị trả về

  • Promise<DisplayUnitInfo[]>

    Chrome 91 trở lên browser.* kể từ Chrome 148

    Lời hứa sẽ giải quyết bằng kết quả.

overscanCalibrationAdjust()

Chrome 53 trở lên trình duyệt.* kể từ Chrome 148 
browser.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Điều chỉnh các phần lề quét quá hiện tại cho màn hình. Thông thường, thao tác này sẽ di chuyển màn hình dọc theo một trục (ví dụ: trái+phải có cùng giá trị) hoặc điều chỉnh tỷ lệ dọc theo một trục (ví dụ: trên+dưới có giá trị ngược nhau). Mỗi lệnh gọi Điều chỉnh sẽ tích luỹ với các lệnh gọi trước đó kể từ khi Bắt đầu.

Thông số

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

  • Mức thay đổi phần lề quét quá.

overscanCalibrationComplete()

Chrome 53 trở lên trình duyệt.* kể từ Chrome 148 
browser.system.display.overscanCalibrationComplete(
  id: string,
): void

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Hoàn tất việc điều chỉnh quét quá mức cho màn hình bằng cách lưu các giá trị hiện tại và ẩn lớp phủ.

Thông số

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

overscanCalibrationReset()

Chrome 53 trở lên trình duyệt.* kể từ Chrome 148 
browser.system.display.overscanCalibrationReset(
  id: string,
): void

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Đặt lại các phần lồng ghép quét quá mức cho màn hình về giá trị được lưu gần đây nhất (tức là trước khi Start được gọi).

Thông số

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

overscanCalibrationStart()

Chrome 53 trở lên trình duyệt.* kể từ Chrome 148 
browser.system.display.overscanCalibrationStart(
  id: string,
): void

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Bắt đầu hiệu chỉnh quét quá mức cho màn hình. Thao tác này sẽ hiển thị một lớp phủ trên màn hình cho biết các phần lồng ghép quét quá mức hiện tại. Nếu quá trình hiệu chỉnh quét quá mức cho màn hình id đang diễn ra, thì thao tác này sẽ đặt lại quá trình hiệu chỉnh.

Thông số

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

setDisplayLayout()

Chrome 53 trở lên trình duyệt.* kể từ Chrome 148 
browser.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Đặt bố cục cho tất cả màn hình. Mọi màn hình không có trong danh sách sẽ sử dụng bố cục mặc định. Nếu một bố cục bị chồng chéo hoặc không hợp lệ, thì bố cục đó sẽ được điều chỉnh thành bố cục hợp lệ. Sau khi bố cục được giải quyết, sự kiện onDisplayChanged sẽ được kích hoạt.

Thông số

  • bố cục

    DisplayLayout[]

    Thông tin bố cục, bắt buộc đối với tất cả màn hình ngoại trừ màn hình chính.

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên browser.* kể từ Chrome 148

    Lời hứa sẽ được thực hiện khi hàm kết thúc.

setDisplayProperties()

browser.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
): Promise<void>

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Cập nhật các thuộc tính cho màn hình do id chỉ định, theo thông tin được cung cấp trong info. Nếu không thành công, runtime.lastError sẽ được đặt.

Thông số

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

  • Thông tin về các thuộc tính hiển thị cần thay đổi. Một thuộc tính sẽ chỉ được thay đổi nếu giá trị mới của thuộc tính đó được chỉ định trong info.

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên browser.* kể từ Chrome 148

    Lời hứa sẽ được thực hiện khi hàm kết thúc.

setMirrorMode()

Chrome 65 trở lên trình duyệt.* kể từ Chrome 148 
browser.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Đặt chế độ hiển thị thành chế độ phản chiếu được chỉ định. Mỗi lệnh gọi sẽ đặt lại trạng thái của các lệnh gọi trước đó. Việc gọi setDisplayProperties() sẽ không thành công đối với màn hình đích phản chiếu.

Thông số

  • Thông tin về chế độ phản chiếu cần được áp dụng cho chế độ hiển thị.

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên browser.* kể từ Chrome 148

    Lời hứa sẽ được thực hiện khi hàm kết thúc.

showNativeTouchCalibration()

Chrome 57 trở lên browser.* kể từ Chrome 148 
browser.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Hiển thị UX hiệu chỉnh cảm ứng gốc cho màn hình có id làm mã nhận dạng màn hình. Thao tác này sẽ hiển thị một lớp phủ trên màn hình kèm theo hướng dẫn cần thiết về cách tiếp tục. Lệnh gọi lại sẽ chỉ được gọi trong trường hợp hiệu chỉnh thành công. Nếu quá trình hiệu chỉnh không thành công, thì thao tác này sẽ báo lỗi.

Thông số

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

Giá trị trả về

  • Promise<boolean>

    Chrome 91 trở lên browser.* kể từ Chrome 148

    Lời hứa sẽ giải quyết để thông báo cho người gọi rằng quá trình hiệu chỉnh cảm ứng đã kết thúc. Giá trị boolean cho biết liệu quá trình hiệu chỉnh có thành công hay không.

startCustomTouchCalibration()

Chrome 57 trở lên browser.* kể từ Chrome 148 
browser.system.display.startCustomTouchCalibration(
  id: string,
): void

LƯU Ý: Tính năng này chỉ dành cho các ứng dụng Kiosk trên ChromeOS. Bắt đầu hiệu chỉnh thao tác chạm tuỳ chỉnh cho màn hình. Bạn nên gọi phương thức này khi sử dụng trải nghiệm người dùng tuỳ chỉnh để thu thập dữ liệu hiệu chỉnh. Nếu một quá trình hiệu chỉnh cảm ứng khác đang diễn ra, thì thao tác này sẽ báo lỗi.

Thông số

  • id

    chuỗi

    Giá trị nhận dạng riêng biệt của màn hình.

Sự kiện

onDisplayChanged

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

Được kích hoạt khi có bất kỳ thay đổi nào đối với cấu hình hiển thị.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    () => void