Descrizione
Utilizza l'API chrome.mediaGalleries
per accedere ai file multimediali (audio, immagini, video) dai dischi locali dell'utente (con il consenso dell'utente).
Autorizzazioni
mediaGalleries
Tipi
AddGalleryWatchResult
Proprietà
-
galleryId
stringa
-
operazione riuscita
boolean
GalleryChangeDetails
Proprietà
-
galleryId
stringa
Identifica la galleria modificata.
-
Tipo
Tipo di evento di modifica.
GalleryChangeType
Enum
"contents_changed"
I contenuti della galleria sono cambiati.
"watch_dropped"
Lo smartwatch è stato caduto perché il dispositivo è stato scollegato, l'autorizzazione per la galleria è stata rimossa o per qualsiasi altro motivo.
GetMediaFileSystemsInteractivity
Enum
"no"
Non agire in modo interattivo.
"yes"
Chiedi all'utente di gestire le gallerie multimediali consentite.
"if_needed"
Chiedi all'utente di gestire le gallerie consentite solo se il valore restituito sarebbe vuoto.
GetMetadataType
Enum
"all"
Recupera il tipo MIME, i tag dei metadati e le immagini allegate.
"mimeTypeAndTag"
Recupera solo il tipo MIME e i tag dei metadati.
"mimeTypeOnly"
Recupera solo il tipo MIME.
MediaFileSystemMetadata
Proprietà
-
deviceId
stringa facoltativo
Se la galleria multimediale si trova su un dispositivo rimovibile, un ID univoco del dispositivo quando è online.
-
galleryId
stringa
Un ID univoco e permanente per la galleria multimediale.
-
isAvailable
boolean
True se il dispositivo è attualmente disponibile.
-
isMediaDevice
boolean
True se il dispositivo su cui è attiva la galleria multimediale è stato rilevato come dispositivo multimediale, ad esempio un dispositivo PTP o MTP oppure una directory DCIM.
-
isRemovable
boolean
True se la galleria multimediale si trova su un dispositivo rimovibile.
-
nome
stringa
Il nome del file system.
MediaFileSystemsDetails
Proprietà
-
interactive
GetMediaFileSystemsInteractivity facoltativo
Indica se richiedere all'utente l'autorizzazione per ulteriori gallerie multimediali prima di restituire l'insieme consentito. Per impostazione predefinita è silenzioso. Se viene passato il valore "yes" o se all'applicazione non è stato concesso l'accesso ad alcuna galleria multimediale e viene passato il valore "if_needed", verrà visualizzata la finestra di dialogo di configurazione della galleria multimediale.
MediaMetadata
Proprietà
-
album
stringa facoltativo
Definito per audio e video.
-
artista
stringa facoltativo
-
attachedImages
Blob[]
Le immagini incorporate nei metadati del file multimediale. Viene generalmente utilizzato per le copertine degli album o per le miniature dei video.
-
commento
stringa facoltativo
-
copyright
stringa facoltativo
-
disc
numero facoltativo
-
durata
numero facoltativo
Definito per audio e video. In secondi.
-
genere
stringa facoltativo
-
altezza
numero facoltativo
Definito per i video. In pixel.
-
language
stringa facoltativo
-
mimeType
stringa
Il browser ha sniffato il tipo MIME.
-
rawTags
Tutti i metadati nel file multimediale. Per i formati con più stream, l'ordine degli stream verrà mantenuto. I metadati del contenitore sono il primo elemento.
-
rotazione
numero facoltativo
Definito per i video. In gradi.
-
title
stringa facoltativo
-
Pista
numero facoltativo
-
larghezza
numero facoltativo
MediaMetadataOptions
Proprietà
-
metadataType
Facoltativo GetMetadataType
Specifica il sottoinsieme di metadati da recuperare. Se l'opzione viene omessa, il valore predefinito è "all".
StreamInfo
Proprietà
-
tag
oggetto
Un dizionario stringa->stringa non filtrato di tag per lo stream.
-
Tipo
stringa
Descrive il formato del container o del codec dello stream, ad esempio "mp3", "h264".
Metodi
addGalleryWatch()
chrome.mediaGalleries.addGalleryWatch(
galleryId: string,
callback?: function,
)
Aggiunge una visualizzazione galleria per la galleria con l'ID galleria specificato. Il callback specificato viene quindi attivato con un risultato di operazione riuscita o non riuscita.
Parametri
-
galleryId
stringa
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: AddGalleryWatchResult) => void
-
risultato
-
Ritorni
-
Promise<AddGalleryWatchResult>
Chrome 116 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
addUserSelectedFolder()
chrome.mediaGalleries.addUserSelectedFolder(
callback: function,
)
Presenta all'utente un selettore di directory e aggiungi la directory selezionata come galleria. Se l'utente annulla il selettore, il valore selectedFileSystemName sarà vuoto. Per visualizzare la finestra di dialogo è necessario un gesto dell'utente. Senza un gesto dell'utente, il callback viene eseguito come se l'utente annullasse.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void
-
mediaFileSystems
Sistema file DOM[]
-
selectedFileSystemName
stringa
-
getMediaFileSystemMetadata()
chrome.mediaGalleries.getMediaFileSystemMetadata(
mediaFileSystem: DOMFileSystem,
)
Visualizzare i metadati relativi a uno specifico file system multimediale.
Parametri
-
mediaFileSystem
DOMFileSystem
Ritorni
-
MediaFileSystemMetadata | non definito
getMediaFileSystems()
chrome.mediaGalleries.getMediaFileSystems(
details?: MediaFileSystemsDetails,
callback?: function,
)
Recupera le gallerie multimediali configurate in questo user agent. Se nessuno è configurato o disponibile, il callback riceverà un array vuoto.
Parametri
-
dettagli
MediaFileSystemsDetails facoltativo
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(mediaFileSystems: DOMFileSystem[]) => void
-
mediaFileSystems
Sistema file DOM[]
-
Ritorni
-
Promise<DOMFileSystem[]>
Chrome 116 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getMetadata()
chrome.mediaGalleries.getMetadata(
mediaFile: Blob,
options?: MediaMetadataOptions,
callback?: function,
)
Restituisce i metadati specifici per i contenuti multimediali per un file multimediale. Questo comando dovrebbe funzionare per i file nelle gallerie multimediali e per altri file system DOM.
Parametri
-
mediaFile
Blob
-
opzioni del modello.
MediaMetadataOptions facoltativo
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(metadata: MediaMetadata) => void
-
metadati
-
Ritorni
-
Promise<MediaMetadata>
Chrome 116 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
removeGalleryWatch()
chrome.mediaGalleries.removeGalleryWatch(
galleryId: string,
)
Rimuove una visualizzazione della galleria per la galleria con l'ID galleria specificato.
Parametri
-
galleryId
stringa
Eventi
onGalleryChanged
chrome.mediaGalleries.onGalleryChanged.addListener(
callback: function,
)
Viene attivato quando viene modificata una galleria multimediale o quando si interrompe la visualizzazione della galleria.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(details: GalleryChangeDetails) => void
-
dettagli
-