chrome.mediaGalleries

Description

Utilisez l'API chrome.mediaGalleries pour accéder aux fichiers multimédias (audio, images, vidéo) à partir des disques locaux de l'utilisateur (avec son autorisation).

Autorisations

mediaGalleries

Types

AddGalleryWatchResult

Propriétés

  • galleryId

    chaîne

  • success

    booléen

GalleryChangeDetails

Propriétés

  • galleryId

    chaîne

    Identifie la galerie modifiée.

  • Type d'événement de modification.

GalleryChangeType

Énumération

"contents_changed"
Le contenu de la galerie a été modifié.

"watch_dropped"
La montre a été déposée, car l'appareil a été détaché, l'autorisation d'accéder à la galerie a été supprimée ou pour toute autre raison.

GetMediaFileSystemsInteractivity

Énumération

"non"
N'agis pas de manière interactive.

"yes"
Demandez à l'utilisateur de gérer les galeries multimédias autorisées.

"if_needed"
Demandez à l'utilisateur de gérer les galeries autorisées uniquement si l'ensemble de résultats serait vide.

GetMetadataType

Énumération

"all"
Récupérer le type MIME, les tags de métadonnées et les images jointes.

"mimeTypeAndTags"
Récupérez uniquement le type MIME et les tags de métadonnées.

"mimeTypeOnly"
Récupérer uniquement le type MIME.

MediaFileSystemMetadata

Propriétés

  • deviceId

    chaîne facultative

    Si la galerie multimédia se trouve sur un appareil amovible, un identifiant unique pour l'appareil lorsqu'il est en ligne.

  • galleryId

    chaîne

    Identifiant unique et persistant de la galerie multimédia.

  • isAvailable

    booléen

    "True" si l'appareil est actuellement disponible.

  • isMediaDevice

    booléen

    True si l'appareil sur lequel se trouve la galerie multimédia a été détecté comme un appareil multimédia (c'est-à-dire un appareil PTP ou MTP, ou si un répertoire DCIM est présent).

  • isRemovable

    booléen

    "True" si la galerie multimédia se trouve sur un appareil amovible.

  • nom

    chaîne

    Nom du système de fichiers.

MediaFileSystemsDetails

Propriétés

  • interactive

    GetMediaFileSystemsInteractivity facultatif

    Indique si l'utilisateur doit être invité à autoriser l'accès à des galeries multimédias supplémentaires avant de renvoyer l'ensemble autorisé. La valeur par défaut est "silent" (silencieux). Si la valeur "yes" est transmise, ou si l'application n'a pas obtenu l'accès à des galeries multimédias et que la valeur "if_needed" est transmise, la boîte de dialogue de configuration des galeries multimédias s'affiche.

MediaMetadata

Propriétés

  • album

    chaîne facultative

    Défini pour l'audio et la vidéo.

  • artiste

    chaîne facultative

  • attachedImages

    Blob[]

    Images intégrées dans les métadonnées du fichier multimédia. Il est le plus souvent utilisé pour les pochettes d'album ou les miniatures de vidéos.

  • commentaire

    chaîne facultative

  • Droits d'auteur

    chaîne facultative

  • disque

    number facultatif

  • duration

    number facultatif

    Défini pour l'audio et la vidéo. En secondes.

  • genre

    chaîne facultative

  • hauteur

    number facultatif

    Défini pour la vidéo. En pixels.

  • language

    chaîne facultative

  • mimeType

    chaîne

    Type MIME détecté par le navigateur.

  • rawTags

    StreamInfo[]

    Toutes les métadonnées du fichier multimédia. Pour les formats comportant plusieurs flux, l'ordre des flux sera conservé. Les métadonnées du conteneur sont le premier élément.

  • rotation

    number facultatif

    Défini pour la vidéo. En degrés.

  • titre

    chaîne facultative

  • piste

    number facultatif

  • largeur

    number facultatif

MediaMetadataOptions

Propriétés

  • metadataType

    GetMetadataType facultatif

    Spécifie le sous-ensemble de métadonnées à récupérer. La valeur par défaut est "all" si l'option est omise.

StreamInfo

Propriétés

  • tags

    objet

    Dictionnaire non filtré de chaînes->chaînes de balises pour le flux.

  • type

    chaîne

    Décrit le format du conteneur ou du codec du flux, par exemple "mp3" ou "h264".

Méthodes

addGalleryWatch()

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

Ajoute une surveillance de galerie pour la galerie dont l'ID est spécifié. Le rappel donné est ensuite déclenché avec un résultat de réussite ou d'échec.

Paramètres

Renvoie

  • Chrome 116 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

addUserSelectedFolder()

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

Présentez un sélecteur de répertoire à l'utilisateur et ajoutez le répertoire sélectionné en tant que galerie. Si l'utilisateur annule le sélecteur, selectedFileSystemName sera vide. Un geste de l'utilisateur est requis pour que la boîte de dialogue s'affiche. Sans geste de l'utilisateur, le rappel s'exécutera comme si l'utilisateur avait annulé.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      chaîne

getMediaFileSystemMetadata()

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

Obtenez des métadonnées sur un système de fichiers multimédias spécifique.

Paramètres

  • mediaFileSystem

    DOMFileSystem

Renvoie

getMediaFileSystems()

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

Obtenez les galeries multimédias configurées dans cet user-agent. Si aucune n'est configurée ni disponible, le rappel recevra un tableau vide.

Paramètres

  • détails

    MediaFileSystemsDetails facultatif

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Renvoie

  • Promise<DOMFileSystem[]>

    Chrome 116 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getMetadata()

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

Obtient les métadonnées spécifiques au fichier multimédia. Cela devrait fonctionner pour les fichiers des galeries multimédias ainsi que pour les autres systèmes de fichiers DOM.

Paramètres

Renvoie

  • Promise<MediaMetadata>

    Chrome 116 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

removeGalleryWatch()

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

Supprime une surveillance de galerie pour la galerie dont l'ID est spécifié.

Paramètres

  • galleryId

    chaîne

Événements

onGalleryChanged

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

Déclenché lorsqu'une galerie multimédia est modifiée ou qu'une surveillance de galerie est supprimée.

Paramètres