chrome.wallpaper

설명

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

권한

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

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

열거형

방법

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 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.