chrome.mediaGalleries

شرح

از chrome.mediaGalleries API برای دسترسی به فایل‌های رسانه‌ای (صدا، تصویر، ویدیو) از دیسک‌های محلی کاربر (با رضایت کاربر) استفاده کنید.

اجازه‌ها

mediaGalleries

دردسترس بودن

فقط ChromeOS

انواع

AddGalleryWatchResult

مشخصات

  • galleryId

    رشته

  • موفقیت‌آمیز

    بولی

GalleryChangeDetails

مشخصات

  • galleryId

    رشته

    گالری اصلاح‌شده را شناسایی می‌کند.

  • نوع رویداد تغییر.

GalleryChangeType

شمارشی

"contents_changed"
محتوای گالری تغییر کرده است.

«watch_dropped»
ساعت به‌دلیل جدا شدن دستگاه، برداشته شدن اجازه گالری، یا هر دلیل دیگری رها شده است.

GetMediaFileSystemsInteractivity

شمارشی

"no"
به‌صورت تعاملی عمل نکنید.

«بله»
از کاربر بخواهید گالری‌های رسانه مجاز را مدیریت کند.

«if_needed»
از کاربر بخواهید گالری‌های مجاز را فقط درصورتی مدیریت کند که مجموعه برگشتی درغیراین‌صورت خالی باشد.

GetMetadataType

شمارشی

«all»
نوع mime، برچسب‌های فراداده، و تصاویر پیوست‌شده را بازیابی می‌کند.

"mimeTypeAndTags"
فقط نوع mime و برچسب‌های فراداده را بازیابی می‌کند.

"mimeTypeOnly"
فقط نوع mime را بازیابی می‌کند.

MediaFileSystemMetadata

مشخصات

  • deviceId

    رشته اختیاری

    اگر گالری رسانه در دستگاه جداشدنی باشد، شناسه یکتایی برای دستگاه در زمانی که دستگاه آنلاین است.

  • galleryId

    رشته

    شناسه یکتا و دائمی برای گالری رسانه.

  • isAvailable

    بولی

    اگر دستگاه درحال‌حاضر دردسترس باشد، True است.

  • isMediaDevice

    بولی

    اگر دستگاهی که گالری رسانه در آن قرار دارد به‌عنوان دستگاه رسانه‌ای شناسایی شود، True است. یعنی دستگاه PTP یا MTP یا دایرکتوری DCIM وجود دارد.

  • isRemovable

    بولی

    اگر گالری رسانه در دستگاه جداشدنی باشد، درست است.

  • نام

    رشته

    نام سیستم فایل.

MediaFileSystemsDetails

مشخصات

  • تعاملی

    GetMediaFileSystemsInteractivity اختیاری

    آیا قبل‌از برگرداندن مجموعه مجاز، از کاربر برای اجازه دسترسی به گالری‌های رسانه اضافی درخواست شود یا نه. پیش‌فرض بی‌صدا است. اگر مقدار «yes» (بله) ارسال شود، یا اگر به برنامه اجازه دسترسی به هیچ گالری رسانه‌ای داده نشده باشد و مقدار «if_needed» (درصورت نیاز) ارسال شود، کادر گفتگوی پیکربندی گالری رسانه نمایش داده خواهد شد.

MediaMetadata

مشخصات

  • آلبوم

    رشته اختیاری

    برای صدا و ویدیو تعریف شده است.

  • هنرمند

    رشته اختیاری

  • attachedImages

    حباب[]

    تصاویر جاسازی‌شده در فراداده فایل رسانه. این نسبت ابعادی بیشتر برای جلد آلبوم یا ریزعکس ویدیو استفاده می‌شود.

  • نظر

    رشته اختیاری

  • حق نشر

    رشته اختیاری

  • دیسک

    شماره اختیاری

  • مدت زمان

    شماره اختیاری

    برای صدا و ویدیو تعریف شده است. در چند ثانیه.

  • ژانر

    رشته اختیاری

  • ارتفاع

    شماره اختیاری

    برای ویدیو تعریف شده است. به پیکسل.

  • زبان

    رشته اختیاری

  • mimeType

    رشته

    نوع رسانه شناسایی‌شده توسط مرورگر.

  • rawTags

    StreamInfo[]

    همه فراداده‌های موجود در فایل رسانه. برای قالب‌هایی که چند جاری‌سازی دارند، ترتیب جاری‌سازی حفظ خواهد شد. فراداده محتوی اولین عنصر است.

  • چرخش

    شماره اختیاری

    برای ویدیو تعریف شده است. به درجه.

  • عنوان

    رشته اختیاری

  • قطعه

    شماره اختیاری

  • عرض

    شماره اختیاری

MediaMetadataOptions

مشخصات

  • metadataType

    GetMetadataType اختیاری

    مشخص می‌کند کدام زیرمجموعه از فراداده بازیابی شود. اگر این گزینه حذف شود، به‌طور پیش‌فرض روی «همه» تنظیم می‌شود.

StreamInfo

مشخصات

  • برچسب‌ها

    شیء

    یک واژه‌نامه رشته->رشته فیلترنشده از برچسب‌ها برای جاری‌سازی.

  • نوع

    رشته

    قالب محفظه یا کدک جاری‌سازی را شرح می‌دهد، یعنی «mp3»، «h264».

روش‌ها

addGalleryWatch()

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

یک گالری را برای گالری با شناسه گالری مشخص‌شده اضافه می‌کند. سپس فراخوانی برگشتی ارائه‌شده با نتیجه موفقیت یا شکست اجرا می‌شود.

پارامترها

بازگشتی‌ها

  • Chrome نسخه ۱۱۶ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

addUserSelectedFolder()

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

انتخابگر دایرکتوری را به کاربر ارائه دهید و دایرکتوری انتخاب‌شده را به‌عنوان گالری اضافه کنید. اگر کاربر انتخاب‌گر را لغو کند، selectedFileSystemName خالی خواهد بود. برای نمایش کادر گفتگو، اشاره کاربر لازم است. بدون اشاره کاربر، فراخوانی برگشتی به‌گونه‌ای اجرا می‌شود که گویی کاربر لغو کرده است.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      رشته

getMediaFileSystemMetadata()

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

دریافت فراداده درباره سیستم فایل رسانه‌ای خاص.

پارامترها

  • mediaFileSystem

    DOMFileSystem

بازگشتی‌ها

getMediaFileSystems()

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

گالری‌های رسانه پیکربندی‌شده در این نماینده کاربر را دریافت کنید. اگر هیچ‌کدام پیکربندی نشده یا دردسترس نباشد، فراخوانی برگشتی آرایه خالی دریافت خواهد کرد.

پارامترها

  • جزئیات

    MediaFileSystemsDetails اختیاری

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

بازگشتی‌ها

  • Promise<DOMFileSystem[]>

    Chrome نسخه ۱۱۶ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getMetadata()

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

فراداده‌های خاص رسانه را برای فایل رسانه‌ای دریافت می‌کند. این باید برای فایل‌های موجود در گالری‌های رسانه و همچنین دیگر سیستم‌های فایل DOM کار کند.

پارامترها

  • mediaFile

    حباب

  • گزینه‌ها

    MediaMetadataOptions اختیاری

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (metadata: MediaMetadata) => void

بازگشتی‌ها

  • Promise<MediaMetadata>

    Chrome نسخه ۱۱۶ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

removeGalleryWatch()

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

یک گالری را برای گالری با شناسه گالری مشخص‌شده حذف می‌کند.

پارامترها

  • galleryId

    رشته

رویدادها

onGalleryChanged

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

وقتی گالری رسانه تغییر می‌کند یا تماشای گالری متوقف می‌شود، فعال می‌شود.

پارامترها