chrome.mediaGalleries

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

    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

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

Promessa 
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

Ritorni

  • Chrome 116 e versioni successive

    Le 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

getMediaFileSystems()

Promessa 
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 successive

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

getMetadata()

Promessa 
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

Ritorni

  • Promise<MediaMetadata>

    Chrome 116 e versioni successive

    Le 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