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 consentement).

Autorisations

mediaGalleries

Types

AddGalleryWatchResult

Propriétés

  • galleryId

    chaîne

  • success

    boolean

GalleryChangeDetails

Propriétés

  • galleryId

    chaîne

    Identifie la galerie modifiée.

  • Type d'événement de modification.

GalleryChangeType

Enum

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

"watch_dropped"
La montre a été retirée, car l'appareil a été dissocié, l'autorisation d'accès à la galerie a été supprimée, ou pour toute autre raison.

GetMediaFileSystemsInteractivity

Enum

"no"
N'agissez pas de manière interactive.

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

"if_needed"
Demandez à l'utilisateur de ne gérer les galeries autorisées que si l'ensemble renvoyé est vide.

GetMetadataType

Enum

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

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

"mimeTypeOnly"
Récupère uniquement le type MIME.

MediaFileSystemMetadata

Propriétés

  • deviceId

    string facultatif

    Identifiant unique de l'appareil lorsque celui-ci est connecté à Internet (si la galerie multimédia se trouve sur un appareil amovible).

  • galleryId

    chaîne

    ID unique et persistant de la galerie multimédia.

  • isAvailable

    boolean

    "True" si l'appareil est actuellement disponible.

  • isMediaDevice

    boolean

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

  • isRemovable

    boolean

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

  • name

    chaîne

    Nom du système de fichiers.

MediaFileSystemsDetails

Propriétés

  • interactive

    GetMediaFileSystemsInteractivity facultatif

    Permet de demander à l'utilisateur l'autorisation d'accéder à d'autres galeries de médias avant de renvoyer l'ensemble autorisé. Le son est défini par défaut. Si la valeur "yes" est transmise, ou si l'application n'a pas accès aux galeries multimédias et que la valeur "if_needed" est transmise, la boîte de dialogue de configuration de la galerie multimédia s'affiche.

MediaMetadata

Propriétés

  • album

    string facultatif

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

  • artiste

    string facultatif

  • attachedImages

    Blob[]

    Images intégrées dans les métadonnées du fichier multimédia. Cette technique est généralement utilisée pour les pochettes d'albums ou les miniatures de vidéos.

  • ajouter un commentaire

    string facultatif

  • Droits d'auteur

    string facultatif

  • disque

    numéro facultatif

  • de visionnage

    numéro facultatif

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

  • genre

    string facultatif

  • taille

    numéro facultatif

    Définies pour les vidéos. En pixels.

  • language

    string facultatif

  • mimeType

    chaîne

    Le navigateur a détecté le type MIME.

  • rawTags

    StreamInfo[]

    Toutes les métadonnées du fichier multimédia. Pour les formats comportant plusieurs flux, l'ordre de diffusion est conservé. Les métadonnées de conteneur constituent le premier élément.

  • rotation

    numéro facultatif

    Définies pour les vidéos. En degrés.

  • title

    string facultatif

  • piste

    numéro facultatif

  • largeur

    numéro facultatif

MediaMetadataOptions

Propriétés

  • metadataType

    GetMetadataType facultatif

    Spécifie le sous-ensemble des 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 de tags de type chaîne->chaîne non filtrée pour le flux.

  • type

    chaîne

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

Méthodes

addGalleryWatch()

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

Ajoute une montre de galerie pour la galerie avec l'ID de galerie 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

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 nécessaire pour que la boîte de dialogue s'affiche. Sans geste de l'utilisateur, le rappel sera exécuté comme si l'utilisateur avait annulé.

Paramètres

  • rappel

    function

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

Permet d'obtenir des métadonnées sur un système de fichiers multimédias spécifique.

Paramètres

  • mediaFileSystem

    DOMFileSystem

Renvoie

getMediaFileSystems()

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

Permet de configurer les galeries multimédias dans ce user-agent. Si aucun n'est configuré ou disponible, le rappel recevra un tableau vide.

Paramètres

  • détails

    MediaFileSystemsDetails facultatif

  • rappel

    fonction facultative

    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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getMetadata()

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

Récupère les métadonnées spécifiques au fichier multimédia. Cela devrait fonctionner pour les fichiers des galeries multimédias ainsi que pour d'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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Supprime une montre de la galerie avec l'ID de galerie 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 montre de la galerie est abandonnée.

Paramètres