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

    StreamInfo[]

    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

  • tag

    objek

    Kamus string->string yang tidak difilter untuk tag untuk streaming.

  • tipe

    string

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

Metode

addGalleryWatch()

Promise 
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

Hasil

  • 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 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

getMediaFileSystems()

Promise 
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 baru

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

getMetadata()

Promise 
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

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 smartwatch galeri untuk galeri dengan ID galeri yang ditentukan.

Parameter

  • galleryId

    string

Peristiwa

onGalleryChanged

chrome.mediaGalleries.onGalleryChanged.addListener(
  callback: function,
)

Diaktifkan saat galeri media diubah atau smartwatch galeri dihapus.

Parameter