@capgo/capacitor-asset-cache

로컬 전용 표시 소스

src, resolve, 그리고 bind 로컬 파일이 존재하는지 확인한 후 원본만 반환합니다. img 또는 video 태그는 로컬 웹뷰 URL을 받습니다.

영구 저장소

캐시된 자산은 앱 소유의 영구 저장소에 저장되며, 시스템이 압박을 받을 때 플랫폼 캐시 폴더에서 삭제할 수 있습니다.

보호된 CDN 지원

인증된 자산이나 서명된 자산을 로드하는 동안 네이티브 fetch에 헤더를 전달합니다.

프레임워크 친화적인 바인딩

plain HTML, React refs, Vue refs, 또는 img 또는 video src를 할당할 수 있는 프레임워크와 같은 모든 프레임워크에 네이티브 캐시 해제를 바인딩합니다.

개요

@capgo/capacitor-asset-cache 대형 이미지, 비디오 및 기타 CDN 자산을 앱 소유의 영구 저장소에 캐시하고 웹 앱에 로컬 소스 URL을 제공합니다.

일반적인 경로는 다음과 같습니다.

1. CDN 기본 URL을 한 번만 설정하거나, 각 자산에 대해 절대 URL을 전달합니다.
2. 호출 AssetCache.bind(element, path) 또는 AssetCache.src(path).
3. 이 플러그인은 원격 자산을 원본으로 가져오거나 다시 유효성을 검사합니다.
4. 이 요소는 로컬 파일이 준비되기까지 로컬 웹뷰 URL만 받습니다.

주의

성공적인 표시 API는 로컬 전용입니다. 플러그인이 로컬 파일을 만들거나 재사용할 수 없다면 src(...) 그리고 resolve(...) 거부하고 bind(...) 요소를 표시합니다. error.

사용하는 경우

heavy remote media가 normal storage pressure에 의해 살아남아야 하는 경우 Asset Cache를 사용하세요:

• CDN에서 제공하는 onboarding or marketing 비디오
• session을跨越하는 hero 이미지, 갤러리, 또는 이미지 시퀀스
• request 헤더가 필요한 보호된 미디어
• 이전에 다운로드 한 지역 자산이 충분한 경우 offline-tolerant 화면
• Capacitor 앱에서 <img> protected URL을 직접 fetch하지 않도록 하세요 <video> Core __CAPGO_KEEP_0__

Core API

• configure(options) 이미지 또는 비디오 요소를 지역 파일이 준비되면 업데이트합니다.
• bind(element, path, options?) and
• src(path, options?) framework 상태를 위한 지역 소스 문자열을 반환합니다.
• resolve(path, options?) 캐시 메타데이터를 포함한 지역 소스 문자열을 반환합니다.
• get(options) 영구 네이티브 파일 메타데이터로 원격 URL을 해결합니다.
• remove(options) 키 또는 URL로 하나의 캐시된 자산을 제거합니다.
• clear() 플러그인이 관리하는 모든 캐시된 자산을 제거합니다.
• list() 디스크에 아직 존재하는 캐시된 자산을 반환합니다.
• getCacheSize() 총 캐시 바이트를 반환합니다.
• getPluginVersion() 네이티브 implementation 버전 마커를 반환합니다.

재검증 모델

자산당으로 또는 기본값으로 캐시를 확인할 수 있습니다.

전략	행동
never	사용 가능한 파일을 로컬에서 사용합니다.
ttl	재 다운로드 maxAgeSeconds.
always	모든 호출에서 재 검증하고 알려진 검증자들을 전송합니다.
etag	사용 가능한 HTTP ETag 검증자 사용
last-modified	사용 가능한 HTTP Last-Modified 검증자 사용

저장 모델

캐시는 앱 샌드박스 내부에 숨겨져 있으며 공공 사용자 미디어로 표시되지 않습니다. 앱이 삭제되면, 사용자가 앱 데이터를 삭제하거나, 또는 앱이

또는 clear() 앱플로우 remove().

Keep going from @capgo/capacitor-asset-cache

If you are using capgo/capacitor-asset-cache to plan persistent media loading, connect it with Getting Started for implementation details, capgo/capacitor-downloader for explicit background downloads, capgo/capacitor-file for general local file access, and capgo/capacitor-asset-cache 사용하기 for the tutorial.