browser.system.display

설명

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

권한

system.display

유형

ActiveState

Chrome 117 이상 브라우저.*(Chrome 148부터)

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

열거형

'active'

"inactive"

Bounds

속성

  • 높이

    숫자

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

  • 왼쪽

    숫자

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

  • 상단

    숫자

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

  • 너비

    숫자

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

DisplayLayout

Chrome 53 이상 Chrome 148 이후 browser.*

속성

  • id

    문자열

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

  • 오프셋

    숫자

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

  • parentId

    문자열

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

  • position

    LayoutPosition

    상위 디스플레이를 기준으로 한 이 디스플레이의 레이아웃 위치입니다. 루트의 경우 무시됩니다.

DisplayMode

Chrome 52 이상 브라우저.*(Chrome 148부터)

속성

  • deviceScaleFactor

    숫자

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

  • 높이

    숫자

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

  • heightInNativePixels

    숫자

    기본 픽셀 단위의 디스플레이 모드 높이입니다.

  • isInterlaced

    불리언 선택사항

    Chrome 74 이상 Chrome 148 이후 브라우저.*

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

  • isNative

    부울

    모드가 디스플레이의 기본 모드인 경우 true입니다.

  • isSelected

    부울

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

  • refreshRate

    숫자

    Chrome 67 이상 브라우저.* Chrome 148부터

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

  • uiScale

    number 선택사항

    Chrome 70부터 지원 중단됨

    displayZoomFactor 사용

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

  • 너비

    숫자

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

  • widthInNativePixels

    숫자

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

DisplayProperties

속성

  • boundsOriginX

    number 선택사항

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

  • boundsOriginY

    number 선택사항

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

  • displayMode

    DisplayMode 선택사항

    Chrome 52 이상 브라우저.*(Chrome 148부터)

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

  • displayZoomFactor

    number 선택사항

    Chrome 65 이상 Chrome 148 이후 browser.*

    설정하면 디스플레이와 연결된 확대/축소를 업데이트합니다. 이 확대/축소는 레이아웃을 다시 지정하고 다시 그리므로 픽셀 단위로 확대하는 것보다 더 나은 품질의 확대/축소가 가능합니다.

  • isPrimary

    불리언 선택사항

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

  • isUnified

    불리언 선택사항

    Chrome 59 이상 브라우저.*(Chrome 148부터)

    ChromeOS만 해당됩니다. true로 설정하면 디스플레이 모드가 통합 데스크톱으로 변경됩니다 (자세한 내용은 enableUnifiedDesktop 참고). false로 설정하면 통합 데스크톱 모드가 사용 중지됩니다. 이는 기본 디스플레이에만 유효합니다. 제공된 경우 mirroringSourceId를 제공해서는 안 되며 다른 속성은 무시됩니다. 제공되지 않으면 아무런 영향을 미치지 않습니다.

  • mirroringSourceId

    문자열 선택사항

    Chrome 68부터 지원 중단됨

    setMirrorMode을 사용합니다.

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

  • 오버스캔

    Insets 선택사항

    설정된 경우 디스플레이의 오버스캔 인셋을 제공된 값으로 설정합니다. 각 오버스캔 인셋은 음수이거나 화면 크기의 1/4보다 크지 않아야 합니다. 내부 모니터에서는 오버스캔을 변경할 수 없습니다.

  • 회전

    number 선택사항

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

DisplayUnitInfo

속성

  • activeState

    ActiveState

    Chrome 117 이상 브라우저.*(Chrome 148부터)

    디스플레이가 감지되고 시스템에서 사용되는 경우 활성 상태입니다.

  • availableDisplayZoomFactors

    number[]

    Chrome 67 이상 브라우저.* Chrome 148부터

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

  • bounds

    경계

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

  • displayZoomFactor

    숫자

    Chrome 65 이상 Chrome 148 이후 browser.*

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

  • dpiX

    숫자

    X축을 따라 인치당 픽셀 수입니다.

  • dpiY

    숫자

    Y축을 따라 인치당 픽셀 수입니다.

  • edid

    Edid 선택사항

    Chrome 67 이상 브라우저.* Chrome 148부터

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

  • hasTouchSupport

    부울

    Chrome 57 이상 브라우저.* Chrome 148부터

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

  • id

    문자열

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

  • isEnabled

    부울

    이 디스플레이가 사용 설정된 경우 true입니다.

  • isPrimary

    부울

    기본 디스플레이인 경우 true입니다.

  • isUnified

    부울

    Chrome 59 이상 브라우저.*(Chrome 148부터)

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

  • mirroringDestinationIds

    문자열[]

    Chrome 64 이상 브라우저.*(Chrome 148부터)

    ChromeOS만 해당됩니다. 소스 디스플레이가 미러링되는 디스플레이의 식별자입니다. 미러링 중인 디스플레이가 없으면 비어 있습니다. 이 값은 모든 디스플레이에 동일하게 설정됩니다. mirroringSourceId은 포함하면 안 됩니다.

  • mirroringSourceId

    문자열

    ChromeOS만 해당됩니다. 미러링이 사용 설정된 경우 미러링되는 디스플레이의 식별자입니다. 그렇지 않으면 비어 있습니다. 이 설정은 미러링되는 디스플레이를 포함한 모든 디스플레이에 적용됩니다.

  • 모드

    DisplayMode[]

    Chrome 52 이상 브라우저.*(Chrome 148부터)

    사용 가능한 디스플레이 모드 목록입니다. 현재 모드에는 isSelected=true가 있습니다. ChromeOS에서만 사용할 수 있습니다. 다른 플랫폼에서는 빈 배열로 설정됩니다.

  • 이름

    문자열

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

  • 오버스캔

    인셋

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

  • 회전

    숫자

    수직 위치를 기준으로 한 디스플레이의 시계 방향 회전(도)입니다. 현재 ChromeOS에서만 노출됩니다. 다른 플랫폼에서는 0으로 설정됩니다. 값이 -1이면 기기가 물리적 태블릿 상태일 때 자동 회전으로 해석됩니다.

  • workArea

    경계

    디스플레이 경계 내에서 디스플레이의 사용 가능한 작업 영역입니다. 작업 영역에는 작업 표시줄 및 런처와 같이 OS용으로 예약된 디스플레이 영역이 제외됩니다.

Edid

Chrome 67 이상 브라우저.* Chrome 148부터

속성

  • manufacturerId

    문자열

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

  • productId

    문자열

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

  • yearOfManufacture

    숫자

    제조 연도, 3.4.4항 22페이지 v1.4에서 필수입니다.

GetInfoFlags

Chrome 59 이상 브라우저.*(Chrome 148부터)

속성

  • singleUnified

    불리언 선택사항

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

Insets

속성

  • 하단

    숫자

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

  • 왼쪽

    숫자

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

  • 오른쪽

    숫자

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

  • 상단

    숫자

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

LayoutPosition

Chrome 53 이상 Chrome 148 이후 browser.*

레이아웃 위치, 즉 디스플레이가 연결된 상위 요소의 가장자리입니다.

열거형

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65 이상 Chrome 148 이후 browser.*

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

열거형

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

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

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

MirrorModeInfo

Chrome 65 이상 Chrome 148 이후 browser.*

속성

  • mirroringDestinationIds

    string[] 선택사항

    미러링 대상 디스플레이의 ID입니다. 이는 '혼합'에만 유효합니다.

  • mirroringSourceId

    문자열 선택사항

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

  • 모드

    MirrorMode

    설정해야 하는 거울 모드입니다.

Point

Chrome 57 이상 브라우저.* Chrome 148부터

속성

  • x

    숫자

    지점의 x 좌표입니다.

  • y

    숫자

    지점의 y 좌표입니다.

TouchCalibrationPair

Chrome 57 이상 브라우저.* Chrome 148부터

속성

  • displayPoint

    Point

    표시 지점의 좌표입니다.

  • touchPoint

    Point

    디스플레이 지점에 해당하는 터치 포인트의 좌표입니다.

TouchCalibrationPairQuad

Chrome 57 이상 브라우저.* Chrome 148부터

속성

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

  • 터치 보정을 위해 두 번째 터치 및 디스플레이 포인트 쌍이 필요합니다.

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

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

메서드

clearTouchCalibration()

Chrome 57 이상 브라우저.* Chrome 148부터 
browser.system.display.clearTouchCalibration(
  id: string,
): void

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 디스플레이의 터치 보정을 재설정하고 디스플레이와 연결된 모든 터치 보정 데이터를 삭제하여 기본 상태로 되돌립니다.

매개변수

  • id

    문자열

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

completeCustomTouchCalibration()

Chrome 57 이상 브라우저.* Chrome 148부터 
browser.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 디스플레이의 터치 보정 쌍을 설정합니다. 이 pairs는 startCustomTouchCalibration()에서 호출된 id를 사용하여 디스플레이의 터치 스크린을 보정하는 데 사용됩니다. 이 메서드를 호출하기 전에 항상 startCustomTouchCalibration를 호출하세요. 다른 터치 보정이 이미 진행 중인 경우 오류가 발생합니다.

매개변수

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

  • bounds

    경계

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

enableUnifiedDesktop()

Chrome 46 이상 Chrome 148 이후 browser.* 
browser.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

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

매개변수

  • 운영중

    부울

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

getDisplayLayout()

Chrome 53 이상 Chrome 148 이후 browser.* 
browser.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

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

반환 값

  • Promise<DisplayLayout[]>

    Chrome 91 이상 Chrome 148 이후 browser.*

    결과로 확인되는 프로미스입니다.

getInfo()

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

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

매개변수

  • flags

    GetInfoFlags 선택사항

    Chrome 59 이상 브라우저.*(Chrome 148부터)

    정보가 반환되는 방식에 영향을 미치는 옵션입니다.

반환 값

  • Promise<DisplayUnitInfo[]>

    Chrome 91 이상 Chrome 148 이후 browser.*

    결과로 확인되는 프로미스입니다.

overscanCalibrationAdjust()

Chrome 53 이상 Chrome 148 이후 browser.* 
browser.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 디스플레이의 현재 오버스캔 인셋을 조정합니다. 일반적으로 이는 축을 따라 디스플레이를 이동하거나 (예: 왼쪽+오른쪽의 값이 동일함) 축을 따라 디스플레이를 확장해야 합니다 (예: 위쪽+아래쪽의 값이 반대임). 각 Adjust 호출은 Start 이후의 이전 호출과 누적됩니다.

매개변수

  • id

    문자열

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

  • 델타

    인셋

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

overscanCalibrationComplete()

Chrome 53 이상 Chrome 148 이후 browser.* 
browser.system.display.overscanCalibrationComplete(
  id: string,
): void

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 현재 값을 저장하고 오버레이를 숨겨 디스플레이의 오버스캔 조정을 완료합니다.

매개변수

  • id

    문자열

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

overscanCalibrationReset()

Chrome 53 이상 Chrome 148 이후 browser.* 
browser.system.display.overscanCalibrationReset(
  id: string,
): void

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 디스플레이의 오버스캔 인셋을 마지막으로 저장된 값 (즉, Start가 호출되기 전)으로 재설정합니다.

매개변수

  • id

    문자열

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

overscanCalibrationStart()

Chrome 53 이상 Chrome 148 이후 browser.* 
browser.system.display.overscanCalibrationStart(
  id: string,
): void

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 디스플레이의 오버스캔 보정을 시작합니다. 그러면 현재 오버스캔 인셋을 나타내는 오버레이가 화면에 표시됩니다. id 디스플레이의 오버스캔 보정이 진행 중인 경우 보정이 재설정됩니다.

매개변수

  • id

    문자열

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

setDisplayLayout()

Chrome 53 이상 Chrome 148 이후 browser.* 
browser.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

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

매개변수

  • 레이아웃

    DisplayLayout[]

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

반환 값

  • 약속<void>

    Chrome 91 이상 Chrome 148 이후 browser.*

    함수가 완료되면 확인되는 프로미스입니다.

setDisplayProperties()

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

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

매개변수

  • id

    문자열

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

  • 변경해야 하는 디스플레이 속성에 관한 정보입니다. info에 새 값이 지정된 경우에만 속성이 변경됩니다.

반환 값

  • 약속<void>

    Chrome 91 이상 Chrome 148 이후 browser.*

    함수가 완료되면 확인되는 프로미스입니다.

setMirrorMode()

Chrome 65 이상 Chrome 148 이후 browser.* 
browser.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 디스플레이 모드를 지정된 거울 모드로 설정합니다. 호출할 때마다 이전 호출의 상태가 재설정됩니다. 미러링 대상 디스플레이의 경우 setDisplayProperties() 호출이 실패합니다.

매개변수

  • 디스플레이 모드에 적용해야 하는 거울 모드의 정보입니다.

반환 값

  • 약속<void>

    Chrome 91 이상 Chrome 148 이후 browser.*

    함수가 완료되면 확인되는 프로미스입니다.

showNativeTouchCalibration()

Chrome 57 이상 브라우저.* Chrome 148부터 
browser.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 디스플레이 ID가 id인 디스플레이의 네이티브 터치 보정 UX를 표시합니다. 그러면 진행 방법에 관한 필수 안내가 화면에 오버레이로 표시됩니다. 콜백은 보정이 성공한 경우에만 호출됩니다. 보정에 실패하면 오류가 발생합니다.

매개변수

  • id

    문자열

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

반환 값

  • Promise<boolean>

    Chrome 91 이상 Chrome 148 이후 browser.*

    터치 보정이 종료되었음을 호출자에게 알리는 프로미스입니다. 불리언 값은 보정의 성공 여부를 알려줍니다.

startCustomTouchCalibration()

Chrome 57 이상 브라우저.* Chrome 148부터 
browser.system.display.startCustomTouchCalibration(
  id: string,
): void

참고: 이 기능은 ChromeOS 키오스크 앱에서만 사용할 수 있습니다. 디스플레이의 맞춤 터치 보정을 시작합니다. 보정 데이터를 수집하기 위해 맞춤 UX를 사용할 때 호출해야 합니다. 다른 터치 보정이 이미 진행 중인 경우 오류가 발생합니다.

매개변수

  • id

    문자열

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

이벤트

onDisplayChanged

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

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

매개변수

  • callback

    함수

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

    () => void