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
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
-
duration
número opcional
Se define para audio y video. En segundos
-
género
cadena opcional
-
height
número opcional
Se define para video. En píxeles
-
language
cadena opcional
-
mimeType
cadena
El navegador husó el tipo MIME.
-
rawTags
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
-
pista
número opcional
-
width
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()
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
-
galleryId
cadena
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: AddGalleryWatchResult) => void
-
resultado
-
Devuelve
-
Promise<AddGalleryWatchResult>
Chrome 116 y versiones posterioresLas 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
-
MediaFileSystemMetadata | undefined
getMediaFileSystems()
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 posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getMetadata()
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
-
mediaFile
BLOB
-
Opciones
MediaMetadataOptions opcional
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(metadata: MediaMetadata) => void
-
metadatos
-
Devuelve
-
Promise<MediaMetadata>
Chrome 116 y versiones posterioresLas 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
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(details: GalleryChangeDetails) => void
-
detalles
-