chrome.mediaGalleries

תיאור

משתמשים ב-API chrome.mediaGalleries כדי לגשת לקובצי מדיה (אודיו, תמונות, וידאו) מהדיסקים המקומיים של המשתמש (בהסכמת המשתמש).

הרשאות

mediaGalleries

סוגים

AddGalleryWatchResult

מאפיינים

  • galleryId

    מחרוזת

  • הצלחה

    בוליאני

GalleryChangeDetails

מאפיינים

  • galleryId

    מחרוזת

    מזהה את הגלריה שהשתנתה.

  • סוג אירוע השינוי.

GalleryChangeType

Enum

"contents_changed"
תוכן הגלריה השתנה.

"watch_dropped"
השעון הוסר כי המכשיר נותק, ההרשאה בגלריה הוסרה או מכל סיבה אחרת.

GetMediaFileSystemsInteractivity

Enum

"לא"
אין לבצע פעולה אינטראקטיבית.

"כן"
יש לבקש מהמשתמש לנהל גלריות מדיה מורשות.

"if_needed"
יש לבקש מהמשתמש לנהל גלריות מורשות רק אם קבוצת ההחזרות הייתה ריקה.

GetMetadataType

Enum

'הכול'
אחזור סוג ה-MIME, תגי המטא-נתונים והתמונות המצורפות.

"mimeTypeAndTags"
אחזור רק של סוג ה-mime ותגי המטא-נתונים.

"mimeTypeOnly"
אחזור סוג ה-mime בלבד.

MediaFileSystemMetadata

מאפיינים

  • deviceId

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

    אם גלריית המדיה נמצאת במכשיר נשלף, יהיה מזהה ייחודי של המכשיר כשהמכשיר מחובר לאינטרנט.

  • galleryId

    מחרוזת

    מזהה ייחודי וקבוע של גלריית המדיה.

  • זמין

    בוליאני

    הערך הוא True אם המכשיר זמין כרגע.

  • isMediaDevice

    בוליאני

    הערך הוא True אם המכשיר שבו פועלת גלריית המדיה זוהה כמכשיר מדיה. כלומר, מכשיר PTP או MTP, או ספריית DCIM.

  • isRemovable

    בוליאני

    הערך הוא True אם גלריית המדיה נמצאת במכשיר נשלף.

  • שם

    מחרוזת

    השם של מערכת הקבצים.

MediaFileSystemsDetails

מאפיינים

  • אינטראקטיבי

    GetMediaFileSystemsInteractivity אופציונלי

    האם לבקש מהמשתמש הרשאה לגלריות מדיה נוספות לפני החזרת הקבוצה המותרת. ברירת המחדל היא שקטה. אם הערך הוא 'כן' מועבר, או אם האפליקציה לא קיבלה גישה לגלריות מדיה כלשהן והערך 'if_needed'. מועבר, תוצג תיבת הדו-שיח להגדרת גלריית המדיה.

MediaMetadata

מאפיינים

  • album

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

    מוגדר לאודיו ולווידאו.

  • artist

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

  • attachedImages

    כתם[]

    התמונות שמוטמעות במטא-נתונים של קובץ המדיה. בדרך כלל משתמשים באפשרות הזו בעטיפת אלבום או בתמונות ממוזערות של סרטונים.

  • תגובה

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

  • זכויות יוצרים

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

  • דיסק

    מספר אופציונלי

  • משך

    מספר אופציונלי

    מוגדר לאודיו ולווידאו. בשניות.

  • ז'אנר

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

  • גובה

    מספר אופציונלי

    מוגדר לווידאו. בפיקסלים.

  • language

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

  • mimeType

    מחרוזת

    סוג ה-MIME של הדפדפן "הנחית".

  • rawTags

    StreamInfo[]

    כל המטא-נתונים בקובץ המדיה. בפורמטים עם כמה שידורים, הסדר של עדכוני התוכן יישמר. מטא-נתונים של קונטיינר הם הרכיב הראשון.

  • סבב

    מספר אופציונלי

    מוגדר לווידאו. במעלות.

  • title

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

  • טראק

    מספר אופציונלי

  • רוחב

    מספר אופציונלי

MediaMetadataOptions

מאפיינים

  • metadataType

    GetMetadataType אופציונלי

    מציינת איזו קבוצת משנה של המטא-נתונים יש לאחזר. ברירת המחדל היא 'הכול'. אם האפשרות לא מוצגת.

StreamInfo

מאפיינים

  • תגים

    אובייקט

    מילון מחרוזות->מחרוזת לא מסוננת של תגים עבור השידור.

  • סוג

    מחרוזת

    תיאור הפורמט של הקונטיינר או הקודק של השידור, למשל "mp3", "h264".

שיטות

addGalleryWatch()

הבטחה 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

הוספת שעון גלריה לגלריה עם מזהה הגלריה שצוין. הקריאה החוזרת הנתונה מופעלת לאחר מכן, עם תוצאה של הצלחה או כישלון.

פרמטרים

החזרות

  • Promise<AddGalleryWatchResult>

    Chrome 116 ואילך

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

מציגים למשתמש בוחר ספריות ומוסיפים את הספרייה שנבחרה כגלריה. אם המשתמש יבטל את הבורר, הקובץ selectedFileSystemName יהיה ריק. נדרשת תנועת משתמש כדי שתיבת הדו-שיח תוצג. ללא תנועת משתמש, הקריאה החוזרת תפעל כאילו המשתמש בוטל.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

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

    (mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      מחרוזת

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

קבלת מטא-נתונים על מערכת קובצי מדיה ספציפית.

פרמטרים

  • mediaFileSystem

    DOMFileSystem

החזרות

getMediaFileSystems()

הבטחה 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

הגדרת גלריות המדיה בסוכן המשתמש הזה. אם לא מוגדר או זמין, הקריאה החוזרת תקבל מערך ריק.

פרמטרים

  • פרטים

    MediaFileSystemsDetails אופציונלי

  • קריאה חוזרת (callback)

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

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

החזרות

  • Promise<DOMFileSystem[]>

    Chrome 116 ואילך

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getMetadata()

הבטחה 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

קבלת המטא-נתונים הספציפיים למדיה של קובץ מדיה. השיטה הזו אמורה לפעול עבור קבצים בגלריות מדיה וגם במערכות קבצים אחרות מסוג DOM.

פרמטרים

  • mediaFile

    כתם

  • אפשרויות

    MediaMetadataOptions אופציונליות

  • קריאה חוזרת (callback)

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

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

    (metadata: MediaMetadata) => void

החזרות

  • Promise<MediaMetadata>

    Chrome 116 ואילך

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

הסרה של שעון גלריה מהגלריה עם מזהה הגלריה שצוין.

פרמטרים

  • galleryId

    מחרוזת

אירועים

onGalleryChanged

chrome.mediaGalleries.onGalleryChanged.addListener(
  callback: function,
)

מופעל כשמתבצע שינוי בגלריית מדיה או כששעון גלריה מושמט.

פרמטרים