chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

설명

chrome.wallpaper API를 사용하여 ChromeOS 배경화면을 변경합니다.

권한

wallpaper

가용성

Chrome 43 이상 ChromeOS만 해당

매니페스트

배경 화면 API를 사용하려면 앱의 매니페스트에서 'wallpaper' 권한을 선언해야 합니다. 예를 들면 다음과 같습니다.

{
  "name": "My extension",
  ...
  "permissions": [
    "wallpaper"
  ],
  ...
}

예

예를 들어 https://example.com/a_file.png에 있는 이미지를 배경화면으로 설정하려면 다음과 같이 chrome.wallpaper.setWallpaper를 호출하면 됩니다.

chrome.wallpaper.setWallpaper(
  {
    'url': 'https://example.com/a_file.jpg',
    'layout': 'CENTER_CROPPED',
    'filename': 'test_wallpaper'
  },
  function() {}
);

유형

WallpaperLayout

Chrome 44 이상

지원되는 배경화면 레이아웃입니다.

열거형

'STRETCH'

"CENTER"

"CENTER_CROPPED"

메서드

setWallpaper()

Promise 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

지정된 레이아웃으로 url 또는 wallpaperData의 이미지로 배경화면을 설정합니다.

매개변수

  • 세부정보

    객체

    • 데이터

      ArrayBuffer 선택사항

      jpeg 또는 png로 인코딩된 배경화면 이미지를 ArrayBuffer로 나타냅니다.

    • filename

      문자열

      저장된 배경화면의 파일 이름입니다.

    • 레이아웃

      WallpaperLayout

      지원되는 배경화면 레이아웃입니다.

    • 썸네일

      불리언 선택사항

      128x60 썸네일을 생성해야 하는 경우 true입니다. 레이아웃과 비율은 아직 지원되지 않습니다.

    • URL

      문자열 선택사항

      설정할 배경화면의 URL입니다 (상대 URL일 수 있음).

  • callback

    함수 선택사항

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

    (thumbnail?: ArrayBuffer) => void

    • 썸네일

      ArrayBuffer 선택사항

      JPEG로 인코딩된 배경화면 썸네일입니다. 배경화면을 128x60으로 크기를 조절하여 생성됩니다.

반환 값

  • Promise<ArrayBuffer | undefined>

    Chrome 96 이상

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