メインコンテンツにスキップ
プラグインに戻る
@capgo/capacitor-アセットキャッシュ
チュートリアル
@capgo/capacitor-アセットキャッシュ

アセット キャッシュ

CDN イメージとビデオを永続的アプリストレージにキャッシュし、ローカルメディアソースとしてバインドする

ガイド

アセット キャッシュのチュートリアル

Using @capgo/capacitor-asset-cache

@capgo/capacitor-asset-cache Capacitor ウェブビューで、CDN の大きな画像や動画をアプリ所有の永続ストレージに保存し、ローカル ソース URL を返します。

インストール

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

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

  • bind - ローカル アセット ソースに画像または動画要素を接続し、ローカル アセットが利用可能になったときに更新します。
  • src - ローカル アセットが利用可能になった後、ローカル ソース文字列を返します。
  • resolve - __CAPGO_KEEP_0__をローカルソースとキャッシュメタデータを含む。
  • configure - デフォルトのCDNと再検証の動作を設定。
  • get, list, remove, clear, getCacheSize

- 必要に応じてキャッシュを明示的に管理。

例:使用方法

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

CDNを一度設定し、相対パスのバインドで要素をバインドする。 data-asset-cache-state="loading" 要素は 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}`,
  },
});

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

CDNベースURLなし cdnUrl.

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

相対パスは、既に設定されている cdnUrl または、呼び出しごとに cdnUrl.

ストレージの注意

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

フルリファレンス

Capgoを使用している場合から続けてください @capgo/capacitor-asset-cache

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