chrome.mediaGalleries

الوصف

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

الأذونات

mediaGalleries

الأنواع

AddGalleryWatchResult

الخصائص

  • galleryId

    سلسلة

  • النجاح

    قيمة منطقية

GalleryChangeDetails

الخصائص

  • galleryId

    سلسلة

    تحدّد هذه السمة المعرض المعدَّل.

  • النوع

    GalleryChangeType

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

GalleryChangeType

Enum

"contents_changed"
تغيّرت محتويات المعرض.

‫"watch_dropped"
تمت إزالة الساعة لأنّ الجهاز تم فصله أو تمت إزالة إذن الوصول إلى معرض الصور أو لأي سبب آخر.

GetMediaFileSystemsInteractivity

Enum

"no"
لا تتفاعل بشكل تفاعلي.

yes
يُطلب من المستخدم إدارة معارض الوسائط المسموح بها.

"if_needed"
يُطلب من المستخدم إدارة المعارض المسموح بها فقط إذا كانت مجموعة النتائج ستكون فارغة في حال عدم إجراء ذلك.

GetMetadataType

Enum

"all"
لاسترداد نوع MIME وعلامات البيانات الوصفية والصور المرفقة

"mimeTypeAndTags"
لاسترداد نوع MIME وعلامات البيانات الوصفية فقط.

"mimeTypeOnly"
لاسترداد نوع MIME فقط.

MediaFileSystemMetadata

الخصائص

  • deviceId

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

    إذا كانت معرض الوسائط على جهاز قابل للإزالة، يكون هذا المعرّف فريدًا للجهاز أثناء اتصاله بالإنترنت.

  • galleryId

    سلسلة

    معرّف فريد وثابت لمعرض الوسائط.

  • isAvailable

    قيمة منطقية

    تكون القيمة صحيحة إذا كان الجهاز متاحًا حاليًا.

  • isMediaDevice

    قيمة منطقية

    تكون القيمة "صحيح" إذا تم رصد الجهاز الذي يتم عرض معرض الوسائط عليه كجهاز وسائط، أي جهاز PTP أو MTP، أو إذا كان دليل DCIM متوفّرًا.

  • isRemovable

    قيمة منطقية

    تكون القيمة "صحيح" إذا كان معرض الوسائط على جهاز قابل للإزالة.

  • الاسم

    سلسلة

    تمثّل هذه السمة اسم نظام الملفات.

MediaFileSystemsDetails

الخصائص

  • تفاعلي

    GetMediaFileSystemsInteractivity اختياري

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

MediaMetadata

الخصائص

  • ألبوم

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

    يتم تحديدها للصوت والفيديو.

  • الفنان

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

  • attachedImages

    Blob[]

    الصور المضمّنة في البيانات الوصفية لملف الوسائط ويُستخدَم هذا النوع غالبًا لصور الألبومات أو الصور المصغّرة للفيديوهات.

  • تعليق

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

  • حقوق الطبع والنشر

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

  • إسطوانة

    number اختياري

  • المدة

    number اختياري

    يتم تحديدها للصوت والفيديو. بالثواني

  • النوع

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

  • الطول

    number اختياري

    يتم تحديدها للفيديو. بالبكسل

  • language

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

  • mimeType

    سلسلة

    نوع MIME الذي رصده المتصفّح.

  • rawTags

    StreamInfo[]

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

  • التدوير

    number اختياري

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

  • title

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

  • أغنية

    number اختياري

  • العرض

    number اختياري

MediaMetadataOptions

الخصائص

  • metadataType

    GetMetadataType اختياري

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

StreamInfo

الخصائص

  • الإشارات

    عنصر

    قاموس غير مفلتر من العلامات التي تتضمّن سلاسل نصية للتدفق.

  • النوع

    سلسلة

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

الطُرق

addGalleryWatch()

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

تضيف هذه السمة زر مشاهدة المعرض إلى المعرض الذي يحمل رقم التعريف المحدّد. يتم بعد ذلك تشغيل رد الاتصال المحدّد مع نتيجة النجاح أو الفشل.

المعلمات

المرتجعات

  • الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

addUserSelectedFolder()

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

اعرض أداة اختيار دليل للمستخدم وأضِف الدليل المحدّد كمعرض. إذا ألغى المستخدم أداة الاختيار، سيكون selectedFileSystemName فارغًا. يجب أن يتخذ المستخدم إجراءً ليتم عرض مربّع الحوار. بدون إيماءة من المستخدم، سيتم تنفيذ دالة الرجوع كما لو أنّ المستخدم ألغى العملية.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      سلسلة

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

الحصول على بيانات وصفية حول نظام ملفات وسائط معيّن

المعلمات

  • mediaFileSystem

    DOMFileSystem

المرتجعات

getMediaFileSystems()

الوعد 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

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

المعلمات

  • التفاصيل

    MediaFileSystemsDetails اختياري

  • callback

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

    تظهر المَعلمة callback على النحو التالي: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

المرتجعات

  • Promise<DOMFileSystem[]>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

getMetadata()

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

تعرض هذه الطريقة البيانات الوصفية الخاصة بملف وسائط. من المفترض أن يعمل ذلك مع الملفات في معارض الوسائط بالإضافة إلى أنظمة ملفات DOM الأخرى.

المعلمات

  • mediaFile

    بلوب

  • الخيارات

    MediaMetadataOptions اختياري

  • callback

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

    تظهر المَعلمة callback على النحو التالي: 

    (metadata: MediaMetadata) => void

المرتجعات

  • Promise<MediaMetadata>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

removeGalleryWatch()

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

تزيل هذه الطريقة عملية مراقبة معرض الصور الذي يحمل رقم التعريف المحدّد.

المعلمات

  • galleryId

    سلسلة

الفعاليات

onGalleryChanged

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

يتم تنشيط هذا الحدث عند تغيير معرض وسائط أو إيقاف مراقبة معرض.

المعلمات