chrome.mediaGalleries

Opis

Interfejs API chrome.mediaGalleries umożliwia dostęp do plików multimedialnych (dźwiękowych, graficznych i wideo) z dysków lokalnych 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ł usunięty z powodu odłączenia urządzenia, usunięcia uprawnień galerii lub innego powodu.

GetMediaFileSystemsInteractivity

Typ wyliczeniowy

"no"
Nie wolno podejmować 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 zwracany zestaw byłby pusty.

GetMetadataType

Typ wyliczeniowy

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

"mimeTypeAndTags"
Pobierz tylko typ MIME oraz 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, unikalny identyfikator urządzenia, gdy jest ono w trybie online.

  • galleryId

    ciąg znaków

    Unikalny i stały identyfikator galerii multimediów.

  • Dostępny

    wartość logiczna

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

  • isMediaDevice

    wartość logiczna

    Prawda, jeśli urządzenie, na którym działa galeria multimediów, zostało wykryte jako urządzenie multimedialne. tj. urządzenie PTP lub MTP albo katalog DCIM.

  • isRemovable

    wartość logiczna

    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

    Opcjonalne GetMediaFileSystemsInteractivity

    Określa, czy przed zwróceniem dozwolonego zestawu prosić użytkownika o zgodę na otwarcie dodatkowych galerii multimediów. Domyślnie jest ono ciche. Jeśli wartość „yes” lub jeśli aplikacji nie przyznano dostępu do żadnej galerii multimediów z wartością „if_needed” wyświetli się okno konfiguracji galerii multimediów.

MediaMetadata

Właściwości

  • album

    ciąg znaków opcjonalny

    Zdefiniowane pod kątem dźwięku i obrazu.

  • wykonawca

    ciąg znaków opcjonalny

  • attachedImages

    Blob[]

    Obrazy umieszczone w metadanych pliku multimedialnego. Najczęściej używa się go w przypadku okładki albumów i miniatur filmów.

  • komentarz

    ciąg znaków opcjonalny

  • Prawa autorskie

    ciąg znaków opcjonalny

  • płyta

    liczba opcjonalnie

  • czas trwania

    liczba opcjonalnie

    Zdefiniowane pod kątem dźwięku i obrazu. W sekundach.

  • gatunek

    ciąg znaków opcjonalny

  • wysokość

    liczba opcjonalnie

    Zdefiniowany dla wideo. W pikselach.

  • language

    ciąg znaków opcjonalny

  • mimeType

    ciąg znaków

    Typ MIME nasłuchiwanego przez przeglądarkę.

  • rawTags

    StreamInfo[]

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

  • rotacja

    liczba opcjonalnie

    Zdefiniowany dla wideo. W stopniach.

  • tytuł

    ciąg znaków opcjonalny

  • utwór

    liczba opcjonalnie

  • szerokość

    liczba opcjonalnie

MediaMetadataOptions

Właściwości

  • metadataType

    Opcjonalne GetMetadataType

    Określa podzbiór metadanych do pobrania. Domyślna wartość to „wszystko” w przypadku pominięcia opcji.

StreamInfo

Właściwości

  • tagi

    Obiekt

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

  • typ

    ciąg znaków

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

Metody

addGalleryWatch()

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

Dodaje obserwację galerii o określonym identyfikatorze. Wywołanie zwrotne jest następnie wywoływane z wynikiem powodzenia lub niepowodzenia.

Parametry

Zwroty

  • Promise<AddGalleryWatchResult>

    Chrome 116 lub nowszy .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Wyświetl użytkownikowi selektor katalogów i dodaj wybrany katalog jako galerię. Jeśli użytkownik anuluje selektor, pole selectedFileSystemName będzie puste. Wyświetlenie okna wymaga gestu użytkownika. Jeśli użytkownik nie dokona gestu, wywołanie zwrotne będzie realizowane tak, jakby użytkownik anulował czynność.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      ciąg znaków

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Uzyskiwanie metadanych określonego systemu plików multimedialnych.

Parametry

  • mediaFileSystem

    DOMFileSystem

Zwroty

getMediaFileSystems()

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

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

Parametry

  • szczegóły

    MediaFileSystemsDetails opcjonalne

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Zwroty

  • Promise<DOMFileSystem[]>

    Chrome 116 lub nowszy .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getMetadata()

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

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

Parametry

Zwroty

  • Promise<MediaMetadata>

    Chrome 116 lub nowszy .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Usuwa zegarek galerii o podanym identyfikatorze.

Parametry

  • galleryId

    ciąg znaków

Wydarzenia

onGalleryChanged

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

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

Parametry