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"

"מרכז"

"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) בשביל תאימות לאחור. לא ניתן להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה הזו מצליחה לפתור את הבעיה באותו סוג שמועבר לקריאה החוזרת.