chrome.mediaGalleries

Descrizione

Utilizza l'API chrome.mediaGalleries per accedere ai file multimediali (audio, immagini, video) dai dischi locali dell'utente (con il suo consenso).

Autorizzazioni

mediaGalleries

Disponibilità

Solo ChromeOS

Tipi

AddGalleryWatchResult

Proprietà

  • galleryId

    stringa

  • operazione riuscita

    booleano

GalleryChangeDetails

Proprietà

  • galleryId

    stringa

    Identifica la galleria modificata.

  • Tipo di evento di modifica.

GalleryChangeType

Enum

"contents_changed"
I contenuti della galleria sono cambiati.

"watch_dropped"
Il monitoraggio è stato interrotto perché il dispositivo è stato scollegato, l'autorizzazione di accesso alla 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 l'insieme restituito sarebbe altrimenti vuoto.

GetMetadataType

Enum

"all"
Recupera il tipo MIME, i tag dei metadati e le immagini allegate.

"mimeTypeAndTags"
Recupera solo il tipo MIME e i tag dei metadati.

"mimeTypeOnly"
Recupera solo il tipo MIME.

MediaFileSystemMetadata

Proprietà

  • deviceId

    stringa facoltativa

    Se la galleria multimediale si trova su un dispositivo rimovibile, un ID univoco per il dispositivo mentre è online.

  • galleryId

    stringa

    Un ID univoco e permanente per la galleria multimediale.

  • isAvailable

    booleano

    True se il dispositivo è attualmente disponibile.

  • isMediaDevice

    booleano

    True se il dispositivo su cui si trova la galleria multimediale è stato rilevato come dispositivo multimediale, ovvero un dispositivo PTP o MTP, o se è presente una directory DCIM.

  • isRemovable

    booleano

    True se la galleria multimediale si trova su un dispositivo rimovibile.

  • nome

    stringa

    Il nome del file system.

MediaFileSystemsDetails

Proprietà

  • interattivo

    GetMediaFileSystemsInteractivity facoltativo

    Indica se chiedere all'utente l'autorizzazione per altre gallerie multimediali prima di restituire l'insieme consentito. Il valore predefinito è 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 facoltativa

    Definito per audio e video.

  • artista

    stringa facoltativa

  • attachedImages

    Blob[]

    Le immagini incorporate nei metadati del file multimediale. Questa opzione viene utilizzata più spesso per le copertine degli album o le miniature dei video.

  • commento

    stringa facoltativa

  • copyright

    stringa facoltativa

  • disc

    number optional

  • durata

    number optional

    Definito per audio e video. In secondi.

  • genere

    stringa facoltativa

  • altezza

    number optional

    Definito per i video. In pixel.

  • language

    stringa facoltativa

  • mimeType

    stringa

    Il tipo MIME rilevato dal browser.

  • rawTags

    StreamInfo[]

    Tutti i metadati nel file multimediale. Per i formati con più stream, l'ordine degli stream verrà conservato. I metadati del container sono il primo elemento.

  • rotazione

    number optional

    Definito per i video. In gradi.

  • titolo

    stringa facoltativa

  • Pista

    number optional

  • larghezza

    number optional

MediaMetadataOptions

Proprietà

  • metadataType

    GetMetadataType facoltativo

    Specifica quale sottoinsieme di metadati 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 contenitore o il codec dello stream, ad esempio "mp3", "h264".

Metodi

addGalleryWatch()

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

Aggiunge un monitoraggio della galleria per la galleria con l'ID galleria specificato. Il callback specificato viene quindi attivato con un risultato positivo o negativo.

Parametri

Resi

  • Chrome 116 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

addUserSelectedFolder()

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

Presenta un selettore di directory all'utente e aggiungi la directory selezionata come galleria. Se l'utente annulla il selettore, selectedFileSystemName sarà vuoto. Per visualizzare la finestra di dialogo è necessaria un'attivazione dall'utente. Senza un'attivazione dall'utente, il callback verrà eseguito come se l'utente avesse annullato l'operazione.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      stringa

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

Recupera i metadati relativi a un file system multimediale specifico.

Parametri

  • mediaFileSystem

    DOMFileSystem

Resi

getMediaFileSystems()

Promise 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

Recupera le gallerie multimediali configurate in questo user agent. Se non ne sono configurati o disponibili, il callback riceverà un array vuoto.

Parametri

  • dettagli

    MediaFileSystemsDetails facoltativo

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Resi

  • Promise<DOMFileSystem[]>

    Chrome 116 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getMetadata()

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

Recupera i metadati specifici dei contenuti multimediali per un file multimediale. Questo dovrebbe funzionare per i file nelle gallerie multimediali e per altri file system DOM.

Parametri

Resi

  • Promise<MediaMetadata>

    Chrome 116 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeGalleryWatch()

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

Rimuove un monitoraggio della galleria per la galleria con l'ID galleria specificato.

Parametri

  • galleryId

    stringa

Eventi

onGalleryChanged

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

Attivato quando una galleria multimediale viene modificata o un monitoraggio della galleria viene interrotto.

Parametri