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

Disponibilidade

Somente no ChromeOS

Tipos

AddGalleryWatchResult

Propriedades

  • galleryId

    string

  • sucesso

    booleano

GalleryChangeDetails

Propriedades

  • galleryId

    string

    Identifica a galeria modificada.

  • Tipo de evento de alteração.

GalleryChangeType

Enumeração

"contents_changed"
O conteúdo da galeria mudou.

"watch_dropped"
A observação foi descartada porque o dispositivo foi desconectado, a permissão da galeria foi removida ou por qualquer outro motivo.

GetMediaFileSystemsInteractivity

Enumeração

"no"
Não agir de forma interativa.

"yes"
Solicita que o usuário gerencie as galerias de mídia permitidas.

"if_needed"
Solicita que o usuário gerencie as galerias permitidas somente se o conjunto de retorno estiver vazio.

GetMetadataType

Enumeração

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

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

"mimeTypeOnly"
Recupera 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 persistente para a galeria de mídia.

  • isAvailable

    booleano

    Verdadeiro se o dispositivo estiver disponível.

  • 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 o usuário deve receber uma solicitação de permissão para 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 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 é mais usado para capas de álbuns ou miniaturas de vídeos.

  • comentário

    string opcional

  • direitos autorais

    string opcional

  • disco

    número optional

  • duração

    número optional

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

  • gênero

    string opcional

  • altura

    número 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 streams, a ordem deles será preservada. Os metadados do contêiner são o primeiro elemento.

  • rotação

    número optional

    Definido para vídeo. Em graus.

  • título

    string opcional

  • faixa

    número optional

  • largura

    número optional

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 tags de string->string não filtrado para o stream.

  • tipo

    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,
): Promise<AddGalleryWatchResult>

Adiciona um monitoramento à galeria com o ID especificado. O callback fornecido é acionado com um resultado de sucesso ou falha.

Parâmetros

Retorna

  • Chrome 116+

    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ária uma interação do usuário para que a caixa de diálogo seja exibida. Sem uma interação inicial, o callback será executado como se o usuário tivesse cancelado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

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

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

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

Parâmetros

  • detalhes

    MediaFileSystemsDetails opcional

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Retorna

  • Promise<DOMFileSystem[]>

    Chrome 116+

    As promessas só são compatíveis 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,
): Promise<MediaMetadata>

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

Parâmetros

Retorna

  • Promise<MediaMetadata>

    Chrome 116+

    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 de galeria para a 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