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"

"מרכז"

"CENTER_CROPPED"

שיטות

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 | לא מוגדר>

    Chrome מגרסה 96 ואילך

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