תיאור
יש להשתמש ב-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).