chrome.mediaGalleries

Opis

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

Uprawnienia

mediaGalleries

Dostępność

Tylko w systemie ChromeOS

Typy

AddGalleryWatchResult

Właściwości

  • galleryId

    tekst

  • sukces

    wartość logiczna

GalleryChangeDetails

Właściwości

  • galleryId

    tekst

    Identyfikuje zmodyfikowaną galerię.

  • Typ zdarzenia zmiany.

GalleryChangeType

Typ wyliczeniowy

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

"watch_dropped"
Obserwowanie zostało przerwane, ponieważ urządzenie zostało odłączone, uprawnienia do galerii zostały usunięte lub z innego powodu.

GetMediaFileSystemsInteractivity

Typ wyliczeniowy

"no"
Nie działaj 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"
pobiera 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, unikalny identyfikator urządzenia, gdy jest ono online.

  • galleryId

    tekst

    Unikalny i trwały identyfikator galerii multimediów.

  • isAvailable

    wartość logiczna

    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 nośnik danych, np. urządzenie PTP lub MTP, albo jeśli istnieje katalog DCIM.

  • isRemovable

    wartość logiczna

    Wartość True (Prawda), jeśli galeria multimediów znajduje się na urządzeniu wymiennym.

  • nazwa

    tekst

    Nazwa systemu plików.

MediaFileSystemsDetails

Właściwości

  • interaktywny

    GetMediaFileSystemsInteractivity opcjonalne

    Określa, czy przed zwróceniem dozwolonego zestawu należy poprosić użytkownika o uprawnienia 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 i przekazana zostanie wartość „if_needed”, wyświetli się okno konfiguracji galerii multimediów.

MediaMetadata

Właściwości

  • album

    ciąg znaków opcjonalny

    Zdefiniowane dla 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ładek albumów lub miniatur filmów.

  • komentarz

    ciąg znaków opcjonalny

  • Prawa autorskie

    ciąg znaków opcjonalny

  • płyta

    number optional

  • czas trwania

    number optional

    Zdefiniowane dla dźwięku i obrazu. W sekundach.

  • gatunek

    ciąg znaków opcjonalny

  • wysokość

    number optional

    Zdefiniowane dla filmu. W pikselach.

  • language

    ciąg znaków opcjonalny

  • mimeType

    tekst

    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 to pierwszy element.

  • obrót

    number optional

    Zdefiniowane dla filmu. W stopniach.

  • tytuł

    ciąg znaków opcjonalny

  • utwór

    number optional

  • szerokość

    number optional

MediaMetadataOptions

Właściwości

  • metadataType

    GetMetadataType opcjonalny

    Określa, który podzbiór metadanych ma zostać pobrany. Jeśli opcja zostanie pominięta, domyślnie zostanie ustawiona wartość „all”.

StreamInfo

Właściwości

  • Tagi

    obiekt

    Niefiltrowany słownik tagów typu ciąg tekstowy -> ciąg tekstowy dla strumienia.

  • typ

    tekst

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

Metody

addGalleryWatch()

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

Dodaje obserwowanie galerii o podanym identyfikatorze. Następnie zostanie wywołane podane wywołanie zwrotne z wynikiem powodzenia lub niepowodzenia.

Parametry

Zwroty

  • Chrome 116 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

addUserSelectedFolder()

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

Wyświetl użytkownikowi selektor katalogu i dodaj wybrany katalog jako galerię. Jeśli użytkownik anuluje selektor, parametr selectedFileSystemName będzie pusty. Aby wyświetlić okno, wymagany jest gest użytkownika. 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

      tekst

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 kliencie użytkownika. Jeśli żadne nie są skonfigurowane lub dostępne, wywołanie zwrotne otrzyma pustą tablicę.

Parametry

  • szczegóły

    MediaFileSystemsDetails opcjonalne

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Zwroty

  • thought Promise<DOMFileSystem[]>

    Chrome 116 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getMetadata()

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

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

Parametry

Zwroty

  • thought Promise<MediaMetadata>

    Chrome 116 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeGalleryWatch()

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

Usuwa obserwowanie galerii o podanym identyfikatorze.

Parametry

  • galleryId

    tekst

Wydarzenia

onGalleryChanged

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

Uruchamiane, gdy galeria multimediów zostanie zmieniona lub gdy zostanie usunięty zegarek z galerii.

Parametry