browser.wallpaper

설명

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

권한

wallpaper

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

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

가용성

Chrome 43 이상 ChromeOS만 해당

예

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

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

유형

WallpaperLayout

Chrome 44 이상

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

열거형

'STRETCH'

"CENTER"

"CENTER_CROPPED"

메서드

setWallpaper()

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

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

매개변수

  • 세부정보

    객체

    • 데이터

      ArrayBuffer 선택사항

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

    • filename

      문자열

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

    • 레이아웃

      WallpaperLayout

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

    • 썸네일

      불리언 선택사항

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

    • URL

      문자열 선택사항

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

반환 값

  • Promise<ArrayBuffer | undefined>

    Chrome 96 이상