chrome.wallpaper

תיאור

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

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

טיפוסים בני מנייה (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).