chrome.mediaGalleries

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.

  • 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

    StreamInfo[]

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

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. Luego, la devolución de llamada determinada se activa con un resultado de éxito o fracaso.

Parámetros

Muestra

  • Promise<AddGalleryWatchResult>

    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

    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

getMediaFileSystems()

Promesa 
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 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 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

Muestra

  • 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 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