chrome.wallpaper

설명

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

권한

wallpaper

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

{
  "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 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

열거형

"늘리기"

'CENTER'

'CENTER_CROPPED'

메서드

setWallpaper()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

지정된 레이아웃을 사용하는 url 또는 wallpaperData에 있는 이미지로 배경화면을 설정합니다.

매개변수

  • 세부정보

    객체

    • 데이터

      ArrayBuffer 선택사항

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

    • filename

      문자열

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

    • 레이아웃

      WallpaperLayout

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

    • 썸네일

      불리언 선택사항

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

    • URL

      문자열(선택사항)

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

  • 콜백

    함수 선택사항

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

    (thumbnail?: ArrayBuffer) => void

    • 썸네일

      ArrayBuffer 선택사항

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

반환 값

  • Promise&lt;ArrayBuffer | 정의되지 않음>

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.