browser.wallpaper

תיאור

משתמשים ב-API של chrome.wallpaper כדי לשנות את הטפט ב-ChromeOS.

הרשאות

wallpaper

כדי להשתמש ב-API של הטפט, צריך להצהיר על ההרשאה "טפט" במניפסט של האפליקציה. לדוגמה:

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

זמינות

‫Chrome 43 ואילך ‫browser.* ‎ מגרסה 148 של Chrome ‫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 ואילך browser.* ‎ מ-Chrome 148

פריסות הטפטים הנתמכות.

טיפוסים בני מנייה (enum)

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Methods

setWallpaper()

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

הגדרת הטפט לתמונה ב-url או ב-wallpaperData עם ה-layout שצוין

פרמטרים

  • פרטים

    אובייקט

    • נתונים

      ‫ArrayBuffer אופציונלי

      תמונת הטפט בקידוד jpeg או png כ-ArrayBuffer.

    • שם קובץ

      מחרוזת

      שם הקובץ של הטפט שנשמר.

    • פריסה

      WallpaperLayout

      פריסות הטפטים הנתמכות.

    • תמונה ממוזערת

      בוליאני אופציונלי

      ‫True אם צריך ליצור תמונה ממוזערת בגודל 128x60. עדיין אין תמיכה בפריסה וביחס גובה-רוחב.

    • url

      מחרוזת אופציונלי

      כתובת ה-URL של הטפט שרוצים להגדיר (יכולה להיות יחסית).

החזרות

  • Promise<ArrayBuffer | undefined>

    ‫Chrome 96 ואילך ‫browser.* ‎ מגרסה 148 של Chrome