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
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
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()
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
-
galleryId
chaîne
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(result: AddGalleryWatchResult)=>void
-
résultat
-
Renvoie
-
Promise<AddGalleryWatchResult>
Chrome 116 et versions ultérieuresLes 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
-
MediaFileSystemMetadata|undefined
getMediaFileSystems()
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érieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
getMetadata()
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
-
mediaFile
Blob
-
options
MediaMetadataOptions facultatif
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(metadata: MediaMetadata)=>void
-
métadonnées
-
Renvoie
-
Promise<MediaMetadata>
Chrome 116 et versions ultérieuresLes 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
-
rappel
function
Le paramètre
callback
se présente comme suit :(details: GalleryChangeDetails)=>void
-
détails
-