Skip to content
Capgo - Capacitor アプリのリアルタイム更新 Capgo

@capgo/capacitor-アセットキャッシュ

アプリ所有のパーシステントストレージに重いCDNメディアをキャッシュし、ローカルウェブビューURLに画像や動画をバインドする。
始める GitHub

ローカルのみ表示ソース

src, resolve, そして bind ローカルファイルが存在する場合にのみソースを返します。imgまたはvideoタグはローカルウェブビューURLを受け取ります。

永続的なネイティブストレージ

キャッシュされたアセットは、システムが圧力下で削除する可能性のあるプラットフォームキャッシュフォルダではなく、永続的なストレージに保存されます。

保護されたCDNサポート

署名または認証されたアセットの場合、ネイティブのフェッチにヘッダーを渡し、Web要素はローカルファイルのみを読み込むようにします。

フレームワークフレンドリーなバインディング

imgまたはvideo srcを割り当てることができる平凡なHTML、React refs、Vue refs、またはフレームワークをバインドしてネイティブキャッシュ解決を実行します。

概要

「概要」のセクション

@capgo/capacitor-asset-cache キャッシュされた大きな画像、動画、またはCDNアセットは、WebアプリにローカルソースURLを提供するために、永続的なストレージに保存されます。

通常のパスは次のとおりです。

  1. CDNのベースURLを一度に設定するか、絶対URLをアセットごとに渡します。
  2. Call AssetCache.bind(element, path) or AssetCache.src(path).
  3. プラグインはリモートアセットをネイティブに取得または再検証します。
  4. 要素は、ローカルファイルが準備された後、ローカルウェブビューURLを受け取ります。

使用するタイミング

使用するタイミング

アセットキャッシュを使用するには、通常のストレージ圧力で存続する必要がある重いリモートメディアを表示するアプリがあります:

  • CDNから配信されるオンボーディングまたはマーケティングビデオ
  • セッションをまたいで繰り返し使用されるヒーロー画像、ギャラリー、または画像シーケンス
  • リクエストヘッダーが必要な保護されたメディア
  • オフライン対応の画面では、以前取得したローカルアセットが十分です
  • Capacitorアプリ <img> そして <video> 保護されたURLを直接取得しないようにする

Core API

セクション「Core API」
  • configure(options) デフォルトのCDNと再検証の動作を設定します。
  • bind(element, path, options?) ローカルファイルが使用可能になったときに、画像またはビデオ要素を更新します。
  • src(path, options?) framework のローカルソース文字列を返します。
  • resolve(path, options?) ローカルソース文字列にキャッシュメタデータを追加します。
  • get(options) リモート URL を永続的なネイティブファイルメタデータに解決します。
  • remove(options) 指定されたキーまたは URL のキャッシュされたアセットを 1 つ削除します。
  • clear() プラグインが管理するすべてのキャッシュされたアセットを削除します。
  • list() ディスク上にまだ存在するキャッシュされたアセットを返します。
  • getCacheSize() キャッシュされたバイトの合計を返します。
  • getPluginVersion() ネイティブ実装のバージョンマーカーを返します。

再検証モデル

「再検証モデル」

アセットごとにまたはデフォルトでキャッシュを確認できます。

戦略動作
neverローカルファイルを使用します。
ttl再ダウンロード後 maxAgeSeconds.
always毎回再検証し、知られている検証者を送信します。
etag知られているHTTP ETag検証者を使用します。
last-modified知られているHTTP Last-Modified検証者を使用します。

ストレージモデル

iOSでは、ファイルはApplication Support下に保存され、キャッシュルートはiCloudバックアップから除外されます。 Androidでは、ファイルはアプリ内ファイルディレクトリ下に保存されます。

キャッシュはアプリサンドボックス内に隠されており、パブリックユーザーメディアとして表示されません。 アプリがアンインストールされたとき、ユーザーがアプリデータをクリアしたとき、またはあなたのアプリが

または clear() キャッシュはアプリサンドボックス内に隠されており、パブリックユーザーメディアとして表示されません。 アプリがアンインストールされたとき、ユーザーがアプリデータをクリアしたとき、またはあなたのアプリが remove().

Keep going from @capgo/capacitor-asset-cache

「@capgo/capacitor-アセットキャッシュ」から続けてください

Capgoを使用している場合 @capgo/capacitor-アセットキャッシュ 持続的なメディアのロードを計画する場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-アセットキャッシュを 実装の詳細について 「@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-ダウンローダー」 @capgo/capacitor-downloader 「@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-ファイル」 @capgo/capacitor-file 「@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-アセットキャッシュ」のチュートリアルを参照してください @capgo/capacitor-ダウンローダー @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-ファイル