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

@capgo/capacitor-asset-cache

App wa shiraberu chino no CDN media o kakucho shita persistent storage ni tsukau to, image ya video o local webview URL ni tsukeru.
Kokoro kara hajimeru GitHub

Jitai-teki storage ni miru kikō

src, resolve, to bind local file ga aru node ni kakucho shita node o kaeshite kudasai. Anata no img ya video tag wa local webview URL o uketori shite imasu.

Chino-teki kakucho storage

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

保護されたCDNサポート

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

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

ネイティブキャッシュ解決を、imgまたはvideo srcを割り当てることができるplain HTML、React refs、Vue refs、またはフレームワークのいずれかにバインドします。

概要

「概要」のタイトルが付いたセクション

@capgo/capacitor-asset-cache 大きな画像、動画、またはその他のCDNアセットをapp所有の持続可能なストレージにキャッシュし、webアプリにローカルソースURLを提供します。

通常のパスは:

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

使用するときは

セクション「使用するときは」

アセットキャッシュを使用するには、正常なストレージ圧力で存続する必要がある重いリモートメディアを表示するアプリがあります:オンボーディングまたはマーケティングビデオがCDNから提供されます。

  • onboarding or marketing videos served from a CDN
  • セッションをまたいで使用される画像、ギャラリー、または画像シーケンス
  • リクエストヘッダーが必要な保護されたメディア
  • セッションをまたいで使用される画像、ギャラリー、または画像シーケンス
  • Capacitor アプリケーションでは <img> そして <video> __CAPGO_KEEP_0__ アプリケーションでは直接保護された URL を取得しないようにする

Core API

セクションのタイトル “Core API”
  • configure(options) デフォルトの CDN と再検証の動作を設定します。
  • bind(element, path, options?) ローカルファイルが使用可能になったときに画像または動画要素を更新します。
  • src(path, options?) フレームワークの状態のローカルソース文字列を返します。
  • 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().

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

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

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