Descripción
Usa la API de chrome.mediaGalleries
para acceder a los archivos multimedia (audio, imágenes y video) de los discos locales del usuario (con su consentimiento).
Permisos
mediaGalleries
Tipos
AddGalleryWatchResult
Propiedades
-
galleryId
string
-
correcto
boolean
GalleryChangeDetails
Propiedades
-
galleryId
string
Identifica la galería modificada.
-
tipo
Es el tipo de evento de cambio.
GalleryChangeType
Enum
"contents_changed"
Cambió el contenido de la galería.
"watch_dropped"
Se cayó el reloj porque se desvinculó el dispositivo, se quitó el permiso de galería o por cualquier otro motivo.
GetMediaFileSystemsInteractivity
Enum
"no"
No actúes de manera interactiva.
"yes"
Pídele al usuario que administre las galerías de contenido multimedia permitidas.
"if_needed"
Pídele al usuario que administre las galerías permitidas solo si el conjunto de datos que se muestra está 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
string opcional
Si la galería multimedia se encuentra 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 contenido multimedia.
-
Está disponible.
boolean
Es verdadero si el dispositivo está disponible en ese momento.
-
isMediaDevice
boolean
Es verdadero si se detectó como dispositivo multimedia el dispositivo en el que se encuentra la galería multimedia. es decir, hay un dispositivo PTP o MTP, o un directorio DCIM.
-
isRemovable
boolean
Es verdadero si la galería multimedia 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 otras galerías de contenido multimedia antes de devolver el conjunto permitido. La opción predeterminada es silencio. Si el valor “sí” se pasa, o si la aplicación no tiene acceso a ninguna galería de medios y el valor "if_needed" se pasa, se muestra el diálogo de configuración de la galería multimedia.
MediaMetadata
Propiedades
-
album
string opcional
Se definen para audio y video.
-
artist
string opcional
-
attachedImages
BLOB
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
string opcional
-
Derechos de autor
string opcional
-
disco
número opcional
-
duración
número opcional
Se definen para audio y video. en segundos.
-
género
string opcional
-
alto
número opcional
Se define para video. En píxeles.
-
idioma
string opcional
-
mimeType
string
El navegador detectó el tipo de MIME.
-
rawTags
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 video. En grados.
-
título
string opcional
-
pista
número opcional
-
ancho
número opcional
MediaMetadataOptions
Propiedades
-
metadataType
GetMetadataType opcional
Especifica qué subconjunto de metadatos se debe recuperar. La configuración predeterminada es “all”. si se omite la opción.
StreamInfo
Propiedades
-
tags
objeto
Un diccionario de etiquetas de cadena sin filtrar 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()
chrome.mediaGalleries.addGalleryWatch(
galleryId: string,
callback?: function,
)
Agrega un reloj de galería para la galería con el ID de galería especificado. Luego, la devolución de llamada determinada se activa con un resultado de éxito o fracaso.
Parámetros
-
galleryId
string
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(result: AddGalleryWatchResult) => void
-
resultado
-
Muestra
-
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
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,
)
Obtiene metadatos sobre un sistema de archivos multimedia específico.
Parámetros
-
mediaFileSystem
DOMFileSystem
Muestra
-
MediaFileSystemMetadata | indefinido
getMediaFileSystems()
chrome.mediaGalleries.getMediaFileSystems(
details?: MediaFileSystemsDetails,
callback?: function,
)
Obtén 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 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 del contenido multimedia para un archivo multimedia. Esto debería funcionar para los archivos de galerías de contenido multimedia y 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
-
Muestra
-
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 para la galería con el ID de galería especificado.
Parámetros
-
galleryId
string
Eventos
onGalleryChanged
chrome.mediaGalleries.onGalleryChanged.addListener(
callback: function,
)
Se activa cuando se cambia una galería de contenido multimedia o se descarta un reloj de galería.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:(details: GalleryChangeDetails) => void
-
detalles
-