chrome.mediaGalleries

Opis

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

Uprawnienia

mediaGalleries

Typy

AddGalleryWatchResult

Właściwości

  • galleryId

    string,

  • sukces

    boolean

GalleryChangeDetails

Właściwości

  • galleryId

    string,

    Identyfikuje zmodyfikowaną galerię.

  • Typ zdarzenia zmiany.

GalleryChangeType

Enum

"contents_changed"
Zawartość galerii uległa zmianie.

"watch_dropped"
Zegarek został usunięty, ponieważ zostało odłączone, usunięto uprawnienia do galerii lub z innego powodu.

GetMediaFileSystemsInteractivity

Enum

"no"
Nie podejmuj działań interaktywnych.

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

"if_needed"
Poproś użytkownika, aby zarządzał dozwolonymi galeriami tylko wtedy, gdy zbiór zwracany byłby pusty.

GetMetadataType

Enum

"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

    ciąg znaków opcjonalny

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

  • galleryId

    string,

    Niepowtarzalny i trwały identyfikator galerii multimediów.

  • isAvailable

    boolean

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

  • isMediaDevice

    boolean

    Wartość to „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 albo znajduje się katalog DCIM).

  • isRemovable

    boolean

    Prawda, jeśli galeria multimediów znajduje się na urządzeniu wymiennym.

  • nazwa

    string,

    Nazwa systemu plików.

MediaFileSystemsDetails

Właściwości

  • interaktywny

    GetMediaFileSystemsInteractivity (opcjonalnie).

    Określa, czy przed zwróceniem dozwolonego zbioru prosisz użytkownika o pozwolenie na dodatkowe galerie multimediów. Domyślnie jest ciche. Jeśli wartość „yes” zostanie przekazana lub aplikacja nie otrzymała dostępu do żadnej galerii multimediów, a wartość „if_needed” zostanie przekazana, wyświetli się okno konfiguracji galerii multimediów.

MediaMetadata

Właściwości

  • album

    ciąg znaków opcjonalny

    Zdefiniowany na potrzeby audio i wideo.

  • wykonawca

    ciąg znaków opcjonalny

  • attachedImages

    Blob[]

    Obrazy umieszczone w metadanych pliku multimedialnego. Najczęściej jest używany w przypadku okładki albumów lub miniatur filmów.

  • komentarz

    ciąg znaków opcjonalny

  • Prawa autorskie

    ciąg znaków opcjonalny

  • płyta

    Liczba opcjonalnie

  • czas trwania

    Liczba opcjonalnie

    Zdefiniowany na potrzeby audio i wideo. W sekundach.

  • gatunek

    ciąg znaków opcjonalny

  • wysokość

    Liczba opcjonalnie

    Zdefiniowany na potrzeby wideo. W pikselach.

  • language,

    ciąg znaków opcjonalny

  • mimeType

    string,

    Przeglądarka rozpoznała typ MIME.

  • rawTags

    StreamInfo[]

    Wszystkie metadane w pliku multimedialnym. W przypadku formatów z wieloma strumieniami kolejność strumieni jest zachowywana. Pierwszym elementem są metadane kontenera.

  • obrót

    Liczba opcjonalnie

    Zdefiniowany na potrzeby wideo. W stopniach

  • title

    ciąg znaków opcjonalny

  • monitoruj

    Liczba opcjonalnie

  • szerokość

    Liczba opcjonalnie

MediaMetadataOptions

Właściwości

  • metadataType

    GetMetadataType opcjonalnie

    Określa podzbiór metadanych do pobrania. Jeśli ta opcja zostanie pominięta, stosowana jest domyślna wartość „all”.

StreamInfo

Właściwości

  • tagi

    obiekt

    Niefiltrowany słownik ciągu znaków> dla tagów strumienia.

  • typ

    string,

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

Metody

addGalleryWatch()

Obietnica 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

Dodaje zegarek z galerią o określonym identyfikatorze galerii. Podane wywołanie zwrotne jest następnie uruchamiane z powodu powodzenia lub niepowodzenia.

Parametry

Akcje powrotne

  • Chrome 116 i nowsze wersje

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Wyświetl użytkownikowi selektor katalogu i dodaj wybrany katalog jako galerię. Jeśli użytkownik anuluje selektor, element selectedFileSystemName będzie pusty. Do wyświetlenia okna wymagany jest gest użytkownika. Bez gestu użytkownika wywołanie zwrotne będzie działać tak, jakby użytkownik je anulował.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      string,

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Uzyskiwanie metadanych dotyczących określonego systemu plików multimedialnych.

Parametry

  • mediaFileSystem

    DOMFileSystem

Akcje powrotne

getMediaFileSystems()

Obietnica 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

Pobierz galerie multimediów skonfigurowane przez tego klienta użytkownika. Jeśli żadna nie jest skonfigurowana ani dostępna, wywołanie zwrotne otrzyma pustą tablicę.

Parametry

  • szczegóły

    MediaFileSystemsDetails opcjonalnie

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (mediaFileSystems: DOMFileSystem[])=>void

    • mediaFileSystems

      DOMFileSystem[]

Akcje powrotne

  • Promise<DOMFileSystem[]>

    Chrome 116 i nowsze wersje

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

getMetadata()

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

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

Parametry

Akcje powrotne

  • Promise<MediaMetadata>

    Chrome 116 i nowsze wersje

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Usuwa zegarek z galerii o określonym identyfikatorze galerii.

Parametry

  • galleryId

    string,

Wydarzenia

onGalleryChanged

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

Uruchamiane po zmianie galerii multimediów lub usunięciu zegarka z galerii.

Parametry