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,
)

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

مولفه های

برمی گرداند

  • Chrome 116+

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

مولفه های

  • پاسخ به تماس

    تابع

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

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

    • mediaFileSystems

      DOMFileSystem[]

    • انتخاب FileSystemName

      رشته

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

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

مولفه های

  • mediaFileSystem

    DOMFileSystem

برمی گرداند

getMediaFileSystems()

وعده
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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

مولفه های

  • جزئیات

    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,
)

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

مولفه های

  • mediaFile

    لکه

  • گزینه ها

    MediaMetadataOptions اختیاری است

  • پاسخ به تماس

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

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

    (metadata: MediaMetadata)=>void

برمی گرداند

  • Promise< MediaMetadata >

    Chrome 116+

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

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

مولفه های

  • شناسه گالری

    رشته

مناسبت ها

onGalleryChanged

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

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

مولفه های