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

Disponibilité

ChromeOS uniquement

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 changé.

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

GetMediaFileSystemsInteractivity

Énumération

"no"
Ne pas agir 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 est vide.

GetMetadataType

Énumération

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

"mimeTypeAndTags"
Récupérer 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 facultatif

    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 périphérique multimédia (par exemple, un appareil PTP ou MTP, ou 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". Si la valeur "yes" est transmise, ou si l'application n'a pas été autorisée à accéder 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

    chaîne facultatif

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

  • artiste

    chaîne facultatif

  • attachedImages

    Blob[]

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

  • commentaire

    chaîne facultatif

  • Droits d'auteur

    chaîne facultatif

  • disque

    number facultatif

  • duration

    number facultatif

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

  • genre

    chaîne facultatif

  • height

    number facultatif

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

  • language

    chaîne facultatif

  • 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 constituent le premier élément.

  • rotation

    number facultatif

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

  • titre

    chaîne facultatif

  • piste

    number facultatif

  • width

    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 de tags non filtré de type chaîne->chaîne pour le flux.

  • type

    chaîne

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

Méthodes

addGalleryWatch()

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

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

Paramètres

Renvoie

  • Chrome 116 ou version ultérieure

    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 afficher la boîte de dialogue. 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

Obtenir les métadonnées d'un système de fichiers multimédia spécifique.

Paramètres

  • mediaFileSystem

    DOMFileSystem

Renvoie

getMediaFileSystems()

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

Récupérez les galeries multimédias configurées dans cet user-agent. Si aucun n'est configuré ou 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 ou version ultérieure

    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>

Récupère les métadonnées spécifiques au contenu multimédia d'un 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 ou version ultérieure

    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 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 surveillance de galerie est supprimée.

Paramètres