使用方法: @capgo/capacitor-asset-cache

@capgo/capacitor-asset-cache アセットキャッシュは、CDNの画像や動画をアプリの持つ永続ストレージに保存し、CapacitorのWebビュー用にローカルソースのURLを返します。

インストール

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

このプラグインが公開するもの

bind - ローカルアセットソースに画像や動画要素を追加し、ローカルに存在するときに更新します。
src - アセットがローカルに存在するときにローカルソースの文字列を返します。
resolve - ローカルソースとキャッシュメタデータを返します。
configure - デフォルトのCDNと再検証の動作を設定します。
get, list, remove, clear, そして getCacheSize - キャッシュを明示的に管理する必要がある場合にのみ。

例の使用

CDNを一度設定し、相対パスのバインド要素を設定します。

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

要素は data-asset-cache-state="loading" ネイティブのフェッチが実行されるときに、ローカルソースのURLを受け取り、 ready.

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

保護されたアセット

プラグインがリモートファイルをフェッチまたは再検証するときにヘッダーを送信します。ウェブ要素はローカルソースのURLのみを受け取ります。

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

CDNベースURLなし

CDNベースURLを設定しない場合は、絶対URLを渡します。 cdnUrl.

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

相対パスは、あるいは cdnUrl または cdnUrl.

ストレージに関する注意

iOSでは、ファイルはアプリケーションサポート下にあり、iCloudバックアップから除外されます。 Androidでは、ファイルはアプリの内部ファイルディレクトリ下にあります。システムは、これらのファイルを廃棄可能なキャッシュファイルとして扱いませんが、アンインストール、データクリア clear(), remove() ファイルは削除されます。

フルリファレンス

GitHub: https://github.com/Cap-go/capacitor-asset-cache/
ドキュメント: /docs/plugins/asset-cache/

使用中の@capgo/capacitor-asset-cacheから続けてください。

Capacitor Asset Cacheを使用している場合 Using @capgo/capacitor-asset-cache 持続的なメディアの読み込みを計画するために、@Capacitorアセットキャッシュに接続 @capgo/capacitor-asset-cache 実装の詳細について Getting Started 実装の詳細について @capgo/capacitor-downloader 明示的なバックグラウンドダウンロードのために、 @capgo/capacitor-file 一般的なローカルファイルアクセス用に

アセット キャッシュ