الوصف
استخدام chrome.mediaGalleries
API للوصول إلى ملفات الوسائط (الصوت والصور والفيديو) من الأقراص المحلية للمستخدم (بموافقة المستخدم)
الأذونات
mediaGalleries
الأنواع
AddGalleryWatchResult
أماكن إقامة
-
galleryId
سلسلة
-
النجاح
boolean
GalleryChangeDetails
أماكن إقامة
-
galleryId
سلسلة
تحدد المعرض المعدَّل.
-
كتابة
نوع حدث التغيير.
GalleryChangeType
التعداد
"contents_changed"
تم تغيير محتوى المعرض.
"watch_dropped"
أنه تم إسقاط الساعة بسبب فصل الجهاز أو إزالة إذن معرض الصور أو أي سبب آخر.
GetMediaFileSystemsInteractivity
التعداد
"لا"
يُرجى عدم التصرّف بشكل تفاعلي.
"yes"
اطلب من المستخدم إدارة معارض الوسائط المسموح بها.
"if_needed"
اطلب من المستخدم إدارة المعارض المسموح بها فقط إذا كانت مجموعة الإرجاع فارغة.
GetMetadataType
التعداد
"all"
استرداد نوع MIME وعلامات البيانات الوصفية والصور المرفقة
"mimeTypeAndTags"
استرداد نوع mime وعلامات البيانات الوصفية فقط
"mimeTypeOnly"
استرداد نوع mime فقط
MediaFileSystemMetadata
أماكن إقامة
-
deviceId
سلسلة اختيارية
إذا كان معرض الوسائط على جهاز قابل للإزالة، معرّف فريد للجهاز عندما يكون الجهاز متصلاً بالإنترنت.
-
galleryId
سلسلة
معرّف فريد وثابت لمعرض الوسائط.
-
isAvailable
boolean
True إذا كان الجهاز متاحًا حاليًا.
-
isMediaDevice
boolean
صحيح إذا تم اكتشاف الجهاز الذي يوجد به معرض الوسائط كجهاز وسائط، أي جهاز PTP أو MTP أو دليل DCIM موجود.
-
isRemovable
boolean
صحيح إذا كان معرض الوسائط على جهاز قابل للإزالة.
-
اسم
سلسلة
اسم نظام الملفات.
MediaFileSystemsDetails
أماكن إقامة
-
تفاعلي
GetMediaFileSystemsInteractivity اختيارية
لتحديد ما إذا كنت تريد مطالبة المستخدم بالحصول على إذن للوصول إلى معارض وسائط إضافية قبل عرض المجموعة المسموح بها. الإعداد التلقائي هو الوضع الصامت. إذا تم تمرير القيمة "نعم"، أو لم يتم منح التطبيق إمكانية الوصول إلى أي معارض وسائط وتم تمرير القيمة "if_needed"، فسيتم عندها عرض مربع حوار تهيئة معرض الوسائط.
MediaMetadata
أماكن إقامة
-
album
سلسلة اختيارية
محددة للصوت والفيديو.
-
الفنان
سلسلة اختيارية
-
attachedImages
النقطة[]
الصور المضمّنة في البيانات الوصفية لملف الوسائط. وغالبًا ما يتم استخدام هذه الصورة لغلاف الألبوم أو الصور المصغّرة للفيديوهات.
-
تعليق
سلسلة اختيارية
-
حقوق الطبع والنشر
سلسلة اختيارية
-
إسطوانة
الرقم اختياري
-
المدة
الرقم اختياري
محددة للصوت والفيديو. ثوانٍ.
-
النوع
سلسلة اختيارية
-
الطول
الرقم اختياري
محددة للفيديو. بالبكسل
-
language
سلسلة اختيارية
-
mimeType
سلسلة
اكتشف المتصفح نوع MIME.
-
rawTags
كل البيانات الوصفية في ملف الوسائط أما بالنسبة إلى التنسيقات التي تتضمّن عدة أحداث بث، فسيتم الاحتفاظ بترتيب البث المباشر. العنصر الأول هو البيانات الوصفية للحاويات.
-
دوران
الرقم اختياري
محددة للفيديو. بالدرجات.
-
title
سلسلة اختيارية
-
أغنية
الرقم اختياري
-
العرض
الرقم اختياري
MediaMetadataOptions
أماكن إقامة
-
metadataType
GetMetadataType اختيارية
تحدّد المجموعة الفرعية من البيانات الوصفية المطلوب استردادها. يتم ضبط القيمة تلقائيًا على "الكل" في حال حذف الخيار.
StreamInfo
أماكن إقامة
-
الإشارات
عنصر
قاموس سلسلة->سلسلة لم تتم تصفيته للعلامات الخاصة بساحة المشاركات.
-
كتابة
سلسلة
تصِف تنسيق حاوية أو برنامج ترميز البث، أي "mp3" أو "h264".
الطُرق
addGalleryWatch()
chrome.mediaGalleries.addGalleryWatch(
galleryId: string,
callback?: function,
)
لإضافة ساعة معرض للمعرض باستخدام رقم تعريف المعرض المحدّد بعد ذلك، يتم تنشيط رد الاتصال المقدم بنتيجة نجاح أو إخفاق.
المَعلمات
-
galleryId
سلسلة
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: AddGalleryWatchResult) => void
-
نتيجة
-
المرتجعات
-
Promise<AddGalleryWatchResult>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
addUserSelectedFolder()
chrome.mediaGalleries.addUserSelectedFolder(
callback: function,
)
قدِّم منتقي الدليل للمستخدم وأضِف الدليل المحدَّد كمعرض. وإذا ألغى المستخدم أداة الاختيار، سيكون selectFileSystemName فارغًا. يجب استخدام إيماءة المستخدم حتى يتم عرض مربّع الحوار. بدون إيماءة المستخدم، ستتم إعادة الاتصال كما لو كان المستخدم قد ألغى الاتصال.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void
-
mediaFileSystems
نظام DOMFileSystem[]
-
selectedFileSystemName
سلسلة
-
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 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getMetadata()
chrome.mediaGalleries.getMetadata(
mediaFile: Blob,
options?: MediaMetadataOptions,
callback?: function,
)
يمكن الحصول على البيانات الوصفية الخاصة بالوسائط لملف وسائط. ومن المفترض أن ينجح ذلك مع الملفات الموجودة في معارض الوسائط بالإضافة إلى أنظمة ملفات DOM الأخرى.
المَعلمات
-
mediaFile
بلوب
-
الخيارات
MediaMetadataOptions اختيارية
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(metadata: MediaMetadata) => void
-
البيانات الوصفية
-
المرتجعات
-
Promise<MediaMetadata>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
removeGalleryWatch()
chrome.mediaGalleries.removeGalleryWatch(
galleryId: string,
)
إزالة ساعة معرض الصور للمعرض الذي يتضمَّن رقم تعريف المعرض المحدَّد.
المَعلمات
-
galleryId
سلسلة
فعاليات
onGalleryChanged
chrome.mediaGalleries.onGalleryChanged.addListener(
callback: function,
)
يتم تنشيطها عند تغيير معرض وسائط أو تجاهل ساعة معرض الصور.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(details: GalleryChangeDetails) => void
-
التفاصيل
-