chrome.mediaGalleries

Deskripsi

Gunakan chrome.mediaGalleries API untuk mengakses file media (audio, gambar, video) dari disk lokal pengguna (dengan izin pengguna).

Izin

mediaGalleries

Ketersediaan

Khusus ChromeOS

Jenis

AddGalleryWatchResult

Properti

  • galleryId

    string

  • berhasil

    boolean

GalleryChangeDetails

Properti

  • galleryId

    string

    Mengidentifikasi galeri yang diubah.

  • Jenis peristiwa perubahan.

GalleryChangeType

Enum

"contents_changed"
Konten galeri telah berubah.

"watch_dropped"
Pemantauan telah dihentikan 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 set yang ditampilkan akan kosong.

GetMetadataType

Enum

"all"
Mengambil jenis MIME, tag metadata, dan gambar terlampir.

"mimeTypeAndTags"
Hanya mengambil jenis MIME dan tag metadata.

"mimeTypeOnly"
Hanya mengambil jenis MIME.

MediaFileSystemMetadata

Properti

  • deviceId

    string opsional

    Jika galeri media berada di perangkat lepas-pasang, ID unik untuk perangkat saat perangkat online.

  • galleryId

    string

    ID unik dan persisten untuk galeri media.

  • isAvailable

    boolean

    True jika perangkat saat ini tersedia.

  • isMediaDevice

    boolean

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

  • isRemovable

    boolean

    True jika galeri media berada di perangkat lepas-pasang.

  • nama

    string

    Nama sistem file.

MediaFileSystemsDetails

Properti

  • interaktif

    GetMediaFileSystemsInteractivity opsional

    Apakah akan meminta izin pengguna untuk 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.

  • artis

    string opsional

  • attachedImages

    Blob[]

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

  • komentar

    string opsional

  • hak cipta

    string opsional

  • disk

    number opsional

  • durasi

    number opsional

    Ditentukan untuk audio dan video. Dalam hitungan detik.

  • genre

    string opsional

  • tinggi

    number opsional

    Ditentukan untuk video. Dalam piksel.

  • bahasa

    string opsional

  • mimeType

    string

    Jenis MIME yang diendus browser.

  • rawTags

    StreamInfo[]

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

  • rotasi

    number opsional

    Ditentukan untuk video. Dalam derajat.

  • judul

    string opsional

  • trek

    number opsional

  • lebar

    number opsional

MediaMetadataOptions

Properti

  • metadataType

    GetMetadataType opsional

    Menentukan subset metadata yang akan diambil. Nilai defaultnya adalah 'all' jika opsi dihilangkan.

StreamInfo

Properti

  • tags

    objek

    Kamus tag string->string tanpa filter untuk streaming.

  • jenis

    string

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

Metode

addGalleryWatch()

Promise 
chrome.mediaGalleries.addGalleryWatch(
  galleryId: string,
  callback?: function,
): Promise<AddGalleryWatchResult>

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

Parameter

Hasil

  • Chrome 116+

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

addUserSelectedFolder()

chrome.mediaGalleries.addUserSelectedFolder(
  callback: function,
): void

Menampilkan pemilih direktori kepada pengguna dan menambahkan 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: 

    (mediaFileSystems: DOMFileSystem[], selectedFileSystemName: string) => void

    • mediaFileSystems

      DOMFileSystem[]

    • selectedFileSystemName

      string

getMediaFileSystemMetadata()

chrome.mediaGalleries.getMediaFileSystemMetadata(
  mediaFileSystem: DOMFileSystem,
): MediaFileSystemMetadata | undefined

Mendapatkan metadata tentang sistem file media tertentu.

Parameter

  • mediaFileSystem

    DOMFileSystem

Hasil

getMediaFileSystems()

Promise 
chrome.mediaGalleries.getMediaFileSystems(
  details?: MediaFileSystemsDetails,
  callback?: function,
): Promise<DOMFileSystem[]>

Mendapatkan 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+

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

getMetadata()

Promise 
chrome.mediaGalleries.getMetadata(
  mediaFile: Blob,
  options?: MediaMetadataOptions,
  callback?: function,
): Promise<MediaMetadata>

Mendapatkan metadata khusus media untuk file media. Hal ini juga akan berfungsi untuk file di galeri media serta sistem file DOM lainnya.

Parameter

Hasil

  • Promise<MediaMetadata>

    Chrome 116+

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

removeGalleryWatch()

chrome.mediaGalleries.removeGalleryWatch(
  galleryId: string,
): void

Menghapus pemantauan 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 pemantauan galeri dihentikan.

Parameter