chrome.mediaGalleries

Descrizione

Usa 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 cambiati.

"watch_dropped"
Lo smartwatch è stato abbandonato 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 per il dispositivo quando questo è online.

  • galleryId

    stringa

    Un ID univoco e permanente per la galleria multimediale.

  • èDisponibile

    booleano

    True se il dispositivo è attualmente disponibile.

  • isMediaDevice

    booleano

    True se il dispositivo su cui è attiva la galleria multimediale è stato rilevato come dispositivo multimediale. ovvero è presente un dispositivo PTP o MTP oppure 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 richiedere all'utente l'autorizzazione per ulteriori gallerie multimediali prima di restituire l'insieme consentito. Per impostazione predefinita, la modalità è silenziosa. Se il valore "yes" o se all'applicazione non è stato concesso l'accesso a nessuna galleria multimediale e il valore "if_needed" viene passato, viene 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. In genere viene utilizzato per le copertine degli album o 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 annusato il tipo MIME.

  • rawTags

    StreamInfo[]

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

  • rotazione

    numero facoltativo

    Definito per i video. in gradi.

  • titolo

    stringa facoltativo

  • Pista

    numero facoltativo

  • larghezza

    numero facoltativo

MediaMetadataOptions

Proprietà

  • metadataType

    GetMetadataType facoltativo

    Specifica il sottoinsieme di metadati da recuperare. Il valore predefinito è "tutti". se l'opzione viene omessa.

StreamInfo

Proprietà

  • tag

    oggetto

    Un dizionario stringa->stringa senza filtri per lo stream.

  • tipo

    stringa

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

Metodi

addGalleryWatch()

Promesso .
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

Aggiunge un controllo della 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

Resi

  • Promise<AddGalleryWatchResult>

    Chrome 116 e versioni successive .

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Presenta un selettore directory all'utente e aggiungi la directory selezionata come galleria. Se l'utente annulla il selettore, il campo selectedFileSystemNames 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.

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,
)

Recupera i metadati relativi a uno specifico file system multimediale.

Parametri

  • mediaFileSystem

    DOMFileSystem

Resi

getMediaFileSystems()

Promesso .
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

Ottieni 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

      DOMFileSystem[]

Resi

  • Promise<DOMFileSystem[]>

    Chrome 116 e versioni successive .

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

getMetadata()

Promesso .
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

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

Parametri

Resi

  • Promise<MediaMetadata>

    Chrome 116 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le 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,
)

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

Parametri