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

Dostępność

Tylko ChromeOS

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ł odrzucony, ponieważ urządzenie zostało odłączone, uprawnienia do galerii zostały usunięte lub z innego powodu.

GetMediaFileSystemsInteractivity

Typ wyliczeniowy

„nie”
Nie wchodź w interakcje.

„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

    ciąg znaków 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

    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

    ciąg znaków opcjonalny

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

  • wykonawca

    ciąg znaków 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

    ciąg znaków opcjonalny

  • Prawa autorskie

    ciąg znaków opcjonalny

  • płyta

    number opcjonalny

  • czas trwania

    number opcjonalny

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

  • gatunek

    ciąg znaków opcjonalny

  • wysokość

    number opcjonalny

    Zdefiniowane dla filmu. W pikselach.

  • language

    ciąg znaków 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ł

    ciąg znaków 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 to „all”.

StreamInfo

Właściwości

  • Tagi

    obiekt

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

  • 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 innych systemów 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 odłożony.

Parametry