chrome.wallpaper

설명

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

권한

wallpaper

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

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

가용성

Chrome 43 이상 ChromeOS만 해당

예

예를 들어 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()

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

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

매개변수

  • 세부정보

    객체

    • 데이터

      ArrayBuffer 선택사항

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

    • filename

      문자열

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

    • 레이아웃

      WallpaperLayout

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

    • 썸네일

      불리언 선택사항

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

    • URL

      문자열 선택사항

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

반환 값

  • Promise<ArrayBuffer | undefined>

    Chrome 96 이상