Sumber tampilan lokal saja
src, resolve, dan bind mengembalikan sumber hanya setelah file lokal ada. Tag img atau video Anda menerima URL webview lokal.
Sumber tampilan lokal saja
src, resolve, dan bind mengembalikan sumber hanya setelah file lokal ada. Tag img atau video Anda menerima URL webview lokal.
Penyimpanan native persisten
Aset yang di-cache disimpan di penyimpanan persisten milik aplikasi, bukan folder cache platform yang mungkin dihapus sistem saat beban tinggi.
Dukungan CDN terlindungi
Lewatkan header ke fetch native untuk aset yang ditandatangani atau terautentikasi, sementara elemen web hanya memuat file lokal.
Binding ramah framework
Hubungkan resolusi cache native ke HTML polos, React refs, Vue refs, atau framework apa pun yang dapat menetapkan src untuk img atau video.
Cache gambar dan video CDN di penyimpanan aplikasi persisten dan hubungkan sebagai sumber media lokal
Mulai dengan cancel() dan metode inti lainnya yang tercantum di bawah ini.
| Platform | Dukungan | Catatan |
|---|---|---|
| iOS | Ya | Native |
| Android | Ya | Native |
| Web | Tidak | Lindungi dengan Capacitor.getPlatform() |
Gunakan Asset Cache saat aplikasi Anda menampilkan media remote berukuran besar yang harus tetap bertahan meski penyimpanan tertekan:
<img> dan <video> tidak boleh mengambil URL yang dilindungi secara langsungconfigure(options) mengatur perilaku CDN dan revalidasi default.bind(element, path, options?) memperbarui elemen gambar atau video saat file lokal siap.src(path, options?) mengembalikan string sumber lokal untuk state framework.resolve(path, options?) mengembalikan sumber lokal beserta metadata cache.get(options) menyelesaikan URL jarak jauh menjadi metadata file native yang persisten.remove(options) menghapus satu aset cache berdasarkan key atau URL.clear() menghapus semua aset cache yang dikelola oleh plugin.list() mengembalikan aset cache yang masih ada di disk.getCacheSize() mengembalikan total byte yang di-cache.getPluginVersion() mengembalikan penanda versi implementasi native.Cache dapat diperiksa dengan cara yang berbeda per aset atau melalui default:
| Strategi | Perilaku |
|---|---|
never | Gunakan file lokal jika ada. |
ttl | Unduh ulang setelah maxAgeSeconds. |
always | Revalidasi pada setiap panggilan dan kirim validator yang diketahui. |
etag | Gunakan validator HTTP ETag yang diketahui bila tersedia. |
last-modified | Gunakan validator HTTP Last-Modified yang diketahui bila tersedia. |
Di iOS, file disimpan di Application Support dan root cache dikecualikan dari backup iCloud. Di Android, file disimpan di direktori files internal aplikasi.
Cache tersembunyi di dalam sandbox aplikasi dan tidak terlihat sebagai media publik pengguna. Cache akan dihapus saat aplikasi di-uninstall, saat pengguna menghapus data aplikasi, atau saat aplikasi Anda memanggil clear() atau remove().
Jika Anda menggunakan @capgo/capacitor-asset-cache untuk merencanakan pemuatan media persisten, hubungkan dengan Panduan Memulai untuk detail implementasi, @capgo/capacitor-downloader untuk download background secara eksplisit, @capgo/capacitor-file untuk akses file lokal secara umum, dan Menggunakan @capgo/capacitor-asset-cache untuk tutorialnya.