chrome.mediaGalleries

Opis

Używaj interfejsu chrome.mediaGalleries API, aby uzyskiwać dostęp do plików multimedialnych (audio, obrazów, wideo) z lokalnych dysków użytkownika (za jego zgodą).

Uprawnienia

mediaGalleries

Typy

AddGalleryWatchResult

Właściwości

  • galleryId

    ciąg znaków

  • sukces

    Wartość logiczna

GalleryChangeDetails

Właściwości

  • galleryId

    ciąg znaków

    Identyfikuje zmodyfikowaną galerię.

  • Typ zdarzenia zmiany.

GalleryChangeType

Typ wyliczeniowy

„contents_changed”
Zawartość galerii uległa zmianie.

„watch_dropped”
Zegarek został odłączony, uprawnienia do galerii zostały usunięte lub wystąpił inny powód.

GetMediaFileSystemsInteractivity

Typ wyliczeniowy

„nie”
Nie reaguj interaktywnie.

„yes”
Poproś użytkownika o zarządzanie dozwolonymi galeriami multimediów.

„if_needed”
Poproś użytkownika o zarządzanie dozwolonymi galeriami tylko wtedy, gdy w przeciwnym razie zwrócony zbiór byłby pusty.

GetMetadataType

Typ wyliczeniowy

"all"
Pobierz typ MIME, tagi metadanych i załączone obrazy.

„mimeTypeAndTags”
Pobierz tylko typ MIME i tagi metadanych.

„mimeTypeOnly”
Pobierz tylko typ MIME.

MediaFileSystemMetadata

Właściwości

  • deviceId

    string opcjonalny

    Jeśli galeria multimediów znajduje się na urządzeniu wymiennym, jest to unikalny identyfikator urządzenia, gdy jest ono online.

  • galleryId

    ciąg znaków

    Unikalny i trwały identyfikator galerii multimediów.

  • isAvailable

    Wartość logiczna

    Wartość Prawda, jeśli urządzenie jest obecnie dostępne.

  • isMediaDevice

    Wartość logiczna

    Wartość Prawda, jeśli urządzenie, na którym znajduje się galeria multimediów, zostało wykryte jako urządzenie multimedialne, np. urządzenie PTP lub MTP, lub jeśli zawiera katalog DCIM.

  • isRemovable

    Wartość logiczna

    Wartość „true” (prawda), jeśli galeria multimediów znajduje się na urządzeniu wymiennym.

  • nazwa

    ciąg znaków

    Nazwa systemu plików.

MediaFileSystemsDetails

Właściwości

  • interaktywny

    GetMediaFileSystemsInteractivity opcjonalnie

    Określa, czy przed zwróceniem dozwolonego zestawu należy poprosić użytkownika o zezwolenie na dostęp do dodatkowych galerii multimediów. Domyślnie jest wyciszony. Jeśli przekazana zostanie wartość „yes” lub jeśli aplikacja nie ma dostępu do żadnych galerii multimediów, a przekazana zostanie wartość „if_needed”, wyświetli się okno konfiguracji galerii multimediów.

MediaMetadata

Właściwości

  • album

    string opcjonalny

    Określone dla dźwięku i obrazu.

  • wykonawca

    string opcjonalny

  • attachedImages

    Blob[]

    Obrazy umieszczone w metadanych pliku multimedialnego. Jest to najczęściej używane w przypadku okładek albumów lub miniatur filmów.

  • komentarz

    string opcjonalny

  • Prawa autorskie

    string opcjonalny

  • płyta

    number opcjonalny

  • czas trwania

    number opcjonalny

    Określone dla dźwięku i obrazu. W sekundach.

  • gatunek

    string opcjonalny

  • wysokość

    number opcjonalny

    Zdefiniowane dla filmu. W pikselach.

  • language

    string opcjonalny

  • mimeType

    ciąg znaków

    Typ MIME wykryty przez przeglądarkę.

  • rawTags

    StreamInfo[]

    wszystkie metadane w pliku multimedialnym; W przypadku formatów z wieloma strumieniami kolejność strumieni zostanie zachowana. Metadane kontenera są pierwszym elementem.

  • obrót,

    number opcjonalny

    Zdefiniowane dla filmu. W stopniach.

  • tytuł

    string opcjonalny

  • utwór

    number opcjonalny

  • szerokość

    number opcjonalny

MediaMetadataOptions

Właściwości

  • metadataType

    GetMetadataType opcjonalny

    Określa podzbiór metadanych do pobrania. Jeśli ta opcja zostanie pominięta, domyślnie będzie używana wartość „all”.

StreamInfo

Właściwości

  • Tagi

    obiekt

    Niefiltrowany słownik tagów strumienia w formacie ciąg tekstowy – ciąg tekstowy.

  • typ

    ciąg znaków

    Opisuje format kontenera lub kodek strumienia, np. „mp3”, „h264”.

Metody

addGalleryWatch()

Obietnica 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
): Promise<AddGalleryWatchResult>

Dodaje zegarek galerii do galerii o podanym identyfikatorze. Następnie wywoływane jest podane wywołanie zwrotne z wynikiem powodzenia lub niepowodzenia.

Parametry

Zwroty

  • Chrome 116 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

addUserSelectedFolder()

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

Wyświetl użytkownikowi selektor katalogów i dodaj wybrany katalog jako galerię. Jeśli użytkownik anuluje selektor, wybrana nazwa pliku selectedFileSystemName będzie pusta. Aby wyświetlić okno, użytkownik musi wykonać gest. Bez gestu użytkownika wywołanie zwrotne zostanie uruchomione tak, jakby użytkownik anulował działanie.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      ciąg znaków

getMediaFileSystemMetadata()

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

Pobieranie metadanych dotyczących konkretnego systemu plików multimedialnych.

Parametry

  • mediaFileSystem

    DOMFileSystem

Zwroty

getMediaFileSystems()

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

Pobierz galerie multimediów skonfigurowane w tym agencie użytkownika. Jeśli żadne nie są skonfigurowane lub dostępne, funkcja zwrotna otrzyma pustą tablicę.

Parametry

  • szczegóły

    MediaFileSystemsDetails opcjonalny

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Zwroty

  • Promise<DOMFileSystem[]>

    Chrome 116 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getMetadata()

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

Pobiera metadane specyficzne dla multimediów w przypadku pliku multimedialnego. Powinno to działać w przypadku plików w galeriach multimediów, a także w innych systemach plików DOM.

Parametry

Zwroty

  • Promise<MediaMetadata>

    Chrome 116 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeGalleryWatch()

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

Usuwa obserwowanie galerii o określonym identyfikatorze.

Parametry

  • galleryId

    ciąg znaków

Wydarzenia

onGalleryChanged

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

Wysyłane, gdy galeria multimediów zostanie zmieniona lub zegarek z galerią zostanie upuszczony.

Parametry