chrome.mediaGalleries

Descrição

Use a API chrome.mediaGalleries para acessar arquivos de mídia (áudio, imagens, vídeo) dos discos locais do usuário (com o consentimento dele).

Permissões

mediaGalleries

Tipos

AddGalleryWatchResult

Propriedades

  • galleryId

    string

  • sucesso

    booleano

GalleryChangeDetails

Propriedades

  • galleryId

    string

    Identifica a galeria modificada.

  • Tipo de evento de mudança.

GalleryChangeType

Enumeração

"contents_changed"
O conteúdo da galeria mudou.

"watch_dropped"
O relógio foi descartado porque o dispositivo foi desconectado, a permissão da galeria foi removida ou por qualquer outro motivo.

GetMediaFileSystemsInteractivity

Enumeração

"não"
Não aja de forma interativa.

"sim"
Peça para o usuário gerenciar as galerias de mídia permitidas.

"if_needed"
Peça ao usuário para gerenciar apenas as galerias permitidas se o conjunto de retorno estiver vazio.

GetMetadataType

Enumeração

"all"
Recupere o tipo MIME, as tags de metadados e as imagens anexadas.

"mimeTypeAndTags"
Recupere apenas o tipo MIME e as tags de metadados.

"mimeTypeOnly"
Recupere apenas o tipo MIME.

MediaFileSystemMetadata

Propriedades

  • deviceId

    string opcional

    Se a galeria de mídia estiver em um dispositivo removível, um ID exclusivo para o dispositivo enquanto ele estiver on-line.

  • galleryId

    string

    Um ID exclusivo e permanente da galeria de mídia.

  • isAvailable

    booleano

    Verdadeiro se o dispositivo estiver disponível no momento.

  • isMediaDevice

    booleano

    Verdadeiro se o dispositivo em que a galeria de mídia está foi detectado como um dispositivo de mídia, ou seja, um dispositivo PTP ou MTP ou se um diretório DCIM está presente.

  • isRemovable

    booleano

    Verdadeiro se a galeria de mídia estiver em um dispositivo removível.

  • nome

    string

    O nome do sistema de arquivos.

MediaFileSystemsDetails

Propriedades

  • interativo

    GetMediaFileSystemsInteractivity opcional

    Se é necessário pedir permissão ao usuário para acessar outras galerias de mídia antes de retornar o conjunto permitido. O padrão é silencioso. Se o valor "yes" for transmitido ou se o aplicativo não tiver recebido acesso a nenhuma galeria de mídia e o valor "if_needed" for transmitido, a caixa de diálogo de configuração da galeria de mídia será exibida.

MediaMetadata

Propriedades

  • álbum

    string opcional

    Definido para áudio e vídeo.

  • artista

    string opcional

  • attachedImages

    Blob[]

    As imagens incorporadas nos metadados do arquivo de mídia. Isso é usado com mais frequência para capas de álbuns ou miniaturas de vídeos.

  • comentário

    string opcional

  • Direitos autorais

    string opcional

  • disco

    number optional

  • duration

    number optional

    Definido para áudio e vídeo. Em segundos.

  • gênero

    string opcional

  • altura

    number optional

    Definido para vídeo. Em pixels.

  • language

    string opcional

  • mimeType

    string

    O tipo MIME detectado pelo navegador.

  • rawTags

    StreamInfo[]

    Todos os metadados no arquivo de mídia. Para formatos com vários fluxos, a ordem deles será preservada. Os metadados do contêiner são o primeiro elemento.

  • rotação

    number optional

    Definido para vídeo. Em graus.

  • título

    string opcional

  • faixa

    number optional

  • largura

    number optional

MediaMetadataOptions

Propriedades

  • metadataType

    GetMetadataType opcional

    Especifica qual subconjunto de metadados será recuperado. O padrão é "all" se a opção for omitida.

StreamInfo

Propriedades

  • tags

    objeto

    Um dicionário de tags string->string não filtrado para o stream.

  • tipo

    string

    Descreve o formato do contêiner ou codec da transmissão, por exemplo, "mp3", "h264".

Métodos

addGalleryWatch()

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

Adiciona uma observação à galeria com o ID especificado. O callback especificado é acionado com um resultado de sucesso ou falha.

Parâmetros

Retorna

  • Chrome 116 ou mais recente

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

addUserSelectedFolder()

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

Apresentar um seletor de diretório ao usuário e adicionar o diretório selecionado como uma galeria. Se o usuário cancelar o seletor, "selectedFileSystemName" ficará vazio. É necessário um gesto do usuário para que a caixa de diálogo seja exibida. Sem um gesto do usuário, o callback será executado como se o usuário tivesse cancelado.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

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

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      string

getMediaFileSystemMetadata()

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

Recebe metadados sobre um sistema de arquivos de mídia específico.

Parâmetros

  • mediaFileSystem

    DOMFileSystem

Retorna

getMediaFileSystems()

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

Recebe as galerias de mídia configuradas neste user agent. Se nenhum estiver configurado ou disponível, o callback vai receber uma matriz vazia.

Parâmetros

  • detalhes

    MediaFileSystemsDetails opcional

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Retorna

  • Promise<DOMFileSystem[]>

    Chrome 116 ou mais recente

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getMetadata()

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

Recebe os metadados específicos de mídia de um arquivo de mídia. Isso deve funcionar para arquivos em galerias de mídia e outros sistemas de arquivos DOM.

Parâmetros

Retorna

  • Promise<MediaMetadata>

    Chrome 116 ou mais recente

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeGalleryWatch()

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

Remove uma observação da galeria com o ID especificado.

Parâmetros

  • galleryId

    string

Eventos

onGalleryChanged

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

Disparado quando uma galeria de mídia é alterada ou uma observação de galeria é descartada.

Parâmetros