chrome.wallpaper

תיאור

יש להשתמש ב-API של chrome.wallpaper כדי לשנות את הטפט של 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 ואילך

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

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

"STRETCH"

שיטות

setWallpaper()

הבטחה 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
)

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

פרמטרים

  • פרטים

    אובייקט

    • נתונים

      ArrayBuffer אופציונלי

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

    • שם קובץ

      מחרוזת

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

    • פריסה

      WallpaperLayout

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

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

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

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

    • כתובת אתר

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

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

  • קריאה חוזרת (callback)

    פונקציה אופציונלי

    הפרמטר callback נראה כך: 

    (thumbnail?: ArrayBuffer)=>void

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

      ArrayBuffer אופציונלי

      תמונה ממוזערת של הטפט המקודד בפורמט jpeg. הוא נוצר על ידי שינוי גודל הטפט ל-128x60.

החזרות

  • Promise<ArrayBuffer|undefined>

    Chrome 96 ומעלה

    יש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.