chrome.mediaGalleries

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.

  • Jenis peristiwa perubahan.

GalleryChangeType

Enum

"contents_changed"
Isi galeri telah berubah.

"watch_dropped"
Jam dilepaskan karena perangkat telah dilepas, izin galeri telah dihapus, atau alasan lainnya.

GetMediaFileSystemsInteractivity

Enum

"no"
Jangan bertindak secara interaktif.

"yes"
Minta pengguna untuk mengelola galeri media yang diizinkan.

"if_needed"
Minta pengguna untuk mengelola galeri yang diizinkan hanya jika kumpulan nilai yang ditampilkan kosong.

GetMetadataType

Enum

"all"
Ambil jenis mime, tag metadata, dan gambar yang dilampirkan.

"mimeTypeAndTags"
Hanya ambil jenis mime dan tag metadata.

"mimeTypeOnly"
Hanya mengambil jenis mime.

MediaFileSystemMetadata

Properti

  • deviceId

    string opsional

    Jika galeri media berada di perangkat yang dapat dilepas, berikan ID unik untuk perangkat tersebut saat perangkat sedang online.

  • galleryId

    string

    ID unik dan tetap untuk galeri media.

  • Tersedia

    boolean

    True jika perangkat saat ini tersedia.

  • isMediaDevice

    boolean

    True jika perangkat yang menampilkan galeri media terdeteksi sebagai perangkat media. yaitu perangkat PTP atau MTP, atau direktori DCIM ada.

  • isRemovable

    boolean

    Benar jika galeri media berada di perangkat portabel.

  • nama

    string

    Nama sistem file.

MediaFileSystemsDetails

Properti

  • interaktif

    GetMediaFileSystemsInteractivity opsional

    Apakah akan meminta izin kepada pengguna ke galeri media tambahan sebelum menampilkan set yang diizinkan. Defaultnya adalah senyap. Jika nilai 'yes' lulus, atau jika aplikasi belum diberi akses ke galeri media mana pun dengan nilai 'if_needed' diteruskan, maka dialog konfigurasi galeri media akan ditampilkan.

MediaMetadata

Properti

  • album

    string opsional

    Ditentukan untuk audio dan video.

  • artis

    string opsional

  • attachedImages

    Blob[]

    Gambar yang disematkan dalam metadata file media. Elemen ini paling sering digunakan untuk gambar album atau thumbnail video.

  • komentar

    string opsional

  • hak cipta

    string opsional

  • disk

    angka opsional

  • durasi

    angka opsional

    Ditentukan untuk audio dan video. Dalam hitungan detik.

  • genre

    string opsional

  • tinggi

    angka opsional

    Ditentukan untuk video. Dalam piksel.

  • language

    string opsional

  • mimeType

    string

    Browser mengendus jenis mime.

  • rawTags

    StreamInfo[]

    Semua metadata di file media. Untuk format dengan beberapa streaming, urutan streaming akan dipertahankan. Metadata container adalah elemen pertama.

  • rotasi

    angka opsional

    Ditentukan untuk video. Dalam derajat.

  • judul

    string opsional

  • trek

    angka opsional

  • lebar

    angka opsional

MediaMetadataOptions

Properti

  • metadataType

    GetMetadataType opsional

    Menentukan subset metadata yang akan diambil. Default-nya adalah 'all' jika opsinya dihilangkan.

StreamInfo

Properti

  • tag

    objek

    Kamus string tag yang tidak difilter untuk streaming.

  • jenis

    string

    Menjelaskan format penampung atau codec streaming, yaitu "mp3", "h264".

Metode

addGalleryWatch()

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

Menambahkan pengamatan galeri untuk galeri dengan ID galeri yang ditentukan. Callback yang diberikan kemudian diaktifkan dengan hasil berhasil atau gagal.

Parameter

Hasil

  • Promise<AddGalleryWatchResult>

    Chrome 116 dan yang lebih baru

    Promise 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 membatalkan.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    (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

getMediaFileSystems()

Janji 
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 ini: 

    (mediaFileSystems: DOMFileSystem[]) => void

    • mediaFileSystems

      DOMFileSystem[]

Hasil

  • Promise<DOMFileSystem[]>

    Chrome 116 dan yang lebih baru

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.

getMetadata()

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

Mendapatkan metadata khusus media untuk file media. Ini seharusnya berfungsi untuk file di galeri media serta sistem file DOM lainnya.

Parameter

Hasil

  • Promise<MediaMetadata>

    Chrome 116 dan yang lebih baru

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain perlu menggunakan callback.

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
)

Menghapus pengamatan 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