chrome.mediaGalleries

Descrição

Use a API chrome.mediaGalleries para acessar arquivos de mídia (áudio, imagens, vídeo) nos 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 alteração.

GalleryChangeType

Enumeração

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

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

GetMediaFileSystemsInteractivity

Enumeração

"no"
Não aja de maneira interativa.

"yes"
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

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"
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 no momento.

  • isMediaDevice

    booleano

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

  • 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

    Define se a permissão do usuário para galerias de mídia adicionais será solicitada antes de retornar o conjunto permitido. O padrão é o modo silencioso. Se o valor "yes" é transmitido ou se o aplicativo não recebeu 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

    Bolha[]

    As imagens incorporadas nos metadados do arquivo de mídia. Isso é mais usado para a arte do álbum ou miniaturas de vídeo.

  • comentário

    string opcional

  • Direitos autorais

    string opcional

  • disco

    número opcional

  • duration

    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. No caso de formatos com vários streams, a ordem é preservada. Os metadados do contêiner são o primeiro elemento.

  • rotação

    número opcional

    Definido para vídeo. Em graus.

  • título

    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 é "todos" se a opção for omitida.

StreamInfo

Propriedades

  • tags

    objeto

    Um dicionário não filtrado de string ou string de tags para o fluxo.

  • tipo

    string

    Descreve o formato do contêiner ou codec de transmissão, como "mp3", "h264".

Métodos

addGalleryWatch()

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

Adiciona um relógio de galeria para a galeria com o ID especificado. O callback em questão é acionado com um resultado de sucesso ou falha.

Parâmetros

Retorna

  • Promise<AddGalleryWatchResult>

    Chrome 116 ou versões mais recentes

    As promessas só têm suporte no Manifesto 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 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,
)

Receber 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,
)

Consiga as galerias de mídia configuradas nesse user agent. Se nenhum estiver configurado ou disponível, o callback 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 versões mais recentes

    As promessas só têm suporte no Manifesto 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 da mídia para 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 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

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

Parâmetros