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ę.
-
Niestandardowy typ treści
Typ zdarzenia zmiany.
GalleryChangeType
Typ wyliczeniowy
"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
Typ wyliczeniowy
"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
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, 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
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
-
utwór
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.
-
Niestandardowy typ treści
string,
Opisuje format kontenera lub kodeka strumienia, np. „mp3”, „h264”.
Metody
addGalleryWatch()
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
-
galleryId
string,
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: AddGalleryWatchResult) => void
-
wynik
-
Zwroty
-
Promise<AddGalleryWatchResult>
Chrome 116 i nowsze wersjeObietnice 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
Zwroty
-
MediaFileSystemMetadata | undefined
getMediaFileSystems()
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[]
-
Zwroty
-
Promise<DOMFileSystem[]>
Chrome 116 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getMetadata()
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
-
mediaFile
Blob
-
Opcje
Opcjonalnie MediaMetadataOptions
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(metadata: MediaMetadata) => void
-
metadane
-
Zwroty
-
Promise<MediaMetadata>
Chrome 116 i nowsze wersjeObietnice 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
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(details: GalleryChangeDetails) => void
-
szczegóły
-