chrome.system.display

설명

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

권한

system.display

유형

ActiveState

Chrome 117 이상

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

열거형

'active'

'비활성'

Bounds

속성

  • 높이

    숫자

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

  • 왼쪽

    숫자

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

  • 상단

    숫자

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

  • 너비

    숫자

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

DisplayLayout

Chrome 53 이상

속성

  • id

    문자열

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

  • 오프셋

    숫자

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

  • parentId

    문자열

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

  • position

    LayoutPosition

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

DisplayMode

Chrome 52 이상

속성

  • deviceScaleFactor

    숫자

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

  • 높이

    숫자

    기기 독립형 (사용자에게 표시되는) 픽셀로 표시 모드 높이입니다.

  • heightInNativePixels

    숫자

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

  • isInterlaced

    불리언 선택사항

    Chrome 74 이상

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

  • isNative

    부울

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

  • isSelected

    부울

    디스플레이 모드가 현재 선택된 경우 true입니다.

  • refreshRate

    숫자

    Chrome 67 이상

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

  • uiScale

    번호 선택사항

    Chrome 70부터 지원 중단됨

    displayZoomFactor 사용

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

  • 너비

    숫자

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

  • widthInNativePixels

    숫자

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

DisplayProperties

속성

  • boundsOriginX

    번호 선택사항

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

  • boundsOriginY

    번호 선택사항

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

  • displayMode

    DisplayMode 선택사항

    Chrome 52 이상

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

  • displayZoomFactor

    번호 선택사항

    Chrome 65 이상

    설정된 경우 디스플레이와 연결된 확대/축소를 업데이트합니다. 이 확대/축소는 레이아웃을 다시 정의하고 다시 칠하기 때문에 픽셀 단위로 늘리는 것보다 더 나은 품질의 확대/축소를 실행할 수 있습니다.

  • isPrimary

    불리언 선택사항

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

  • isUnified

    불리언 선택사항

    Chrome 59 이상

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

  • mirroringSourceId

    문자열 선택사항

    Chrome 68부터 지원 중단됨

    setMirrorMode을 사용합니다.

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

  • 오버스캔

    인셋 선택사항

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

  • 회전

    번호 선택사항

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

DisplayUnitInfo

속성

  • activeState

    ActiveState

    Chrome 117 이상

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

  • availableDisplayZoomFactors

    number[]

    Chrome 67 이상

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

  • bounds

    경계

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

  • displayZoomFactor

    숫자

    Chrome 65 이상

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

  • dpiX

    숫자

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

  • dpiY

    숫자

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

  • edid

    Edid 선택사항

    Chrome 67 이상

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

  • hasTouchSupport

    부울

    Chrome 57 이상

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

  • id

    문자열

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

  • isEnabled

    부울

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

  • isPrimary

    부울

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

  • isUnified

    부울

    Chrome 59 이상

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

  • mirroringDestinationIds

    문자열[]

    Chrome 64 이상

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

  • mirroringSourceId

    문자열

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

  • 모드

    DisplayMode[]

    Chrome 52 이상

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

  • 이름

    문자열

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

  • 오버스캔

    인셋

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

  • 회전

    숫자

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

  • workArea

    경계

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

Edid

Chrome 67 이상

속성

  • manufacturerId

    문자열

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

  • productId

    문자열

    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 이상

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

열거형

'top'

'right'

'bottom'

"left"

MirrorMode

Chrome 65 이상

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

열거형

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

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

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

MirrorModeInfo

Chrome 65 이상

속성

  • mirroringDestinationIds

    string[] 선택사항

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

  • mirroringSourceId

    문자열 선택사항

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

  • 모드

    MirrorMode

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

Point

Chrome 57 이상

속성

  • x

    숫자

    지점의 x 좌표입니다.

  • y

    숫자

    지점의 y 좌표입니다.

TouchCalibrationPair

Chrome 57 이상

속성

  • displayPoint

    Point

    표시 지점의 좌표입니다.

  • touchPoint

    Point

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

TouchCalibrationPairQuad

Chrome 57 이상

속성

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

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

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

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

메서드

clearTouchCalibration()

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

디스플레이의 터치 보정을 재설정하고 디스플레이와 연결된 모든 터치 보정 데이터를 삭제하여 기본 상태로 되돌립니다.

매개변수

  • id

    문자열

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

completeCustomTouchCalibration()

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

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

매개변수

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

  • bounds

    경계

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

enableUnifiedDesktop()

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

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

매개변수

  • 사용 설정됨

    부울

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

getDisplayLayout()

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

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

매개변수

  • 콜백

    함수 선택사항

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

    (layouts: DisplayLayout[]) => void

반환 값

  • Promise<DisplayLayout[]>

    Chrome 91 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getInfo()

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

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

매개변수

  • flags

    GetInfoFlags 선택사항

    Chrome 59 이상

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

  • 콜백

    함수 선택사항

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

    (displayInfo: DisplayUnitInfo[]) => void

반환 값

  • Promise<DisplayUnitInfo[]>

    Chrome 91 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

overscanCalibrationAdjust()

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

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

매개변수

  • id

    문자열

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

  • 델타

    인셋

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

overscanCalibrationComplete()

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

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

매개변수

  • id

    문자열

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

overscanCalibrationReset()

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

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

매개변수

  • id

    문자열

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

overscanCalibrationStart()

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

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

매개변수

  • id

    문자열

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

setDisplayLayout()

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

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

매개변수

  • layouts

    DisplayLayout[]

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setDisplayProperties()

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

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

매개변수

  • id

    문자열

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

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setMirrorMode()

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

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

매개변수

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

showNativeTouchCalibration()

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

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

매개변수

  • id

    문자열

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

  • 콜백

    함수 선택사항

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

    (success: boolean) => void

    • 성공

      부울

반환 값

  • Promise<boolean>

    Chrome 91 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

startCustomTouchCalibration()

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

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

매개변수

  • id

    문자열

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

이벤트

onDisplayChanged

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

디스플레이 구성이 변경될 때 실행됩니다.

매개변수

  • 콜백

    함수

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

    () => void