@capgo/capacitor-cache-media-asset

Tampilkan sumber lokal saja

src, resolve, dan bind Kembalikan sumber hanya setelah file lokal ada. Tag img atau video Anda menerima URL webview lokal.

Penyimpanan native persisten

Aset yang disimpan di cache hidup di penyimpanan yang dimiliki aplikasi, bukan folder cache platform yang mungkin dihapus oleh sistem di bawah tekanan.

Dukungan CDN yang dilindungi

Kirimkan header ke fetch native untuk aset yang ditandatangani atau terautentikasi sambil elemen web masih mengisi file lokal.

Binding yang ramah framework

Hubungkan resolusi cache native ke HTML biasa, refs React, refs Vue, atau framework mana pun yang dapat menugaskan sumber img atau video.

Ringkasan

@capgo/capacitor-asset-cache cache gambar besar, video, dan aset CDN lainnya di penyimpanan yang dimiliki aplikasi, kemudian berikan aplikasi web sumber URL lokal untuk ditampilkan.

Jalan normal adalah:

1. Konfigurasi URL CDN dasar sekali, atau kirimkan URL absolut per aset.
2. Panggil AssetCache.bind(element, path) atau AssetCache.src(path).
3. Plugin ini mengambil atau memvalidasi kembali aset remote secara native.
4. Elemen ini menerima URL webview lokal hanya setelah file lokal siap.

Catatan

Jika plugin tidak dapat membuat atau menggunakan file lokal, maka API penampilan berhasil hanya lokal saja. src(...) dan resolve(...) tolak dan bind(...) mengindikasikan elemen tersebut sebagai error.

Kapan Menggunakannya

Gunakan Cache Aset ketika aplikasi Anda menampilkan media remote berat yang harus bertahan dari tekanan penyimpanan normal: video onboarding atau pemasaran yang disajikan dari CDN

• Penyimpanan Aset
• gambar hero, galeri, atau urutan gambar yang digunakan kembali di setiap sesi
• media yang dilindungi yang memerlukan header permintaan
• layar yang toleran terhadap offline di mana asset lokal yang telah diambil sebelumnya sudah cukup
• Capacitor aplikasi di mana <img> dan <video> tidak harus memuat URL yang dilindungi secara langsung

Core API

• configure(options) menetapkan perilaku CDN dan revalidasi default.
• bind(element, path, options?) mengupdate elemen gambar atau video ketika file lokal sudah siap.
• src(path, options?) mengembalikan string sumber lokal untuk keadaan framework.
• resolve(path, options?) mengembalikan sumber lokal plus metadata cache.
• get(options) Mengatasi URL remote ke metadata file native yang persisten.
• remove(options) Menghapus satu aset yang dikasih kunci atau URL.
• clear() Menghapus setiap aset yang dikasih manajemen plugin.
• list() Mengembalikan aset yang masih ada di disk.
• getCacheSize() Mengembalikan total byte yang dikasih.
• getPluginVersion() Mengembalikan tanda marker implementasi native.

Model Revalidasi

Cache dapat dicek dalam cara yang berbeda per aset atau melalui default:

Strategi	Perilaku
never	Pakai file lokal ketika ada.
ttl	Re-download setelah ini maxAgeSeconds.
always	Revalidasi pada setiap panggilan dan kirimkan validator yang diketahui.
etag	Gunakan validator HTTP ETag yang diketahui ketika ada.
last-modified	Gunakan validator HTTP Last-Modified yang diketahui ketika ada.

Model Penyimpanan

Pada iOS, file disimpan di bawah Support Aplikasi dan root cache dikecualikan dari backup iCloud. Pada Android, file disimpan di bawah direktori file internal aplikasi.

Cache disembunyikan di dalam sandbox aplikasi dan tidak dapat dilihat sebagai media pengguna publik. Cache dihapus ketika aplikasi diuninstall, ketika pengguna membersihkan data aplikasi, atau ketika aplikasi Anda memanggil clear() atau remove().

Lanjutkan dari @capgo/capacitor-asset-cache

Jika Anda menggunakan @capgo/capacitor-cache-aset untuk merencanakan penggunaan media yang persisten, hubungkannya dengan Membuat Mulai untuk detail implementasi, @capgo/capacitor-pembaruan untuk download latar belakang yang eksplisit, @capgo/capacitor-file untuk akses file lokal umum, dan Menggunakan @capgo/capacitor-cache-aset untuk tutorial.