chrome.mediaГалереи

Описание

Используйте API chrome.mediaGalleries для доступа к медиафайлам (аудио, изображениям, видео) с локальных дисков пользователя (с согласия пользователя).

Разрешения

mediaGalleries

Типы

AddGalleryWatchResult

Характеристики

  • Идентификатор галереи

    нить

  • успех

    логическое значение

GalleryChangeDetails

Характеристики

  • Идентификатор галереи

    нить

    Идентифицирует измененную галерею.

  • Тип события изменения.

GalleryChangeType

Перечисление

"contents_changed"
Содержимое галереи изменилось.

"watch_dropped"
Часы были уронены из-за отсоединения устройства, удаления разрешения галереи или по какой-либо другой причине.

GetMediaFileSystemsInteractivity

Перечисление

"нет"
Не действуйте интерактивно.

"да"
Попросите пользователя управлять разрешенными медиа-галереями.

"если_нужно"
Попросите пользователя управлять разрешенными галереями только в том случае, если в противном случае возвращаемый набор будет пуст.

GetMetadataType

Перечисление

"все"
Получите тип mime, теги метаданных и прикрепленные изображения.

"mimeTypeAndTags"
Получите только тип mime и теги метаданных.

"mimeTypeOnly"
Получить только тип mime.

MediaFileSystemMetadata

Характеристики

  • идентификатор устройства

    строка необязательна

    Если медиагалерея находится на съемном устройстве, уникальный идентификатор устройства, пока оно находится в сети.

  • Идентификатор галереи

    нить

    Уникальный и постоянный идентификатор медиа-галереи.

  • доступен

    логическое значение

    Истинно, если устройство доступно в данный момент.

  • isMediaDevice

    логическое значение

    Значение true, если устройство, на котором находится медиа-галерея, было обнаружено как мультимедийное устройство. т. е. присутствует устройство PTP или MTP или каталог DCIM.

  • isRemovable

    логическое значение

    Верно, если медиа-галерея находится на съемном устройстве.

  • имя

    нить

    Имя файловой системы.

MediaFileSystemsDetails

Характеристики

  • интерактивный

    GetMediaFileSystemsInteractivity необязательно.

    Следует ли запрашивать у пользователя разрешение на доступ к дополнительным медиагалереям перед возвратом разрешенного набора. По умолчанию молчит. Если передано значение «да» или если приложению не предоставлен доступ к каким-либо медиа-галереям и передано значение «if_needed», то будет отображено диалоговое окно настройки медиа-галереи.

MediaMetadata

Характеристики

  • альбом

    строка необязательна

    Определено для аудио и видео.

  • художник

    строка необязательна

  • прикрепленные изображения

    Блоб[]

    Изображения, встроенные в метаданные медиафайла. Чаще всего это используется для обложек альбомов или миниатюр видео.

  • комментарий

    строка необязательна

  • авторское право

    строка необязательна

  • диск

    номер необязательно

  • продолжительность

    номер необязательно

    Определено для аудио и видео. В секундах.

  • жанр

    строка необязательна

  • высота

    номер необязательно

    Определено для видео. В пикселях.

  • язык

    строка необязательна

  • mimeType

    нить

    Браузер распознавал тип mime.

  • сырые теги

    StreamInfo []

    Все метаданные в медиафайле. Для форматов с несколькими потоками порядок потоков будет сохранен. Метаданные контейнера — это первый элемент.

  • вращение

    номер необязательно

    Определено для видео. В градусах.

  • заголовок

    строка необязательна

  • отслеживать

    номер необязательно

  • ширина

    номер необязательно

MediaMetadataOptions

Характеристики

  • тип метаданных

    GetMetadataType необязательно

    Указывает, какое подмножество метаданных необходимо получить. По умолчанию установлено значение «все», если этот параметр опущен.

StreamInfo

Характеристики

  • теги

    объект

    Нефильтрованный строковый->строчный словарь тегов для потока.

  • тип

    нить

    Описывает формат контейнера или кодека потока, например «mp3», «h264».

Методы

addGalleryWatch()

Обещать
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

Добавляет наблюдение за галереей с указанным идентификатором галереи. Затем данный обратный вызов запускается с успешным или неудачным результатом.

Параметры

Возврат

  • Обещание <AddGalleryWatchResult>

    Хром 116+

    Промисы поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Предоставьте пользователю средство выбора каталога и добавьте выбранный каталог в качестве галереи. Если пользователь отменяет выбор, selectedFileSystemName будет пустым. Для отображения диалогового окна требуется жест пользователя. Без жеста пользователя обратный вызов будет выполняться так, как если бы пользователь отменил операцию.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

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

    • медиафайловые системы

      DOMFileSystem[]

    • выбранноеимя_файловой_системы

      нить

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Получите метаданные о конкретной файловой системе мультимедиа.

Параметры

  • медиафайловаясистема

    DOMFileSystem

Возврат

getMediaFileSystems()

Обещать
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

Настройте медиагалереи в этом пользовательском агенте. Если ни один из них не настроен или не доступен, обратный вызов получит пустой массив.

Параметры

  • подробности

    MediaFileSystemsDetails необязательно

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • медиафайловые системы

      DOMFileSystem[]

Возврат

  • Обещание<DOMFileSystem[]>

    Хром 116+

    Промисы поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getMetadata()

Обещать
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

Получает метаданные, относящиеся к медиафайлу, для медиафайла. Это должно работать для файлов в медиа-галереях, а также для других файловых систем DOM.

Параметры

Возврат

  • Обещание< МедиаМетаданные >

    Хром 116+

    Промисы поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Удаляет наблюдение за галереей с указанным идентификатором галереи.

Параметры

  • идентификатор галереи

    нить

События

onGalleryChanged

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

Вызывается при изменении медиа-галереи или удалении наблюдения за галереей.

Параметры