로컬 전용 디스플레이 소스
src, resolve, 그리고 bind 로컬 파일이 존재할 때만 소스를 반환합니다. img나 video 태그는 로컬 webview URL을 전달받습니다.
로컬 전용 디스플레이 소스
src, resolve, 그리고 bind 로컬 파일이 존재할 때만 소스를 반환합니다. img나 video 태그는 로컬 webview URL을 전달받습니다.
영구 네이티브 스토리지
캐시된 에셋은 시스템이 용량 부족 시 비울 수 있는 플랫폼 캐시 폴더가 아니라 앱이 소유한 영구 스토리지에 저장됩니다.
보호된 CDN 지원
서명되거나 인증이 필요한 에셋을 위해 네이티브 fetch에 헤더를 전달하면서, 웹 요소는 여전히 로컬 파일만 로드합니다.
프레임워크 친화적 바인딩
네이티브 캐시 확인을 일반 HTML, React refs, Vue refs 또는 img나 video src를 지정할 수 있는 모든 프레임워크에 바인딩하세요.
CDN 이미지와 비디오를 앱의 영구 저장소에 캐싱하고 로컬 미디어 소스로 바인딩합니다
시작하기 cancel() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.
| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 네이티브 |
| Android | 지원 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 보호하세요 |
앱에서 일반적인 스토리지 부족에도 유지되어야 하는 용량이 큰 원격 미디어를 표시한다면 Asset Cache를 사용하세요:
<img> 및 <video> 보호된 URL을 직접 fetch하면 안 됩니다configure(options) 기본 CDN 및 재검증 동작을 설정합니다.bind(element, path, options?) 로컬 파일이 준비되면 이미지 또는 비디오 요소를 업데이트합니다.src(path, options?) 프레임워크 상태에 사용할 로컬 소스 문자열을 반환합니다.resolve(path, options?) 로컬 소스와 캐시 메타데이터를 함께 반환합니다.get(options) 원격 URL을 영구 네이티브 파일 메타데이터로 변환합니다.remove(options) 키 또는 URL로 캐시된 에셋 하나를 제거합니다.clear() 플러그인이 관리하는 모든 캐시 에셋을 제거합니다.list() 디스크에 아직 존재하는 캐시 에셋을 반환합니다.getCacheSize() 캐시된 총 바이트 수를 반환합니다.getPluginVersion() 네이티브 구현 버전 마커를 반환합니다.캐시는 에셋별로 또는 기본값을 통해 다양한 방식으로 확인할 수 있습니다:
| 전략 | 동작 방식 |
|---|---|
never | 로컬 파일이 있으면 해당 파일을 사용합니다. |
ttl | 이후 다시 다운로드 maxAgeSeconds. |
always | 매 호출마다 재검증하고 알려진 validator를 전송합니다. |
etag | 알려진 HTTP ETag validator가 있으면 사용합니다. |
last-modified | 알려진 HTTP Last-Modified validator가 있으면 사용합니다. |
iOS에서는 파일이 Application Support 아래에 저장되며 캐시 루트는 iCloud 백업에서 제외됩니다. Android에서는 파일이 앱 내부 파일 디렉터리에 저장됩니다.
캐시는 앱 샌드박스 내부에 숨겨져 있어 공개 사용자 미디어로 노출되지 않습니다. 앱을 제거하거나, 사용자가 앱 데이터를 지우거나, 앱에서 다음을 호출하면 캐시가 삭제됩니다. clear() 또는 remove().
사용 중이라면 @capgo/capacitor-asset-cache 지속적인 미디어 로딩을 계획하려면 다음을 연결하세요: 시작하기 구현 세부 사항은 다음을 참조하세요: @capgo/capacitor-downloader 명시적 백그라운드 다운로드에는, @capgo/capacitor-file 일반 로컬 파일 액세스에는, 그리고 @capgo/capacitor-asset-cache를 사용하여 튜토리얼에 사용합니다.