chrome.mediaGalleries

Deskripsi

Gunakan chrome.mediaGalleries API untuk mengakses file media (audio, gambar, video) dari disk lokal pengguna (dengan izin 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 terjatuh karena perangkat telah dilepas, izin akses galeri telah dihapus, atau alasan lainnya.

GetMediaFileSystemsInteractivity

Enum

"tidak"
Jangan berinteraksi secara interaktif.

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

"if_needed"
Minta pengguna untuk mengelola galeri yang diizinkan hanya jika set hasil 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 ada di perangkat yang dapat dilepas, ID unik untuk perangkat saat perangkat sedang online.

  • galleryId

    string

    ID unik dan persisten untuk galeri media.

  • isAvailable

    boolean

    Benar (True) jika perangkat saat ini tersedia.

  • isMediaDevice

    boolean

    Benar (True) jika perangkat yang digunakan untuk membuka galeri media terdeteksi sebagai perangkat media. Artinya, perangkat PTP atau MTP, atau direktori DCIM ada.

  • isRemovable

    boolean

    Benar jika galeri media berada di perangkat yang dapat dilepas.

  • nama

    string

    Nama sistem file.

MediaFileSystemsDetails

Properti

  • interaktif

    GetMediaFileSystemsInteractivity opsional

    Apakah akan meminta izin pengguna ke galeri media tambahan sebelum menampilkan set yang diizinkan. Default-nya 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. Hal ini paling sering digunakan untuk sampul album atau thumbnail video.

  • komentar

    string opsional

  • hak cipta

    string opsional

  • disk

    nomor opsional

  • durasi

    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

    Jenis MIME yang terdeteksi browser.

  • rawTags

    StreamInfo[]

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

  • rotasi

    nomor opsional

    Ditentukan untuk video. Dalam derajat.

  • judul

    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 tag string->string tanpa filter untuk streaming.

  • jenis

    string

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

Metode

addGalleryWatch()

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

Menambahkan pengamatan 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 Manifest 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()

Janji 
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 Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getMetadata()

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

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

Parameter

Hasil

  • Promise<MediaMetadata>

    Chrome 116+

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

removeGalleryWatch()

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

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 tampilan galeri dihentikan.

Parameter