chrome.system.display

설명

system.display API를 사용하여 디스플레이 메타데이터를 쿼리합니다.

권한

system.display

유형

ActiveState

Chrome 117 이상

디스플레이가 시스템에서 감지되고 사용되는지 알려주는 enum입니다. 디스플레이가 시스템에서 감지되지 않는 경우 (연결 해제되거나 절전 모드로 인해 연결이 해제된 것으로 간주) 디스플레이가 '비활성'으로 간주됩니다. 이 상태는 모든 디스플레이가 연결 해제되었을 때 기존 디스플레이를 유지하는 데 사용됩니다.

열거형

Bounds

속성

• 키

  숫자

  디스플레이 높이(픽셀)입니다.

• 왼쪽

  숫자

  왼쪽 상단의 x 좌표입니다.

• 상단

  숫자

  왼쪽 상단 모서리의 y 좌표입니다.

• 너비

  숫자

  디스플레이 너비(픽셀)입니다.

DisplayLayout

Chrome 53 이상

속성

• id

  string

  디스플레이의 고유 식별자입니다.

• 오프셋

  숫자

  연결된 가장자리를 따라 표시된 디스플레이의 오프셋입니다. 0은 맨 위 또는 왼쪽 모서리가 정렬됨을 나타냅니다.

• parentId

  string

  상위 디스플레이의 고유 식별자입니다. 루트인 경우 비어 있습니다.

• position

  LayoutPosition

  상위 요소를 기준으로 한 이 디스플레이의 레이아웃 위치입니다. 루트에서는 무시됩니다.

DisplayMode

Chrome 52 이상

속성

• deviceScaleFactor

  숫자

  디스플레이 모드 기기 배율입니다.

• 키

  숫자

  기기 독립적 (사용자 표시) 픽셀 단위의 디스플레이 모드 높이입니다.

• heightInNativePixels

  숫자

  디스플레이 모드 높이(기본 픽셀)입니다.

• isInterlaced

  부울 선택사항

  Chrome 74 이상

  모드가 인터레이스된 경우 true, 제공되지 않으면 false입니다.

• isNative

  boolean

  모드가 디스플레이의 네이티브 모드인 경우 참입니다.

• isSelected

  boolean

  현재 디스플레이 모드가 선택되어 있으면 true입니다.

• refreshRate

  숫자

  Chrome 67 이상

  디스플레이 모드 화면 재생 빈도(Hz)입니다.

• uiScale

  number 선택사항

  Chrome 70부터 지원 중단됨

  displayZoomFactor 사용

  디스플레이 모드 UI 배율입니다.

• 너비

  숫자

  기기 독립적 (사용자에게 표시되는) 픽셀 단위의 디스플레이 모드 너비입니다.

• widthInNativePixels

  숫자

  디스플레이 모드 너비(네이티브 픽셀)입니다.

DisplayProperties

속성

• boundsOriginX

  number 선택사항

  설정된 경우 x축을 따라 디스플레이의 논리적 경계 원점을 업데이트합니다. boundsOriginY와 함께 적용됩니다. 설정하지 않고 boundsOriginY를 설정한 경우 기본값은 현재 값입니다. 디스플레이 원점을 업데이트할 때 일부 제약 조건이 적용되므로 최종 경계 원점이 세트 원점과 다를 수 있습니다. 최종 경계는 getInfo를 사용하여 가져올 수 있습니다. 기본 디스플레이에서는 경계 출처를 변경할 수 없습니다.

• boundsOriginY

  number 선택사항

  설정된 경우 y축을 따라 디스플레이의 논리적 경계 원점을 업데이트합니다. boundsOriginX 매개변수에 관한 문서를 참고하세요.

• displayMode

  DisplayMode 선택사항

  Chrome 52 이상

  설정하면 디스플레이 모드가 이 값과 일치하는 모드로 업데이트됩니다. 다른 매개변수가 잘못된 경우 적용되지 않습니다. 표시 모드가 유효하지 않으면 적용되지 않고 오류가 설정되지만 다른 속성은 계속 적용됩니다.

• displayZoomFactor

  number 선택사항

  Chrome 65 이상

  설정된 경우 디스플레이와 연결된 확대/축소를 업데이트합니다. 이 확대/축소는 레이아웃 재배치와 다시 페인트를 수행하므로 단순히 픽셀 단위 확대를 수행하는 것보다 더 나은 확대/축소 품질을 제공합니다.

• isPrimary

  부울 선택사항

  true로 설정하면 디스플레이를 기본으로 설정합니다. false로 설정된 경우 작동하지 않습니다. 참고: 설정되면 다른 모든 속성의 디스플레이가 기본으로 간주됩니다 (즉, isUnified는 설정될 수 있고 경계 원점은 설정되지 않을 수 있음).

• isUnified

  부울 선택사항

  Chrome 59 이상

  Chrome OS만 해당됩니다. true로 설정하면 디스플레이 모드가 통합 바탕화면으로 변경됩니다 (자세한 내용은 enableUnifiedDesktop 참고). false로 설정하면 통합 데스크톱 모드가 사용 중지됩니다. 이는 기본 디스플레이에만 유효합니다. 제공되는 경우MirrorSourceId를 제공하면 안 되며 다른 속성은 무시됩니다. 입력하지 않으면 아무 효과가 없습니다.

• mirroringSourceId

  문자열 선택사항

  Chrome 68부터 지원 중단됨

  setMirrorMode를 사용합니다.

  Chrome OS만 해당됩니다. 비어 있지 않은 경우 이 디스플레이에서만 미러링을 사용 설정합니다. 그 외의 경우에는 모든 디스플레이에서 미러링이 사용 중지됩니다. 이 값은 미러링할 소스 디스플레이의 ID를 나타내야 하며 setDisplayProperties에 전달된 ID와 같아서는 안 됩니다. 이 속성을 설정하면 다른 속성을 설정할 수 없습니다.

• 오버스캔

  인셋 선택사항

  이 매개변수를 설정하면 디스플레이의 오버스캔 인셋을 제공된 값으로 설정합니다. 오버스캔 값은 음수이거나 화면 크기의 절반보다 클 수 없습니다. 내부 모니터에서는 오버스캔을 변경할 수 없습니다.

• 순환게재

  number 선택사항

  이 매개변수를 설정하면 디스플레이 회전이 업데이트됩니다. 유효한 값은 [0, 90, 180, 270]입니다. 회전은 디스플레이의 수직 위치를 기준으로 시계 방향으로 설정됩니다.

DisplayUnitInfo

속성

• activeState

  ActiveState

  Chrome 117 이상

  시스템에서 디스플레이를 감지하여 사용하는 경우 활성화됩니다.

• availableDisplayZoomFactors

  숫자[]

  Chrome 67 이상

  디스플레이에 설정할 수 있는 확대/축소 인수 값의 목록입니다.

• bounds

  경계

  디스플레이의 논리적 경계입니다.

• displayZoomFactor

  숫자

  Chrome 65 이상

  디스플레이의 현재 확대/축소와 기본 확대/축소 간의 비율입니다. 예를 들어 값 1은 100% 확대/축소와 같고 값 1.5는 150% 확대/축소와 같습니다.

• dpiX

  숫자

  x축의 인치당 픽셀 수입니다.

• dpiY

  숫자

  y축의 인치당 픽셀 수입니다.

• Edid

  Edid 선택사항

  Chrome 67 이상

  참고: 이 기능은 Chrome OS 키오스크 앱 및 웹 UI에서만 사용할 수 있습니다.

• hasTouchSupport

  boolean

  Chrome 57 이상

  이 디스플레이에 연결된 터치 입력 기기가 있는 경우 true입니다.

• id

  string

  디스플레이의 고유 식별자입니다.

• isEnabled

  boolean

  이 디스플레이가 사용 설정되어 있으면 true입니다.

• isPrimary

  boolean

  기본 디스플레이이면 true입니다.

• isUnified

  boolean

  Chrome 59 이상

  통합 데스크톱 모드의 모든 디스플레이에서 true입니다. enableUnifiedDesktop 문서를 참고하세요.

• mirroringDestinationIds

  문자열[]

  Chrome 64 이상

  Chrome OS만 해당됩니다. 소스 디스플레이가 미러링되고 있는 디스플레이의 식별자입니다. 미러링되는 디스플레이가 없는 경우 비어 있습니다. 모든 디스플레이에서 동일한 값으로 설정됩니다. 여기에는 mirroringSourceId가 포함되면 안 됩니다.

• mirroringSourceId

  string

  Chrome OS만 해당됩니다. 미러링이 사용 설정된 경우 미러링되는 디스플레이의 식별자로, 그렇지 않은 경우에는 비어 있습니다. 모든 디스플레이 (미러링 중인 디스플레이 포함)에 설정됩니다.

• modes

  DisplayMode[]

  Chrome 52 이상

  사용 가능한 표시 모드 목록입니다. 현재 모드에는 isSelected=true가 포함됩니다. Chrome OS에서만 사용할 수 있습니다. 다른 플랫폼에서는 빈 배열로 설정됩니다.

• 이름

  string

  사용자 친화적인 이름입니다 (예: 'HP LCD 모니터').

• 오버스캔

  인셋

  화면 경계 내에 있는 디스플레이의 인셋. 현재 ChromeOS에서만 노출됩니다. 다른 플랫폼에서 빈 인셋으로 설정됩니다.

• 순환게재

  숫자

  세로 위치를 기준으로 한 디스플레이의 시계 방향 회전 각도입니다. 현재 ChromeOS에서만 노출됩니다. 다른 플랫폼에서는 0으로 설정됩니다. 값이 -1이면 기기가 실제 태블릿 상태에 있을 때 자동 회전으로 해석됩니다.

• workArea

  경계

  디스플레이 경계 내에 있는 디스플레이의 사용 가능한 작업 영역입니다. 작업 영역은 OS용으로 예약된 디스플레이 영역(예: 작업 표시줄, 런처)을 제외합니다.

Edid

Chrome 67 이상

속성

• manufacturerId

  string

  3자리 제조업체 코드입니다. 섹션 3.4.1 21페이지를 참조하세요. v1.4에서는 필수입니다.

• productId

  string

  2바이트 제조업체 할당 코드, 섹션 3.4.2 21페이지. v1.4에서는 필수입니다.

• yearOfManufacture

  숫자

  제조업체 연도, 섹션 3.4.4 22페이지. v1.4에서는 필수입니다.

GetInfoFlags

Chrome 59 이상

속성

• singleUnified

  부울 선택사항

  true로 설정하면 통합 데스크톱 모드 (enableUnifiedDesktop 참고)일 때 getInfo에서 단일 DisplayUnitInfo만 반환합니다. 기본값은 false입니다.

Insets

속성

• 하단

  숫자

  하단 경계로부터의 y축 거리입니다.

• 왼쪽

  숫자

  왼쪽 경계로부터 x축 거리입니다.

• 오른쪽

  숫자

  오른쪽 경계로부터의 x축 거리입니다.

• 상단

  숫자

  상단 경계로부터의 y축 거리입니다.

LayoutPosition

Chrome 53 이상

레이아웃 위치(디스플레이가 연결된 상위 요소의 가장자리)

열거형

MirrorMode

Chrome 65 이상

미러링 모드, 즉 디스플레이가 다른 디스플레이에 미러링되는 다양한 방식입니다.

열거형

"off"
기본 모드 (확장 또는 통합 데스크톱)를 지정합니다.

"normal"
기본 소스 디스플레이가 다른 모든 디스플레이에 미러링되도록 지정합니다.

"mixed"
지정된 소스 디스플레이가 제공된 대상 디스플레이에 미러링되도록 지정합니다. 다른 모든 연결된 디스플레이는 연장됩니다.

MirrorModeInfo

Chrome 65 이상

속성

• mirroringDestinationIds

  string[] 선택사항

  미러링 대상의 ID가 표시됩니다. '혼합'의 경우에만 유효합니다.

• mirroringSourceId

  문자열 선택사항

  미러링 소스 디스플레이의 ID입니다. '혼합'의 경우에만 유효합니다.

• 모드

  MirrorMode

  설정해야 하는 미러링 모드입니다.

Point

Chrome 57 이상

속성

• x

  숫자

  점의 x 좌표입니다.

• y

  숫자

  점의 y 좌표입니다.

TouchCalibrationPair

Chrome 57 이상

속성

• displayPoint

  포인트

  표시 지점의 좌표입니다.

• touchPoint

  포인트

  표시 지점에 해당하는 터치 포인트의 좌표입니다.

TouchCalibrationPairQuad

Chrome 57 이상

속성

• pair1

  TouchCalibrationPair

  터치 보정에는 첫 번째 터치 및 디스플레이 포인트 쌍이 필요합니다.

• pair2

  TouchCalibrationPair

  터치 보정에는 두 번째 터치 및 디스플레이 포인트 쌍이 필요합니다.

• pair3

  TouchCalibrationPair

  터치 보정에 필요한 터치 및 디스플레이 포인트의 세 번째 쌍.

• pair4

  TouchCalibrationPair

  터치 보정에 필요한 터치 및 디스플레이 포인트의 네 번째 쌍입니다.

방법

clearTouchCalibration()

Chrome 57 이상

chrome.system.display.clearTouchCalibration(
  id: string,
)

디스플레이의 터치 보정을 재설정하고 디스플레이와 관련된 터치 보정 데이터를 삭제하여 기본 상태로 되돌아갑니다.

매개변수

• id

  string

  디스플레이의 고유 식별자입니다.

completeCustomTouchCalibration()

Chrome 57 이상

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

디스플레이의 터치 보정 쌍을 설정합니다. 이러한 pairs는 startCustomTouchCalibration()에서 호출된 id로 디스플레이의 터치스크린을 보정하는 데 사용됩니다. 이 메서드를 호출하기 전에 항상 startCustomTouchCalibration를 호출하세요. 다른 터치 보정이 이미 진행 중이면 오류가 발생합니다.

매개변수

• pairs

  TouchCalibrationPairQuad

  디스플레이를 보정하는 데 사용되는 점 쌍입니다.

• bounds

  경계

  터치 보정이 실행되었을 때의 디스플레이 경계. bounds.left 및 bounds.top 값은 무시됩니다.

enableUnifiedDesktop()

Chrome 46 이상

chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
)

통합 데스크톱 기능을 사용 설정/사용 중지합니다. 미러링이 활성화된 상태에서 사용 설정하면 미러링을 사용 중지할 때까지 데스크톱 모드가 변경되지 않습니다. 그렇지 않으면 데스크톱 모드가 즉시 통합 모드로 전환됩니다. 참고: 이 기능은 Chrome OS 키오스크 앱 및 웹 UI에서만 사용할 수 있습니다.

매개변수

• 사용 설정됨

  boolean

  통합 데스크톱을 사용 설정해야 하는 경우 true입니다.

getDisplayLayout()

Promise Chrome 53 이상

chrome.system.display.getDisplayLayout(
  callback?: function,
)

모든 디스플레이의 레이아웃 정보를 요청합니다. 참고: 이 기능은 Chrome OS 키오스크 앱 및 웹 UI에서만 사용할 수 있습니다.

매개변수

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (layouts: DisplayLayout[])=>void

  • 레이아웃

    DisplayLayout[]

반환 값

• Promise<DisplayLayout[]>

  Chrome 91 이상

  프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getInfo()

프로미스

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
)

연결된 모든 디스플레이 기기의 정보를 요청합니다.

매개변수

• flags

  GetInfoFlags 선택사항

  Chrome 59 이상

  정보 반환 방식에 영향을 주는 옵션입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (displayInfo: DisplayUnitInfo[])=>void

  • displayInfo

    DisplayUnitInfo[]

반환 값

• Promise<DisplayUnitInfo[]>

  Chrome 91 이상

  프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

overscanCalibrationAdjust()

Chrome 53 이상

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

디스플레이의 현재 오버스캔 인셋을 조정합니다. 일반적으로 디스플레이를 축을 따라 이동하거나 (예: 왼쪽+오른쪽은 동일한 값을 가짐) 축을 따라 배율 (예: 상단+하단이 반대 값을 가짐)해야 합니다. 각 Adjust 호출은 시작 이후의 이전 호출과 함께 누적됩니다.

매개변수

• id

  string

  디스플레이의 고유 식별자입니다.

• 델타

  인셋

  오버스캔 인셋을 변경할 크기입니다.

overscanCalibrationComplete()

Chrome 53 이상

chrome.system.display.overscanCalibrationComplete(
  id: string,
)

현재 값을 저장하고 오버레이를 숨겨 디스플레이의 오버스캔 조정을 완료합니다.

매개변수

• id

  string

  디스플레이의 고유 식별자입니다.

overscanCalibrationReset()

Chrome 53 이상

chrome.system.display.overscanCalibrationReset(
  id: string,
)

디스플레이의 오버스캔 인셋을 마지막으로 저장된 값 (즉, Start가 호출되기 전)으로 재설정합니다.

매개변수

• id

  string

  디스플레이의 고유 식별자입니다.

overscanCalibrationStart()

Chrome 53 이상

chrome.system.display.overscanCalibrationStart(
  id: string,
)

디스플레이의 오버스캔 보정을 시작합니다. 그러면 현재 오버스캔 인셋을 나타내는 오버레이가 화면에 표시됩니다. id 디스플레이의 오버스캔 보정이 진행 중이면 보정이 재설정됩니다.

매개변수

• id

  string

  디스플레이의 고유 식별자입니다.

setDisplayLayout()

Promise Chrome 53 이상

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

모든 디스플레이의 레이아웃을 설정합니다. 포함되지 않은 모든 디스플레이에서 기본 레이아웃이 사용됩니다. 레이아웃이 겹치거나 유효하지 않은 경우 유효한 레이아웃으로 조정됩니다. 레이아웃이 결정되면 onDisplayChanged 이벤트가 트리거됩니다. 참고: 이 기능은 Chrome OS 키오스크 앱 및 웹 UI에서만 사용할 수 있습니다.

매개변수

• 레이아웃

  DisplayLayout[]

  기본 디스플레이를 제외한 모든 디스플레이에 필요한 레이아웃 정보입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  ()=>void

반환 값

• Promise<void>

  Chrome 91 이상

  프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setDisplayProperties()

프로미스

chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
)

info에 제공된 정보에 따라 id로 지정된 디스플레이의 속성을 업데이트합니다. 실패하면 runtime.lastError가 설정됩니다. 참고: 이 기능은 Chrome OS 키오스크 앱 및 웹 UI에서만 사용할 수 있습니다.

매개변수

• id

  string

  디스플레이의 고유 식별자입니다.

• 정보

  DisplayProperties

  변경해야 하는 표시 속성에 대한 정보입니다. 속성은 새 값이 info에 지정된 경우에만 변경됩니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  ()=>void

반환 값

• Promise<void>

  Chrome 91 이상

  프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setMirrorMode()

Promise Chrome 65 이상

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
)

디스플레이 모드를 지정된 미러링 모드로 설정합니다. 각 호출은 이전 호출의 상태를 재설정합니다. 미러링 대상 표시에서 setDisplayProperties()를 호출하면 실패합니다. 참고: 이 기능은 Chrome OS 키오스크 앱 및 웹 UI에서만 사용할 수 있습니다.

매개변수

• 정보

  MirrorModeInfo

  디스플레이 모드에 적용되어야 하는 미러 모드에 관한 정보입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  ()=>void

반환 값

• Promise<void>

  Chrome 91 이상

  프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

showNativeTouchCalibration()

Promise Chrome 57 이상

chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
)

id를 디스플레이 ID로 사용하여 디스플레이의 네이티브 터치 보정 UX를 표시합니다. 진행 방법에 관한 필수 안내가 포함된 오버레이가 화면에 표시됩니다. 콜백은 보정에 성공한 경우에만 호출됩니다. 보정에 실패하면 오류가 발생합니다.

매개변수

• id

  string

  디스플레이의 고유 식별자입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (success: boolean)=>void

  • 성공

    boolean

반환 값

• Promise<boolean>

  Chrome 91 이상

  프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

startCustomTouchCalibration()

Chrome 57 이상

chrome.system.display.startCustomTouchCalibration(
  id: string,
)

디스플레이의 맞춤 터치 보정을 시작합니다. 보정 데이터 수집을 위해 맞춤 UX를 사용할 때 이 메서드를 호출해야 합니다. 다른 터치 보정이 이미 진행 중이면 오류가 발생합니다.

매개변수

• id

  string

  디스플레이의 고유 식별자입니다.

이벤트

onDisplayChanged

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

디스플레이 구성이 변경되면 실행됩니다.

매개변수

• 콜백

  기능

  callback 매개변수는 다음과 같습니다.

  ()=>void