Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-Asset-Cache
Anleitung
@capgo/capacitor-Asset-Cache

Asset Cache

Cache CDN-Bilder und -Videos in der persistenten App-Speicherung und binden sie als lokale Medienquellen

Ansehen auf __CAPGO_KEEP_0__

Anleitung

Using @capgo/capacitor-asset-cache

@capgo/capacitor-asset-cache Verwenden Sie @Capacitor/__CAPGO_KEEP_1__-asset-cache

Speichert große CDN-Bilder und -Videos in der app-eigenen persistenten Speicherung und gibt lokale Quell-URLs für __CAPGO_KEEP_0__-Webviews zurück.

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

Installieren

  • bind Was diese Erweiterung freigibt
  • src - Befestigen Sie ein Bild- oder Videoelement an einer lokalen Assetquelle und aktualisieren Sie es, wenn es bereit ist.
  • resolve - Rufen Sie die lokale Quelle plus Cache-Metadaten zurück.
  • configure - Legen Sie die Standard-CDN- und Wiederherstellungsverhalten fest.
  • get, list, remove, clear, und getCacheSize - Verwalten Sie den Cache explizit, wenn erforderlich.

Beispielverwendung

Konfigurieren Sie eine CDN einmal, dann binden Sie Elemente über relative Pfade:

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');
}

Das Element erhält data-asset-cache-state="loading" während die native Fetch-Anfrage läuft, dann erhält es die lokale Quelle-URL und wechselt zu ready.

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

Geschützte Assets

Kopfzeilen werden vom Plugin gesendet, während es die remote Datei abruft oder wiederherstellt. Das Web-Element erhält nur die lokale Quelle-URL.

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

Ohne CDN-Base-URL

Geben Sie eine absolute URL an, wenn Sie nicht möchten, dass eine Konfiguration durchgeführt wird. cdnUrl.

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

Relative Pfade erfordern entweder eine konfigurierte cdnUrl oder eine pro-Aufruf cdnUrl.

Speichernachrichten

Bei iOS leben Dateien unter Application Support und werden von iCloud-Backup ausgeschlossen. Bei Android leben Dateien unter dem internen Dateiverzeichnis der App. Das System behandelt diese Dateien nicht als verbrauchbare Cache-Dateien, sondern löscht sie bei Uninstall, App-Daten löschen, clear()und remove() dennoch löschen sie sie.

Vollständige Referenz

Fortsetzen Sie mit der Verwendung von @capgo/capacitor-asset-cache

Wenn Sie die Nutzung von Mit @capgo/capacitor-asset-cache um persistente Medienbeladung zu planen, verbinden Sie es mit @capgo/capacitor-asset-cache zur Details der Implementierung, Anfänger zur Details der Implementierung, @capgo/capacitor-downloader zur expliziten Hintergrundherunterladen und @capgo/capacitor-file zur allgemeinen lokalen Dateizugriff.