chrome.mediaGalleries

Descripción

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

Permisos

mediaGalleries

Tipos

AddGalleryWatchResult

Propiedades

  • galleryId

    string

  • correcto

    booleano

GalleryChangeDetails

Propiedades

  • galleryId

    string

    Identifica la galería modificada.

  • Es el tipo de evento de cambio.

GalleryChangeType

Enum

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

"watch_dropped"
Se cayó 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.

"sí"
Pídele al usuario que administre las galerías de medios permitidas.

"if_needed"
Pídele al usuario que administre las galerías permitidas solo si el conjunto de resultados 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 multimedia está en un dispositivo extraíble, es un ID único para el dispositivo mientras está en línea.

  • galleryId

    string

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

  • isAvailable

    booleano

    Es verdadero si el dispositivo está disponible en este momento.

  • isMediaDevice

    booleano

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

  • isRemovable

    booleano

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

  • nombre

    string

    Es el nombre del sistema de archivos.

MediaFileSystemsDetails

Propiedades

  • interactive

    GetMediaFileSystemsInteractivity opcional

    Indica si se debe solicitar al usuario permiso para acceder a galerías de medios adicionales antes de devolver el conjunto permitido. El valor predeterminado es silencioso. Si se pasa el valor "yes" o si no se otorgó acceso a la aplicación a ninguna galería de medios y se pasa el valor "if_needed", 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 portadas de álbumes o las miniaturas de videos.

  • comentario

    cadena opcional

  • Derechos de autor

    cadena opcional

  • disco

    número opcional

  • duración

    número opcional

    Se define para audio y video. En segundos.

  • género

    cadena opcional

  • alto

    número opcional

    Se define para el video. En píxeles.

  • idioma

    cadena opcional

  • mimeType

    string

    Es el tipo de MIME detectado por el navegador.

  • rawTags

    StreamInfo[]

    Son todos los metadatos del 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 el video. En grados.

  • título

    cadena opcional

  • pista

    número opcional

  • ancho

    número opcional

MediaMetadataOptions

Propiedades

  • metadataType

    GetMetadataType opcional

    Especifica qué subconjunto de metadatos se recuperará. El valor predeterminado es "all" si se omite la opción.

StreamInfo

Propiedades

  • etiquetas

    objeto

    Es un diccionario sin filtrar de cadenas de etiquetas para la transmisión.

  • tipo

    string

    Describe el formato del contenedor o el códec de la transmisión, p.ej., "mp3" o "h264".

Métodos

addGalleryWatch()

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

Agrega un reloj de galería para la galería con el ID especificado. Luego, se activa la devolución de llamada proporcionada con un resultado de éxito o error.

Parámetros

Muestra

  • Chrome 116 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
): void

Presenta un selector de directorios al usuario y agrega el directorio seleccionado como 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 la acción.

Parámetros

  • callback

    función

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

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      string

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

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

Parámetros

  • mediaFileSystem

    DOMFileSystem

Muestra

getMediaFileSystems()

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

Obtiene las galerías de medios configuradas en este usuario-agente. Si no hay ninguna configurada o disponible, la devolución de llamada recibirá un array vacío.

Parámetros

  • detalles

    MediaFileSystemsDetails opcional

  • callback

    función opcional

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

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Muestra

  • Promise<DOMFileSystem[]>

    Chrome 116 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getMetadata()

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

Obtiene los metadatos específicos de los medios para un archivo multimedia. Esto debería funcionar para los archivos en galerías de medios y otros sistemas de archivos DOM.

Parámetros

Muestra

  • Promise<MediaMetadata>

    Chrome 116 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
): void

Quita una observación de galería para la galería con el ID especificado.

Parámetros

  • galleryId

    string

Eventos

onGalleryChanged

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

Se activa cuando cambia una galería de medios o se descarta una observación de la galería.

Parámetros