chrome.mediaGallery

مهم: این API فقط روی ChromeOS کار می‌کند.

توضیحات

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

مجوزها

mediaGalleries

در دسترس بودن

فقط سیستم عامل کروم

انواع

AddGalleryWatchResult

خواص

• شناسه گالری

  رشته

• موفقیت

  بولی

GalleryChangeDetails

خواص

• شناسه گالری

  رشته

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

• نوع

  گالریتغییرنوع

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

GalleryChangeType

شمارشی

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

"تماشای_رها شده"
ساعت به دلیل جدا شدن دستگاه، حذف مجوز گالری یا هر دلیل دیگری، از دست کاربر افتاده است.

GetMediaFileSystemsInteractivity

شمارشی

«نه»
تعاملی عمل نکنید.

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

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

GetMetadataType

شمارشی

«همه»
نوع MIME، تگ‌های متادیتا و تصاویر پیوست شده را بازیابی کنید.

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

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

MediaFileSystemMetadata

خواص

• شناسه دستگاه

  رشته اختیاری

  اگر گالری رسانه روی یک دستگاه قابل حمل باشد، یک شناسه منحصر به فرد برای دستگاه در حالی که آنلاین است.

• شناسه گالری

  رشته

  یک شناسه منحصر به فرد و پایدار برای گالری رسانه.

• موجود است

  بولی

  اگر دستگاه در حال حاضر موجود باشد، صحیح است.

• isMediaDevice

  بولی

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

• قابل جابجایی است

  بولی

  اگر گالری رسانه روی یک دستگاه قابل جابجایی باشد، صحیح است.

• نام

  رشته

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

MediaFileSystemsDetails

خواص

• تعاملی

  GetMediaFileSystemsInteractivity اختیاری

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

MediaMetadata

خواص

• آلبوم

  رشته اختیاری

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

• هنرمند

  رشته اختیاری

• تصاویر پیوست شده

  لکه[]

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

• نظر

  رشته اختیاری

• حق نشر

  رشته اختیاری

• دیسک

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

• مدت زمان

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

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

• ژانر

  رشته اختیاری

• ارتفاع

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

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

• زبان

  رشته اختیاری

• نوع مایم

  رشته

  مرورگر نوع mime را بو کشید.

• برچسب‌های خام

  اطلاعات جریان []

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

• چرخش

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

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

• عنوان

  رشته اختیاری

• آهنگ

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

• عرض

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

MediaMetadataOptions

خواص

• نوع فراداده

  GetMetadataType اختیاری است

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

StreamInfo

خواص

• برچسب‌ها

  شیء

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

• نوع

  رشته

  قالب ظرف یا کدک جریان، یعنی "mp3"، "h264" را توصیف می‌کند.

روش‌ها

addGalleryWatch()

وعده

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

یک گالری واچ (gallery watch) برای گالری با شناسه گالری مشخص شده اضافه می‌کند. سپس تابع فراخوانی داده شده با نتیجه موفقیت یا شکست اجرا می‌شود.

پارامترها

• شناسه گالری

  رشته

• تماس برگشتی

  تابع اختیاری

  پارامتر callback به شکل زیر است:

  (result: AddGalleryWatchResult) => void

  • نتیجه

    نتیجه AddGalleryWatch

بازگشت‌ها

• قول <AddGalleryWatchResult>

  کروم ۱۱۶+

  Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

addUserSelectedFolder()

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

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

پارامترها

• تماس برگشتی

  تابع

  پارامتر callback به شکل زیر است:

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

  • سیستم‌های فایل رسانه‌ای

    سیستم فایل DOMFy[]

  • نام فایل سیستم انتخاب شده

    رشته

getMediaFileSystemMetadata()

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

دریافت فراداده (metadata) در مورد یک سیستم فایل رسانه‌ای خاص.

پارامترها

• سیستم فایل رسانه‌ای

  سیستم فایل DOMF

بازگشت‌ها

• MediaFileSystemفراداده | تعریف نشده

getMediaFileSystems()

وعده

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

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

پارامترها

• جزئیات

  جزئیات سیستم‌های فایل رسانه‌ای (اختیاری)

• تماس برگشتی

  تابع اختیاری

  پارامتر callback به شکل زیر است:

  (mediaFileSystems: DOMFileSystem[]) => void

  • سیستم‌های فایل رسانه‌ای

    سیستم فایل DOMFy[]

بازگشت‌ها

• قول <DOMFileSystem[]>

  کروم ۱۱۶+

  Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

getMetadata()

وعده

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

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

پارامترها

• مدیافایل

  لکه

• گزینه‌ها

  گزینه‌های رسانه، فراداده (اختیاری)

• تماس برگشتی

  تابع اختیاری

  پارامتر callback به شکل زیر است:

  (metadata: MediaMetadata) => void

  • فراداده

    رسانهفراداده

بازگشت‌ها

• قول< MediaMetadata >

  کروم ۱۱۶+

  Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

removeGalleryWatch()

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

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

پارامترها

• شناسه گالری

  رشته

رویدادها

onGalleryChanged

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

زمانی اجرا می‌شود که گالری رسانه تغییر کند یا ساعت گالری حذف شود.

پارامترها

• تماس برگشتی

  تابع

  پارامتر callback به شکل زیر است:

  (details: GalleryChangeDetails) => void

  • جزئیات

    گالریتغییرجزئیات