chrome.mediaGalleries

Descripción

Usa la API de chrome.mediaGalleries para acceder a los archivos multimedia (audio, imágenes, video) desde los discos locales del usuario (con su consentimiento).

Permisos

mediaGalleries

Tipos

AddGalleryWatchResult

Propiedades

  • galleryId

    cadena

  • correcto

    boolean

GalleryChangeDetails

Propiedades

  • galleryId

    cadena

    Identifica la galería modificada.

  • Tipo de evento de cambio.

GalleryChangeType

Enum

"contents_changed"
El contenido de la galería cambió.

"watch_dropped"
Se soltó el reloj porque se desconectó el dispositivo, se quitó el permiso de la galería o por cualquier otro motivo.

GetMediaFileSystemsInteractivity

Enum

"no"
No actúes de forma interactiva.

"yes"
Solicitar al usuario que administre las galerías de contenido multimedia permitidas.

"if_necesario"
Pídele al usuario que administre las galerías permitidas solo si el conjunto de devoluciones estaría vacío.

GetMetadataType

Enum

"all"
Recupera el tipo de MIME, las etiquetas de metadatos y las imágenes adjuntas.

"mimeTypeAndTags"
Recupera solo el tipo de MIME y las etiquetas de metadatos.

"mimeTypeOnly"
Recupera solo el tipo de MIME.

MediaFileSystemMetadata

Propiedades

  • deviceId

    cadena opcional

    Si la galería de contenido multimedia está en un dispositivo extraíble, es un ID único para el dispositivo mientras está en línea.

  • galleryId

    cadena

    Es un ID único y persistente para la galería de contenido multimedia.

  • isAvailable

    boolean

    Es verdadero si el dispositivo está disponible actualmente.

  • isMediaDevice

    boolean

    Es verdadero si se detectó que el dispositivo en el que se encuentra la galería multimedia es un dispositivo de medios, es decir, si hay un dispositivo PTP o MTP, o si hay un directorio DCIM.

  • isRemovable

    boolean

    Es verdadero si la galería de contenido multimedia está en un dispositivo extraíble.

  • name

    cadena

    Es el nombre del sistema de archivos.

MediaFileSystemsDetails

Propiedades

  • interactive

    GetMediaFileSystemsInteractivity opcional

    Indica si se debe solicitar al usuario permiso para acceder a otras galerías de contenido multimedia antes de devolver el conjunto permitido. La configuración predeterminada es silenciosa. Si se pasa el valor "sí" o si la aplicación no tiene acceso a ninguna galería de medios y se pasa el valor "if_necesario", se mostrará el diálogo de configuración de la galería de medios.

MediaMetadata

Propiedades

  • album

    cadena opcional

    Se define para audio y video.

  • artist

    cadena opcional

  • attachedImages

    BLOB

    Son las imágenes incorporadas en los metadatos del archivo multimedia. Se usa con mayor frecuencia para las imágenes de álbumes o las miniaturas de videos.

  • comentario

    cadena opcional

  • Derechos de autor

    cadena opcional

  • disco

    número opcional

  • de vistas

    número opcional

    Se define para audio y video. En segundos

  • género

    cadena opcional

  • alto

    número opcional

    Se define para video. En píxeles

  • language

    cadena opcional

  • mimeType

    cadena

    El navegador husó el tipo MIME.

  • rawTags

    StreamInfo.

    Todos los metadatos en el archivo multimedia. En el caso de los formatos con varias transmisiones, se conservará el orden de las transmisiones. Los metadatos del contenedor son el primer elemento.

  • rotación

    número opcional

    Se define para video. En grados.

  • title

    cadena opcional

  • seguimiento

    número opcional

  • ancho

    número opcional

MediaMetadataOptions

Propiedades

  • metadataType

    GetMetadataType opcional

    Especifica qué subconjunto de los metadatos se deben recuperar. El valor predeterminado es “all” si se omite la opción.

StreamInfo

Propiedades

  • tags

    objeto

    Un diccionario string->string sin filtro de etiquetas para la transmisión.

  • tipo

    cadena

    Describe el formato del contenedor o el códec de transmisión, es decir, “mp3”, “h264”.

Métodos

addGalleryWatch()

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

Agrega un reloj de galería para la galería con el ID de galería especificado. La devolución de llamada determinada se activa con un resultado de éxito o falla.

Parámetros

Devuelve

  • Chrome 116 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Presenta un selector de directorios al usuario y agrega el directorio seleccionado como una galería. Si el usuario cancela el selector, selectedFileSystemName estará vacío. Se requiere un gesto del usuario para que se muestre el diálogo. Sin un gesto del usuario, la devolución de llamada se ejecutará como si el usuario hubiera cancelado.

Parámetros

  • callback

    la función

    El parámetro callback se ve de la siguiente manera: 

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

    • mediaFileSystems

      Sistema de archivos DOM[]

    • selectedFileSystemName

      cadena

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
)

Obtiene metadatos sobre un sistema de archivos multimedia específico.

Parámetros

  • mediaFileSystem

    DOMFileSystem

Devuelve

getMediaFileSystems()

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

Obtén las galerías multimedia configuradas en este usuario-agente. Si no hay ninguno configurado o disponible, la devolución de llamada recibirá una matriz vacía.

Parámetros

  • detalles

    MediaFileSystemsDetails opcional

  • callback

    Función opcional

    El parámetro callback se ve de la siguiente manera: 

    (mediaFileSystems: DOMFileSystem[])=>void

    • mediaFileSystems

      Sistema de archivos DOM[]

Devuelve

  • Promise<DOMFileSystem[]>

    Chrome 116 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

getMetadata()

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

Obtiene los metadatos específicos de contenido multimedia para un archivo multimedia. Esto debería funcionar con archivos en galerías de medios, además de otros sistemas de archivos del DOM.

Parámetros

Devuelve

  • Promise<MediaMetadata>

    Chrome 116 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Quita un reloj de galería de la galería con el ID de galería especificado.

Parámetros

  • galleryId

    cadena

Eventos

onGalleryChanged

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

Se activa cuando se modifica una galería multimedia o se descarta una vista de galería.

Parámetros