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

    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é abandonnée, car l'appareil a été dissocié, 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"
Demander à 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

Énumération

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

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

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

MediaFileSystemMetadata

Propriétés

  • deviceId

    chaîne facultatif

    Si la galerie multimédia se trouve sur un appareil amovible, identifiant unique de l'appareil lorsque celui-ci est en ligne

  • galleryId

    chaîne

    ID unique et persistant pour la galerie multimédia.

  • est disponible

    booléen

    "True" si l'appareil est actuellement disponible.

  • isMediaDevice

    booléen

    "True" si l'appareil sur lequel la galerie multimédia est installée a été détecté comme tel. c'est-à-dire qu'un appareil PTP ou MTP ou un répertoire DCIM est présent.

  • isRemovable

    booléen

    Vrai 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

    Permet de demander ou non à l'utilisateur l'autorisation d'accéder à d'autres galeries multimédias avant de renvoyer l'ensemble autorisé. Le mode silencieux est activé par défaut. Si la valeur "yes" est transmise, ou si l'application n'a pas été autorisée à accéder aux galeries multimédias et si la valeur "if_needed" est définie. est transmis, la boîte de dialogue de configuration de la galerie multimédia s'affiche.

MediaMetadata

Propriétés

  • album

    chaîne facultatif

    Définies 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. Il est le plus souvent utilisé pour les pochettes d'albums ou les miniatures de vidéos.

  • commentaire

    chaîne facultatif

  • Droits d'auteur

    chaîne facultatif

  • disque

    numéro facultatif

  • duration

    numéro facultatif

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

  • genre

    chaîne facultatif

  • hauteur

    numéro facultatif

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

  • language

    chaîne 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 associés à plusieurs flux, l'ordre des flux est conservé. Les métadonnées du conteneur sont le premier élément.

  • rotation

    numéro facultatif

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

  • titre

    chaîne facultatif

  • piste

    numéro facultatif

  • largeur

    numéro 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" (tous). si l'option est omise.

StreamInfo

Propriétés

  • tags

    objet

    Dictionnaire chaîne->chaîne non filtrée de tags pour le flux.

  • type

    chaîne

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

Méthodes

addGalleryWatch()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

Ajoute une surveillance de 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

  • Promise&lt;AddGalleryWatchResult&gt;

    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 s'exécutera comme si l'utilisateur avait annulé.

Paramètres

  • rappel

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

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

Paramètres

  • mediaFileSystem

    DOMFileSystem

Renvoie

getMediaFileSystems()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

Configurez les galeries multimédias dans ce user-agent. Si aucun paramètre n'est configuré ou n'est disponible, le rappel reçoit un tableau vide.

Paramètres

  • détails

    MediaFileSystemsDetails facultatif

  • rappel

    function facultatif

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Renvoie

  • Promise&lt;DOMFileSystem[]&gt;

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

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

Récupère les métadonnées spécifiques aux contenus multimédias 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&lt;MediaMetadata&gt;

    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 surveillance de la galerie associée à 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 lorsqu'une montre de galerie est supprimée.

Paramètres