chrome.mediaGalleries

الوصف

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

الأذونات

mediaGalleries

الأنواع

AddGalleryWatchResult

أماكن إقامة

  • galleryId

    سلسلة

  • النجاح

    منطقي

GalleryChangeDetails

أماكن إقامة

  • galleryId

    سلسلة

    يحدد المعرض الذي تم تعديله.

  • كتابة

    GalleryChangeType

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

GalleryChangeType

Enum

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

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

GetMediaFileSystemsInteractivity

Enum

"لا"
يُرجى عدم التصرّف بشكل تفاعلي.

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

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

GetMetadataType

Enum

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

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

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

MediaFileSystemMetadata

أماكن إقامة

  • deviceId

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

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

  • galleryId

    سلسلة

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

  • متوفّر

    منطقي

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

  • isMediaDevice

    منطقي

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

  • isRemovable

    منطقي

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

  • الاسم

    سلسلة

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

MediaFileSystemsDetails

أماكن إقامة

  • تفاعلي

    GetMediaFileSystemsInteractivity اختياري

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

MediaMetadata

أماكن إقامة

  • ألبوم

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

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

  • الفنان

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

  • 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

المرتجعات

  • Promise<AddGalleryWatchResult>

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

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة 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[]>

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

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

getMetadata()

وعود 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

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

المعلمات

  • mediaFile

    بلوب

  • الخيارات

    MediaMetadataOptions اختيارية

  • رد الاتصال

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

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

    (metadata: MediaMetadata) => void

المرتجعات

  • Promise<MediaMetadata>

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

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

إزالة مشاهدة معرض الصور من المعرض باستخدام رقم تعريف المعرض المحدّد.

المعلمات

  • galleryId

    سلسلة

فعاليات

onGalleryChanged

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

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

المعلمات