תיאור
יש להשתמש ב-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"
שיטות
setWallpaper()
chrome.wallpaper.setWallpaper(
details: object,
callback?: function,
)
מגדיר את הטפט לפי התמונה בכתובת url או ב-wallpaperData עם הפריסה שצוינה
פרמטרים
-
פרטים
אובייקט
-
נתונים
ArrayBuffer אופציונלי
תמונת הטפט בקידוד jpeg או png כ-ArrayBuffer.
-
שם קובץ
string
שם הקובץ של הטפט שנשמר.
-
פריסה
פריסות הטפט הנתמכות.
-
תמונה ממוזערת
בוליאני אופציונלי
True אם רוצים ליצור תמונה ממוזערת בגודל 128x60. עדיין אין תמיכה בפריסה וביחס.
-
כתובת אתר
מחרוזת אופציונלי
כתובת ה-URL של הטפט להגדרה (יכולה להיות יחסית).
-
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(thumbnail?: ArrayBuffer) => void
-
תמונה ממוזערת
ArrayBuffer אופציונלי
תמונה ממוזערת של הטפט המקודד בפורמט jpeg. הוא נוצר על ידי שינוי גודל הטפט ל-128x60.
-
החזרות
-
Promise<ArrayBuffer | undefined>
Chrome 96 ומעלהיש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.