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

Disponibilidad

Solo en ChromeOS

Tipos

AddGalleryWatchResult

Propiedades

  • galleryId

    string

  • éxito

    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 descartó la observación porque se desconectó el dispositivo, se quitó el permiso de la galería o por cualquier otro motivo.

GetMediaFileSystemsInteractivity

Enum

"no"
No actúa de forma 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, de lo contrario, 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

    string opcional

    Si la galería de contenido multimedia está en un dispositivo extraíble, 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.

  • isAvailable

    booleano

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

  • isMediaDevice

    booleano

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

  • isRemovable

    booleano

    Es verdadero si la galería de contenido 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 permiso al usuario para acceder a galerías de contenido multimedia adicionales antes de devolver el conjunto permitido. La configuración predeterminada es Silencio. Si se pasa el valor "yes" o si no se otorgó acceso a la aplicación a ninguna galería de contenido multimedia y se pasa el valor "if_needed", se mostrará el diálogo de configuración de la galería de contenido multimedia.

MediaMetadata

Propiedades

  • album

    string opcional

    Se define para audio y video.

  • artist

    string opcional

  • attachedImages

    Blob[]

    Son las imágenes incorporadas en los metadatos del archivo multimedia. Esto 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

    number opcional

  • duración

    number opcional

    Se define para audio y video. En segundos.

  • género

    string opcional

  • alto

    number opcional

    Se define para los videos. En píxeles.

  • idioma

    string opcional

  • mimeType

    string

    Es el tipo de MIME detectado por el navegador.

  • 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

    number opcional

    Se define para los videos. En grados.

  • título

    string opcional

  • pista

    number opcional

  • ancho

    number opcional

MediaMetadataOptions

Propiedades

  • metadataType

    GetMetadataType opcional

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

StreamInfo

Propiedades

  • tags

    objeto

    Es un diccionario de etiquetas de cadena->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", "h264".

Métodos

addGalleryWatch()

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

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

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 directorio 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,
): MediaFileSystemMetadata | undefined

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

Parámetros

  • mediaFileSystem

    DOMFileSystem

Muestra

getMediaFileSystems()

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

Obtiene las galerías de contenido multimedia 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()

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

Obtiene los metadatos específicos de un archivo multimedia. Esto debería funcionar para los archivos de las galerías de contenido multimedia, así como para otros sistemas de archivos del 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 se cambia una galería de contenido multimedia o se quita una observación de la galería.

Parámetros