Saltare al contenuto principale
Indietro ai plugin
@capgo/capacitor-cache-asseti
Tutorial
@capgo/capacitor-cache-asseti

Cache Asset

Caching immagini e video CDN nei dati di archiviazione persistente dell'app e associarli come fonti di media locali

Guida

Tutoriale sulla Cache degli Asset

Utilizza @capgo/capacitor-cache-asset

@capgo/capacitor-asset-cache memorizza grandi immagini e video CDN nel storage persistente dell'app, quindi restituisce URL di origine locale per le Capacitor webview.

Installa

npm install @capgo/capacitor-asset-cache
npx cap sync

Cos'è che questo Plugin Espone

  • bind - Collega un elemento di immagine o video a una fonte di asset locale e aggiornalo quando pronto.
  • src - Restituisci una stringa di origine locale dopo che l'asset esiste localmente.
  • resolve - Restituisci la fonte locale più i metadati della cache.
  • configure - Imposta il comportamento predefinito per la revalidazione e il CDN.
  • get, list, remove, clear, e getCacheSize - Gestisci la cache in modo esplicito quando necessario.

Esempio di utilizzo

Configura un CDN una volta, poi lega gli elementi con un percorso relativo:

import { AssetCache } from '@capgo/capacitor-asset-cache';

AssetCache.configure({
  cdnUrl: 'https://cdn.example.com/assets/',
  revalidate: {
    strategy: 'ttl',
    maxAgeSeconds: 86400,
  },
});

const hero = document.querySelector<HTMLImageElement>('#hero');

if (hero) {
  AssetCache.bind(hero, 'images/hero.jpg');
}

L'elemento riceve data-asset-cache-state="loading" mentre il fetch nativo esegue il caricamento, poi riceve l'URL della fonte locale e si sposta a ready.

img[data-asset-cache-state='loading'],
video[data-asset-cache-state='loading'] {
  opacity: 0.45;
}

Asset Protetti

I header vengono inviati dal plugin mentre si esegue il fetch o la revalidazione del file remoto. L'elemento web riceve comunque solo l'URL della fonte locale.

const src = await AssetCache.src('private/videos/intro.mp4', {
  cdnUrl: 'https://cdn.example.com/assets/',
  headers: {
    Authorization: `Bearer ${token}`,
  },
});

Senza un URL di base per il CDN

Passa un URL assoluto quando non vuoi configurare l'URL di base cdnUrl.

const src = await AssetCache.src('https://cdn.example.com/assets/videos/intro.mp4');

Percorsi relativi richiedono o un configurato cdnUrl o un chiamato per cdnUrl.

Note sullo Storage

Sui dispositivi iOS, i file vivono sotto Application Support e sono esclusi dal backup iCloud. Sui dispositivi Android, i file vivono sotto il directory dei file interni dell'app. Il sistema non considera questi file come file di cache dispendibili, ma l'eliminazione dell'app, la pulizia dei dati dell'app, clear(), e remove() ancora li elimina.

Riferimento completo

Continua da Utilizzo @capgo/capacitor-cache-asset

Se stai utilizzando Usando @capgo/capacitor-cache-asset per pianificare il caricamento dei media persistente, connettilo con @capgo/capacitor-cache-asset per i dettagli di implementazione, Avvio per i dettagli di implementazione, @capgo/capacitor-download per scarichi di background espliciti, e @capgo/capacitor-file per l'accesso ai file locali generali.