react-native-video/docs/pages/other/caching.md

31 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

2018-07-19 01:46:27 -06:00
# Caching
Caching is supported on `iOS` platforms with a CocoaPods setup, and on `android` using `SimpleCache`.
2018-07-19 01:46:27 -06:00
## Android
Android uses a LRU `SimpleCache` with a variable cache size that can be specified by bufferConfig - cacheSizeMB. This creates a folder named `RNVCache` in the app's `cache` folder. Do note RNV does not yet offer a native call to flush the cache, it can be flushed by clearing the app's cache.
In addition, this resolves RNV6's repeated source URI call problem when looping a video on Android.
## iOS
### Technology
2018-07-19 01:46:27 -06:00
The cache is backed by [SPTPersistentCache](https://github.com/spotify/SPTPersistentCache) and [DVAssetLoaderDelegate](https://github.com/vdugnist/DVAssetLoaderDelegate).
### How Does It Work
2018-07-19 01:46:27 -06:00
The caching is based on the url of the asset.
SPTPersistentCache is a LRU ([Least Recently Used](<https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_recently_used_(LRU)>)) cache.
2018-07-19 01:46:27 -06:00
### Restrictions
Currently, caching is only supported for URLs that end in a `.mp4`, `.m4v`, or `.mov` extension. In future versions, URLs that end in a query string (e.g. test.mp4?resolution=480p) will be support once dependencies allow access to the `Content-Type` header. At this time, HLS playlists (.m3u8) and videos that sideload text tracks are not supported and will bypass the cache.
You will also receive warnings in the Xcode logs by using the `debug` mode. So if you are not 100% sure if your video is cached, check your Xcode logs!
By default files expire after 30 days and the maximum cache size is 100mb.
2018-07-19 01:46:27 -06:00
In a future release the cache might have more configurable options.