شرح
از chrome.mediaGalleries
API برای دسترسی به فایلهای رسانه (صوت، تصاویر، ویدیو) از دیسکهای محلی کاربر (با رضایت کاربر) استفاده کنید.
مجوزها
mediaGalleries
انواع
AddGalleryWatchResult
خواص
- شناسه گالری
رشته
- موفقیت
بولی
GalleryChangeDetails
خواص
- شناسه گالری
رشته
گالری اصلاح شده را شناسایی می کند.
نوع رویداد تغییر
GalleryChangeType
Enum
"contents_changed" "watch_dropped"
محتوای گالری تغییر کرده است.
ساعت حذف شده است زیرا دستگاه جدا شده است، مجوز گالری حذف شده است، یا هر دلیل دیگری.
GetMediaFileSystemsInteractivity
Enum
"نه" "آره" "اگر_نیاز باشد"
تعاملی عمل نکنید.
از کاربر بخواهید گالری های رسانه ای مجاز را مدیریت کند.
از کاربر بخواهید که گالری های مجاز را فقط در صورتی مدیریت کند که مجموعه بازگشتی در غیر این صورت خالی باشد.
GetMetadataType
Enum
"همه" "mimeTypeAndTags" "mimeTypeOnly"
نوع مایم، تگ های فراداده و تصاویر پیوست را بازیابی کنید.
فقط نوع mime و تگ های فراداده را بازیابی کنید.
فقط نوع 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,
)
یک ساعت گالری برای گالری با شناسه گالری مشخص شده اضافه می کند. سپس فراخوان داده شده با نتیجه موفقیت آمیز یا شکست آغاز می شود.
مولفه های
- شناسه گالری
رشته
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(result: AddGalleryWatchResult) => void
- نتیجه
برمی گرداند
Promise< AddGalleryWatchResult >
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
برمی گرداند
MediaFileSystemMetadata | تعریف نشده
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,
)
هنگامی که گالری رسانه تغییر می کند یا ساعت گالری رها می شود، فعال می شود.
مولفه های
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(details: GalleryChangeDetails) => void
- جزئیات