chrome.wallpaper

설명

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

권한

wallpaper

지원 대상

Chrome 43 이상 ChromeOS만 해당

매니페스트

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

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

지원되는 배경화면 레이아웃

열거형

방법

setWallpaper()

프로미스 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

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

매개변수

  • 세부정보

    객체

    • 데이터

      ArrayBuffer 선택사항

      ArrayBuffer로서 jpeg 또는 png로 인코딩된 배경화면 이미지입니다.

    • filename

      string

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

    • 레이아웃

      WallpaperLayout

      지원되는 배경화면 레이아웃

    • 썸네일

      부울 선택사항

      128x60 미리보기 이미지를 생성해야 하는 경우 true입니다. 레이아웃과 비율은 아직 지원되지 않습니다.

    • url

      문자열 선택사항

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

  • 콜백

    함수 선택사항

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

    (thumbnail?: ArrayBuffer)=>void

    • 썸네일

      ArrayBuffer 선택사항

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

반환 값

  • 프로미스<ArrayBuffer|undefined>

    Chrome 96 이상

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