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

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 stati modificati.

"watch_dropped"
Lo smartwatch è stato rimosso perché il dispositivo è stato staccato, l'autorizzazione della 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 persistente 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, ad esempio 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

    Se chiedere all'utente l'autorizzazione per altre gallerie multimediali prima di restituire il set consentito. Il valore predefinito è Silenzioso. Se viene passato il valore "yes" o se all'applicazione non è stato concesso l'accesso a nessuna 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. Viene utilizzato più spesso per le copertine degli album o le miniature dei video.

  • commento

    stringa facoltativa

  • copyright

    stringa facoltativa

  • disc

    number (facoltativo)

  • durata

    number (facoltativo)

    Definito per audio e video. In secondi.

  • genere

    stringa facoltativa

  • altezza

    number (facoltativo)

    Definito per il 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à mantenuto. I metadati del contenitore sono il primo elemento.

  • rotazione

    number (facoltativo)

    Definito per il video. In gradi.

  • titolo

    stringa facoltativa

  • Pista

    number (facoltativo)

  • larghezza

    number (facoltativo)

MediaMetadataOptions

Proprietà

  • metadataType

    GetMetadataType facoltativo

    Specifica il sottoinsieme di metadati da recuperare. Se l'opzione viene omessa, il valore predefinito è "all".

StreamInfo

Proprietà

  • Tag

    oggetto

    Un dizionario non filtrato di stringhe->stringhe di tag per lo stream.

  • tipo

    stringa

    Descrive il formato del contenitore o del codec dello stream, ad esempio "mp3", "h264".

Metodi

addGalleryWatch()

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

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

Parametri

Resi

  • Chrome 116+

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

addUserSelectedFolder()

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

Mostra all'utente un selettore di directory e aggiungi la directory selezionata come galleria. Se l'utente annulla il selettore, selectedFileSystemName sarà vuoto. Per visualizzare la finestra di dialogo è necessario un gesto dell'utente. Senza un gesto dell'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()

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

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

Parametri

  • dettagli

    MediaFileSystemsDetails facoltativo

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Resi

  • Promise<DOMFileSystem[]>

    Chrome 116+

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

getMetadata()

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

Recupera i metadati specifici per i contenuti multimediali di un file multimediale. Questa operazione dovrebbe funzionare per i file nelle gallerie multimediali e in altri file system DOM.

Parametri

Resi

  • Promise<MediaMetadata>

    Chrome 116+

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

removeGalleryWatch()

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

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

Parametri

  • galleryId

    stringa

Eventi

onGalleryChanged

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

Attivato quando viene modificata una galleria multimediale o viene eliminato un orologio della galleria.

Parametri