chrome.mediaGalleries

Descrição

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

Permissões

mediaGalleries

Tipos

AddGalleryWatchResult

Propriedades

  • galleryId

    string

  • sucesso

    boolean

GalleryChangeDetails

Propriedades

  • galleryId

    string

    Identifica a galeria modificada.

  • Tipo de evento de alteração.

GalleryChangeType

Tipo enumerado

"contents_changed"
O conteúdo da galeria foi alterado.

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

GetMediaFileSystemsInteractivity

Tipo enumerado

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

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

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

GetMetadataType

Tipo enumerado

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

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

"mimeTypeOnly"
Extrair apenas o tipo MIME.

MediaFileSystemMetadata

Propriedades

  • deviceId

    string opcional

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

  • galleryId

    string

    Um ID exclusivo e persistente para a galeria de mídia.

  • isAvailable

    boolean

    Verdadeiro se o dispositivo estiver disponível no momento.

  • isMediaDevice

    boolean

    "True", 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 um diretório DCIM está presente.

  • isRemovable

    boolean

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

  • name

    string

    O nome do sistema de arquivos.

MediaFileSystemsDetails

Propriedades

  • interativo

    GetMediaFileSystemsInteractivity opcional

    Define se o usuário deve solicitar permissão para acessar galerias de mídia adicionais antes de retornar o conjunto permitido. O padrão é 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

  • album

    string opcional

    Definido para áudio e vídeo.

  • artista

    string opcional

  • attachedImages

    Bolha[]

    As imagens incorporadas aos metadados do arquivo de mídia. Esse recurso é usado com mais frequência para a arte do álbum ou miniaturas de vídeos.

  • comentário

    string opcional

  • Direitos autorais

    string opcional

  • disco

    número opcional

  • duração

    número opcional

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

  • gênero

    string opcional

  • altura

    número opcional

    Definido para vídeo. Em pixels.

  • language

    string opcional

  • mimeType

    string

    O navegador detectou o tipo MIME.

  • rawTags

    StreamInfo[]

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

  • rotação

    número opcional

    Definido para vídeo. Em graus.

  • title

    string opcional

  • faixa

    número opcional

  • largura

    número opcional

MediaMetadataOptions

Propriedades

  • metadataType

    GetMetadataType opcional

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

StreamInfo

Propriedades

  • tags

    objeto

    Um dicionário de strings não filtrado para o stream.

  • digitar

    string

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

Métodos

addGalleryWatch()

Promessa 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
)

Adiciona um relógio de galeria para a galeria com o código de galeria especificado. O callback fornecido é acionado com um resultado de sucesso ou falha.

Parâmetros

Retorna

  • Chrome 116 ou mais recente

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
)

Apresente um seletor de diretório ao usuário e adicione o diretório selecionado como uma galeria. Se o usuário cancelar o seletor, selectedFileSystemName estará vazio. Um gesto do usuário é necessário para que a caixa de diálogo seja mostrada. 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,
)

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

Parâmetros

  • mediaFileSystem

    DOMFileSystem

Retorna

getMediaFileSystems()

Promessa 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
)

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

Parâmetros

  • detalhes

    MediaFileSystemsDetails opcional

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (mediaFileSystems: DOMFileSystem[])=>void

    • mediaFileSystems

      DOMFileSystem[]

Retorna

  • Promise<DOMFileSystem[]>

    Chrome 116 ou mais recente

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

getMetadata()

Promessa 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
)

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

Parâmetros

Retorna

  • Promise<MediaMetadata>

    Chrome 116 ou mais recente

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Remove um relógio 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 um relógio da galeria é descartado.

Parâmetros