chrome.mediaGalleries

תיאור

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

הרשאות

mediaGalleries

סוגים

AddGalleryWatchResult

מאפיינים

  • galleryId

    מחרוזת

  • הצלחה

    בוליאני

GalleryChangeDetails

מאפיינים

  • galleryId

    מחרוזת

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

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

GalleryChangeType

Enum

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

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

GetMediaFileSystemsInteractivity

Enum

"no"
Do not act interactively.

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

‫if_needed
המערכת תבקש מהמשתמש לנהל רק את הגלריות המותרות, רק אם קבוצת התוצאות תהיה ריקה אחרת.

GetMetadataType

Enum

‫all
שליפת סוג ה-MIME, תגי המטא-נתונים והתמונות המצורפות.

‫"mimeTypeAndTags"
שליפה רק של סוג ה-MIME ותגי המטא-נתונים.

‫"mimeTypeOnly"
שליפה של סוג ה-MIME בלבד.

MediaFileSystemMetadata

מאפיינים

  • deviceId

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

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

  • galleryId

    מחרוזת

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

  • isAvailable

    בוליאני

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

  • isMediaDevice

    בוליאני

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

  • isRemovable

    בוליאני

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

  • שם

    מחרוזת

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

MediaFileSystemsDetails

מאפיינים

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

    GetMediaFileSystemsInteractivity optional

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

MediaMetadata

מאפיינים

  • album

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

    מוגדר לאודיו ולסרטונים.

  • artist

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

  • attachedImages

    Blob[]

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

  • תגובה

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

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

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

  • דיסק

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

  • משך

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

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

  • ז'אנר

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

  • גובה

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

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

  • language

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

  • mimeType

    מחרוזת

    סוג ה-MIME שזוהה בדפדפן.

  • rawTags

    StreamInfo[]

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

  • סיבוב

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

    מוגדר לסרטון. במעלות.

  • title

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

  • טראק

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

  • רוחב

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

MediaMetadataOptions

מאפיינים

  • metadataType

    ‫GetMetadataType אופציונלי

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

StreamInfo

מאפיינים

  • תגים

    אובייקט

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

  • סוג

    מחרוזת

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

Methods

addGalleryWatch()

Promise 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
): Promise<AddGalleryWatchResult>

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

פרמטרים

החזרות

  • ‫Chrome 116 ואילך

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
): void

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

פרמטרים

  • callback

    פונקציה

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

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      מחרוזת

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

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

פרמטרים

  • mediaFileSystem

    DOMFileSystem

החזרות

getMediaFileSystems()

Promise 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

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

פרמטרים

  • פרטים

    ‫MediaFileSystemsDetails אופציונלי

  • callback

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

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

החזרות

  • Promise<DOMFileSystem[]>

    ‫Chrome 116 ואילך

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

getMetadata()

Promise 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
): Promise<MediaMetadata>

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

פרמטרים

החזרות

  • Promise<MediaMetadata>

    ‫Chrome 116 ואילך

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
): void

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

פרמטרים

  • galleryId

    מחרוזת

אירועים

onGalleryChanged

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

האירוע מופעל כשמשנים גלריית מדיה או כשמפסיקים לעקוב אחרי גלריה.

פרמטרים