chrome.mediaGallery

توضیحات

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

مجوزها

mediaGalleries

انواع

AddGalleryWatchResult

خواص

  • شناسه گالری

    رشته

  • موفقیت

    بولی

GalleryChangeDetails

خواص

  • شناسه گالری

    رشته

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

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

GalleryChangeType

Enum

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

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

GetMediaFileSystemsInteractivity

Enum

"نه"
تعاملی عمل نکنید.

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

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

GetMetadataType

Enum

"همه"
نوع مایم، تگ های فراداده و تصاویر پیوست را بازیابی کنید.

"mimeTypeAndTags"
فقط نوع mime و تگ های فراداده را بازیابی کنید.

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

MediaFileSystemMetadata

خواص

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

    رشته اختیاری

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

  • شناسه گالری

    رشته

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

  • موجود است

    بولی

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

  • isMediaDevice

    بولی

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

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

    بولی

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

  • نام

    رشته

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

MediaFileSystemsDetails

خواص

  • تعاملی

    GetMediaFileSystemsInteractivity اختیاری است

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

MediaMetadata

خواص

  • آلبوم

    رشته اختیاری

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

  • هنرمند

    رشته اختیاری

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

    لکه[]

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

  • نظر دادن

    رشته اختیاری

  • کپی رایت

    رشته اختیاری

  • دیسک

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

  • مدت

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

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

  • ژانر

    رشته اختیاری

  • ارتفاع

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

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

  • زبان

    رشته اختیاری

  • mimeType

    رشته

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

  • rawTags

    StreamInfo []

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

  • چرخش

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

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

  • عنوان

    رشته اختیاری

  • مسیر

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

  • عرض

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

MediaMetadataOptions

خواص

  • نوع فراداده

    GetMetadataType اختیاری است

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

StreamInfo

خواص

  • برچسب ها

    شی

    یک فرهنگ لغت برچسب های رشته ای بدون فیلتر برای جریان.

  • نوع

    رشته

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

روش ها

addGalleryWatch()

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

یک ساعت گالری برای گالری با شناسه گالری مشخص شده اضافه می کند. سپس فراخوان داده شده با نتیجه موفقیت آمیز یا شکست آغاز می شود.

پارامترها

برمی گرداند

  • Chrome 116+

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

addUserSelectedFolder()

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

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

پارامترها

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • انتخاب FileSystemName

      رشته

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 116+

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

getMetadata()

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

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

پارامترها

  • mediaFile

    لکه

  • گزینه ها

    MediaMetadataOptions اختیاری است

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (metadata: MediaMetadata) => void

برمی گرداند

  • Promise< MediaMetadata >

    Chrome 116+

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

removeGalleryWatch()

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

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

پارامترها

  • شناسه گالری

    رشته

رویدادها

onGalleryChanged

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

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

پارامترها