chrome.mediaГалереи

Описание

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

Разрешения

mediaGalleries

Типы

AddGalleryWatchResult

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

  • galleryId

    нить

  • успех

    булев

GalleryChangeDetails

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

  • galleryId

    нить

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

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

GalleryChangeType

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

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

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

GetMediaFileSystemsInteractivity

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

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

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

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

GetMetadataType

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

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

"mimeTypeAndTags"
Извлечь только тип MIME и теги метаданных.

"mimeTypeOnly"
Извлечь только тип MIME.

MediaFileSystemMetadata

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

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

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

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

  • galleryId

    нить

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

  • доступно

    булев

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

  • isMediaDevice

    булев

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

  • съемный

    булев

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

  • имя

    нить

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

MediaFileSystemsDetails

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

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

    GetMediaFileSystemsInteractivity (необязательно)

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

MediaMetadata

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

  • альбом

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

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

  • художник

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

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

    Blob[]

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

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

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

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

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

  • диск

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

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

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

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

  • жанр

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

  • высота

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

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

  • язык

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

  • mimeType

    нить

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

  • rawTags

    StreamInfo []

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

  • вращение

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

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

  • заголовок

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

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

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

  • ширина

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

MediaMetadataOptions

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

  • metadataType

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

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

StreamInfo

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

  • теги

    объект

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

  • тип

    нить

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

Методы

addGalleryWatch()

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

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

Параметры

  • galleryId

    нить

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

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

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

    (result: AddGalleryWatchResult) => void

Возврат

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

    Хром 116+

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

addUserSelectedFolder()

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

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

Параметры

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

    функция

    Параметр 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 выглядит так: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Возврат

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

    Хром 116+

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

getMetadata()

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

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

Параметры

  • медиафайл

    Клякса

  • параметры

    MediaMetadataOptions (необязательно)

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

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

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

    (metadata: MediaMetadata) => void

Возврат

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

    Хром 116+

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

removeGalleryWatch()

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

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

Параметры

  • galleryId

    нить

События

onGalleryChanged

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

Срабатывает при изменении медиагалереи или прекращении просмотра галереи.

Параметры