chrome.wallpaper

תיאור

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

‫"CENTER_CROPPED"

Methods

setWallpaper()

Promise 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

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

פרמטרים

  • פרטים

    אובייקט

    • נתונים

      ‫ArrayBuffer אופציונלי

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

    • שם קובץ

      מחרוזת

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

    • פריסה

      WallpaperLayout

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

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

      ‫boolean אופציונלי

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

    • כתובת אתר

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

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

  • callback

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

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

    (thumbnail?: ArrayBuffer) => void

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

      ‫ArrayBuffer אופציונלי

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

החזרות

  • Promise<ArrayBuffer | undefined>

    ‫Chrome 96 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.