Deskripsi
Gunakan chrome.mediaGalleries
API untuk mengakses file media (audio, gambar, video) dari disk lokal pengguna (dengan persetujuan pengguna).
Izin
mediaGalleries
Jenis
AddGalleryWatchResult
Properti
-
galleryId
string
-
berhasil
boolean
GalleryChangeDetails
Properti
-
galleryId
string
Mengidentifikasi galeri yang diubah.
-
tipe
Jenis peristiwa perubahan.
GalleryChangeType
Enum
"contents_Changed"
Isi galeri telah berubah.
"watch_dropped"
Smartwatch dilepas karena perangkat terlepas, izin galeri telah dihapus, atau alasan lainnya.
GetMediaFileSystemsInteractivity
Enum
"tidak"
Jangan bertindak interaktif.
"ya"
Minta pengguna mengelola galeri media yang diizinkan.
"if_needed"
Minta pengguna untuk mengelola galeri yang diizinkan hanya jika kumpulan nilai yang ditampilkan kosong.
GetMetadataType
Enum
"all"
Mengambil jenis mime, tag metadata, dan gambar yang dilampirkan.
"mimeTypeAndTags"
Hanya mengambil jenis mime dan tag metadata.
"mimeTypeOnly"
Mengambil jenis mime saja.
MediaFileSystemMetadata
Properti
-
deviceId
string opsional
Jika galeri media menggunakan perangkat yang dapat dilepas, ID unik untuk perangkat saat perangkat sedang online.
-
galleryId
string
ID unik dan persisten untuk galeri media.
-
isAvailable
boolean
True jika perangkat tersedia saat ini.
-
isMediaDevice
boolean
True jika perangkat tempat galeri media terdeteksi sebagai perangkat media, yaitu perangkat PTP atau MTP, atau ada direktori DCIM.
-
isRemovable
boolean
Benar jika galeri media menggunakan perangkat yang dapat dilepas.
-
name
string
Nama sistem file.
MediaFileSystemsDetails
Properti
-
interaktif
GetMediaFileSystemsInteractivity opsional
Apakah akan meminta izin pengguna ke galeri media tambahan sebelum menampilkan kumpulan yang diizinkan. Defaultnya adalah senyap. Jika nilai 'yes' diteruskan, atau jika aplikasi belum diberi akses ke galeri media mana pun dan nilai 'if_needed' diteruskan, dialog konfigurasi galeri media akan ditampilkan.
MediaMetadata
Properti
-
album
string opsional
Ditentukan untuk audio dan video.
-
artist
string opsional
-
attachedImages
Gumpalan[]
Gambar yang disematkan dalam metadata file media. Ini paling sering digunakan untuk sampul album atau thumbnail video.
-
komentar
string opsional
-
hak cipta
string opsional
-
disk
nomor opsional
-
tonton
nomor opsional
Ditentukan untuk audio dan video. Dalam hitungan detik.
-
genre
string opsional
-
tinggi
nomor opsional
Ditentukan untuk video. Dalam piksel.
-
language
string opsional
-
mimeType
string
Browser mengendus jenis mime.
-
rawTags
Semua metadata dalam file media. Untuk format dengan beberapa streaming, urutan streaming akan dipertahankan. Metadata container adalah elemen pertama.
-
rotasi
nomor opsional
Ditentukan untuk video. Dalam derajat.
-
title
string opsional
-
trek
nomor opsional
-
lebar
nomor opsional
MediaMetadataOptions
Properti
-
metadataType
GetMetadataType opsional
Menentukan subset metadata yang akan diambil. Nilai defaultnya adalah 'all' jika opsi dihilangkan.
StreamInfo
Properti
-
tags
objek
Kamus string->string yang tidak difilter untuk tag untuk streaming.
-
tipe
string
Menjelaskan format penampung atau codec streaming, yaitu "mp3", "h264".
Metode
addGalleryWatch()
chrome.mediaGalleries.addGalleryWatch(
galleryId: string,
callback?: function,
)
Menambahkan smartwatch galeri untuk galeri dengan ID galeri yang ditentukan. Callback yang diberikan kemudian akan diaktifkan dengan hasil berhasil atau gagal.
Parameter
-
galleryId
string
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(result: AddGalleryWatchResult) => void
-
hasil
-
Hasil
-
Promise<AddGalleryWatchResult>
Chrome 116 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
addUserSelectedFolder()
chrome.mediaGalleries.addUserSelectedFolder(
callback: function,
)
Tampilkan pemilih direktori kepada pengguna dan tambahkan direktori yang dipilih sebagai galeri. Jika pengguna membatalkan pemilih, selectedFileSystemName akan kosong. Gestur pengguna diperlukan agar dialog ditampilkan. Tanpa gestur pengguna, callback akan berjalan seolah-olah pengguna dibatalkan.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void
-
mediaFileSystems
DOMFileSystem[]
-
selectedFileSystemName
string
-
getMediaFileSystemMetadata()
chrome.mediaGalleries.getMediaFileSystemMetadata(
mediaFileSystem: DOMFileSystem,
)
Mendapatkan metadata tentang sistem file media tertentu.
Parameter
-
mediaFileSystem
DOMFileSystem
Hasil
-
MediaFileSystemMetadata | tidak ditentukan
getMediaFileSystems()
chrome.mediaGalleries.getMediaFileSystems(
details?: MediaFileSystemsDetails,
callback?: function,
)
Dapatkan galeri media yang dikonfigurasi di agen pengguna ini. Jika tidak ada yang dikonfigurasi atau tersedia, callback akan menerima array kosong.
Parameter
-
detail
MediaFileSystemsDetails opsional
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(mediaFileSystems: DOMFileSystem[]) => void
-
mediaFileSystems
DOMFileSystem[]
-
Hasil
-
Promise<DOMFileSystem[]>
Chrome 116 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
getMetadata()
chrome.mediaGalleries.getMetadata(
mediaFile: Blob,
options?: MediaMetadataOptions,
callback?: function,
)
Mendapatkan metadata khusus media untuk file media. Cara ini berfungsi untuk file di galeri media serta sistem file DOM lainnya.
Parameter
-
mediaFile
Blob
-
opsi
MediaMetadataOptions opsional
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(metadata: MediaMetadata) => void
-
metadata
-
Hasil
-
Promise<MediaMetadata>
Chrome 116 dan yang lebih baruPromise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.
removeGalleryWatch()
chrome.mediaGalleries.removeGalleryWatch(
galleryId: string,
)
Menghapus smartwatch galeri untuk galeri dengan ID galeri yang ditentukan.
Parameter
-
galleryId
string
Acara
onGalleryChanged
chrome.mediaGalleries.onGalleryChanged.addListener(
callback: function,
)
Diaktifkan saat galeri media diubah atau smartwatch galeri dihapus.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(details: GalleryChangeDetails) => void
-
detail
-