refresh date: 2026-09-25 robots: noindex
תיאור
משתמשים ב-API של chrome.wallpaper כדי לשנות את הטפט ב-ChromeOS.
הרשאות
wallpaperזמינות
מניפסט
כדי להשתמש ב-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
פריסות הטפטים הנתמכות.
טיפוסים בני מנייה (enum)
"STRETCH"
"CENTER"
"CENTER_CROPPED"
Methods
setWallpaper()
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
): Promise<ArrayBuffer | undefined>
הגדרת הטפט לתמונה ב-url או ב-wallpaperData עם ה-layout שצוין
פרמטרים
-
פרטים
אובייקט
-
נתונים
ArrayBuffer אופציונלי
תמונת הטפט בקידוד jpeg או png כ-ArrayBuffer.
-
שם קובץ
מחרוזת
שם הקובץ של הטפט שנשמר.
-
פריסה
פריסות הטפטים הנתמכות.
-
תמונה ממוזערת
בוליאני אופציונלי
True אם צריך ליצור תמונה ממוזערת בגודל 128x60. עדיין אין תמיכה בפריסה וביחס גובה-רוחב.
-
url
מחרוזת אופציונלי
כתובת ה-URL של הטפט שרוצים להגדיר (יכולה להיות יחסית).
-
-
callback
function optional
הפרמטר
callbackנראה כך:(thumbnail?: ArrayBuffer) => void
-
תמונה ממוזערת
ArrayBuffer אופציונלי
התמונה הממוזערת של הטפט בקידוד jpeg. הוא נוצר על ידי שינוי הגודל של הטפט ל-128x60.
-
החזרות
-
Promise<ArrayBuffer | undefined>
Chrome מגרסה 96 ואילךהבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).