chrome.mediaGalleries

الوصف

استخدام chrome.mediaGalleries API للوصول إلى ملفات الوسائط (الصوت والصور والفيديو) من الأقراص المحلية للمستخدم (بموافقة المستخدم)

الأذونات

mediaGalleries

الأنواع

AddGalleryWatchResult

أماكن إقامة

  • galleryId

    سلسلة

  • نجاح

    boolean

GalleryChangeDetails

أماكن إقامة

  • galleryId

    سلسلة

    تحدد المعرض المعدَّل.

  • كتابة

    GalleryChangeType

    نوع حدث التغيير.

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

    StreamInfo[]

    كل البيانات الوصفية في ملف الوسائط أما بالنسبة إلى التنسيقات التي تتضمّن عدة أحداث بث، فسيتم الاحتفاظ بترتيب البث المباشر. العنصر الأول هو البيانات الوصفية للحاويات.

  • دوران

    الرقم اختياري

    محددة للفيديو. بالدرجات.

  • title

    سلسلة اختيارية

  • تتبُّع

    الرقم اختياري

  • العرض

    الرقم اختياري

MediaMetadataOptions

أماكن إقامة

  • metadataType

    GetMetadataType اختيارية

    تحدّد المجموعة الفرعية من البيانات الوصفية المطلوب استردادها. يتم ضبط القيمة تلقائيًا على "الكل" في حال حذف الخيار.

StreamInfo

أماكن إقامة

  • الإشارات

    كائن

    قاموس سلسلة->سلسلة لم تتم تصفيته للعلامات الخاصة بساحة المشاركات.

  • كتابة

    سلسلة

    تصِف تنسيق حاوية أو برنامج ترميز البث، أي "mp3" أو "h264".

الطُرق

addGalleryWatch()

وعد 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

لإضافة ساعة معرض للمعرض باستخدام رقم تعريف المعرض المحدّد بعد ذلك، يتم تنشيط رد الاتصال المقدم بنتيجة نجاح أو إخفاق.

المَعلمات

  • galleryId

    سلسلة

  • معاودة الاتصال

    الدالة اختيارية

    تبدو معلَمة callback على النحو التالي: 

    (result: AddGalleryWatchResult)=>void

المرتجعات

  • 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

المرتجعات

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

يتم تنشيطها عند تغيير معرض وسائط أو تجاهل ساعة معرض الصور.

المَعلمات