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
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.
-
nome
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
-
duration
número opcional
Definido para áudio e vídeo. Em segundos.
-
gênero
string opcional
-
height
número opcional
Definido para vídeo. Em pixels.
-
language
string opcional
-
mimeType
string
O navegador detectou o tipo MIME.
-
rawTags
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
-
width
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.
-
Tipo
string
Descreve o formato do contêiner ou codec do stream, por exemplo, "mp3", "h264".
Métodos
addGalleryWatch()
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
-
galleryId
string
-
callback
função optional
O parâmetro
callback
tem esta aparência:(result: AddGalleryWatchResult) => void
-
resultado
-
Retorna
-
Promise<AddGalleryWatchResult>
Chrome 116 ou mais recentePromessas 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
-
MediaFileSystemMetadata | indefinido
getMediaFileSystems()
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 recentePromessas são compatíveis apenas com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.
getMetadata()
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
-
mediaFile
Blob
-
do modelo.
MediaMetadataOptions opcional
-
callback
função optional
O parâmetro
callback
tem esta aparência:(metadata: MediaMetadata) => void
-
metadados
-
Retorna
-
Promise<MediaMetadata>
Chrome 116 ou mais recentePromessas 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
-
callback
função
O parâmetro
callback
tem esta aparência:(details: GalleryChangeDetails) => void
-
detalhes
-