chrome.mediaGalleries

الوصف

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

الأذونات

mediaGalleries

مدى التوفّر

نظام التشغيل ChromeOS فقط

الأنواع

AddGalleryWatchResult

الخصائص

  • galleryId

    سلسلة

  • نجاح

    قيمة منطقية

GalleryChangeDetails

الخصائص

  • galleryId

    سلسلة

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

  • النوع

    GalleryChangeType

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

GalleryChangeType

Enum

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

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

GetMediaFileSystemsInteractivity

Enum

"no"
لا يتم تنفيذ الإجراء بشكل تفاعلي.

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

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

GetMetadataType

Enum

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

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

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

MediaFileSystemMetadata

الخصائص

  • deviceId

    string اختياري

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

  • galleryId

    سلسلة

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

  • isAvailable

    قيمة منطقية

    "صحيح" إذا كان الجهاز متاحًا حاليًا

  • isMediaDevice

    قيمة منطقية

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

  • isRemovable

    قيمة منطقية

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

  • الاسم

    سلسلة

    اسم نظام الملفات

MediaFileSystemsDetails

الخصائص

  • تفاعلي

    GetMediaFileSystemsInteractivity اختيارية

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

MediaMetadata

الخصائص

  • ألبوم

    string اختياري

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

  • الفنان

    string اختياري

  • attachedImages

    Blob[]‎

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

  • تعليق

    string اختياري

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

    string اختياري

  • إسطوانة

    number اختيارية

  • المدة

    number اختيارية

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

  • النوع

    string اختياري

  • الارتفاع

    number اختيارية

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

  • language

    string اختياري

  • mimeType

    سلسلة

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

  • rawTags

    StreamInfo[]

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

  • دوران

    number اختيارية

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

  • title

    string اختياري

  • أغنية

    number اختيارية

  • العرض

    number اختيارية

MediaMetadataOptions

الخصائص

  • metadataType

    GetMetadataType اختياري

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

StreamInfo

الخصائص

  • الإشارات

    عنصر

    قاموس غير مفلتر من السلاسل النصية إلى السلاسل النصية للعلامات الخاصة بالبث.

  • النوع

    سلسلة

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

الطُرق

addGalleryWatch()

Promise 
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()

Promise 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

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

المعلمات

  • التفاصيل

    ‫MediaFileSystemsDetails اختياري

  • callback

    function اختياري

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]‎

المرتجعات

  • وعد<نظام ملفات DOM[]>

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

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

getMetadata()

Promise 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
): Promise<MediaMetadata>

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

المعلمات

  • mediaFile

    بلوب

  • الخيارات

    MediaMetadataOptions اختياري

  • callback

    function اختياري

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

    (metadata: MediaMetadata) => void

المرتجعات

  • وعد<MediaMetadata>

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

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

removeGalleryWatch()

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

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

المعلمات

  • galleryId

    سلسلة

الفعاليات

onGalleryChanged

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

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

المعلمات