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

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

始める GitHub

ローカルみるソース

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

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

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

保護されたCDNサポート

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

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

ネイティブキャッシュ解決を単純なHTML、React参照、Vue参照、またはimgまたはvideo srcを割り当てることができる任意のフレームワークにバインドします。

概要

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

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

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

使用するタイミング

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

オンボーディングまたはマーケティングビデオがCDNから提供される場合
セッションをまたいで繰り返し使用されるヘローアイコン、ギャラリー、または画像シーケンス
リクエストヘッダーが必要な保護されたメディア
以前フェッチしたローカルアセットが十分な場合、オフライン耐性のある画面
Capacitor アプリ <img> 保護されたURLを直接フェッチしないようにする <video> Core __CAPGO_KEEP_0__

セクション「Core API」

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

再検証モデル

アセットごとにデフォルト値を使用してキャッシュを確認することができます。

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

ストレージモデル

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

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

Keep going from @capgo/capacitor-asset-cache

Capgoを使用している場合 @capgo/capacitor-アセットキャッシュ @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-アセットキャッシュを使用して、永続的なメディアの読み込みを計画する場合 Getting Started 実装の詳細については @capgo/capacitor-ダウンローダ明示的なバックグラウンドダウンロードについては @capgo/capacitor-ファイル一般的なローカルファイルアクセスについては Using @capgo/capacitor-アセットキャッシュチュートリアルについて