https://github.com/zhgchgli/zplayercacher
ZPlayerCacher is a lightweight implementation of the AVAssetResourceLoaderDelegate protocol that enables AVPlayerItem to support caching streaming files.
https://github.com/zhgchgli/zplayercacher
audio-caching audio-streaming avassetresourceloaderdelegate avfoundation cache caching-library ios resourceloader streaming-audio swift video-cache
Last synced: 3 months ago
JSON representation
ZPlayerCacher is a lightweight implementation of the AVAssetResourceLoaderDelegate protocol that enables AVPlayerItem to support caching streaming files.
- Host: GitHub
- URL: https://github.com/zhgchgli/zplayercacher
- Owner: ZhgChgLi
- License: mit
- Created: 2023-03-12T09:39:39.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-27T03:08:58.000Z (7 months ago)
- Last Synced: 2024-11-25T18:39:08.427Z (6 months ago)
- Topics: audio-caching, audio-streaming, avassetresourceloaderdelegate, avfoundation, cache, caching-library, ios, resourceloader, streaming-audio, swift, video-cache
- Language: Swift
- Homepage: https://link.zhgchg.li/
- Size: 70.3 KB
- Stars: 20
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ZPlayerCacher
ZPlayerCacher is a lightweight implementation of the AVAssetResourceLoaderDelegate protocol that enables AVPlayerItem to support caching streaming files.
> Please note that while this project serves as a demonstration of AVFoundation AVAssetResourceLoaderDelegate and the use of Combine to manage data flow, the code may not be written to the highest standard of cleanliness. If you have any suggestions for improving the code, please feel free to create an issue or pull request on the repository.
- [Technical Detail - AVPlayer 實踐本地 Cache 功能大全](https://medium.com/zrealm-ios-dev/avplayer-%E5%AF%A6%E8%B8%90%E6%9C%AC%E5%9C%B0-cache-%E5%8A%9F%E8%83%BD%E5%A4%A7%E5%85%A8-6ce488898003)
# Buy me a coffee ❤️❤️❤️
[**If this project has helped you, feel free to sponsor me a cup of coffee, thank you.**](https://www.buymeacoffee.com/zhgchgli)
## Installation
### Swift Package Manager
- File > Swift Packages > Add Package Dependency
- Add `https://github.com/ZhgChgLi/ZPlayerCacher.git`
- Select "Up to Next Major" with "1.0.0"
or
```swift
...
dependencies: [
.package(url: "https://github.com/ZhgChgLi/ZPlayerCacher.git", from: "1.0.0"),
]
...
.target(
...
dependencies: [
"ZPlayerCacher",
],
...
)
```
### CocoaPods
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'
use_frameworks!
target 'MyApp' do
pod 'ZPlayerCacher', '~> 1.0.0'
end
```
## Usage
```swift
let cacher: Cacher = PINCacher() // your implementation of Local Cache policy (Cacher Protocol), ref: /Sources/ZPlayerCacher/DataFetcherStrategy/Cacher/PINCacher.md
let logger = DefaultPlayerCacherLogger()
let factory = CacheableAVURLAssetFactory(cacher: cacher, logger: logger).makeCacheableAVURLAssetIfSupported(url: url)
let playerItem = AVPlayerItem(asset: asset) // than playerItem will support caching
// DefaultPlayerCacherLogger:
class DefaultPlayerCacherLogger: PlayerCacherLogger {
var loggerLevel: PlayerCacherLevel = .info
}
// PINCacher:
public final class PINCacher: Cacher {
static let cache: PINCache = PINCache(name: "ResourceLoader")
private lazy var jsonDecoder = JSONDecoder()
public func set(key: String, data: Data, completion: ((Error?) -> Void)?) {
PINCacher.cache.setObjectAsync(data, forKey: key, completion: nil)
}
public func get(key: String) -> Data? {
let data = PINCacher.cache.object(forKey: key) as? Data
return data
}
public static func clean() {
PINCacher.cache.removeAllObjects()
}
public static func setByteLimit(memoryByteLimit: UInt, diskByteLimit: UInt) {
PINCacher.cache.memoryCache.costLimit = memoryByteLimit
PINCacher.cache.diskCache.byteLimit = diskByteLimit
}
}
```
### Example
- ZPlayerCacherExample/ZPlayerCacherExample.xcodeproj
## Things to know
- Due to limitations in the Apple iOS system, currently unsupported video formats such as HLS file format(.ts) are not supported by ZPlayerCacher.
## Who is using
[](https://en.pinkoi.com)
[Pinkoi.com](https://en.pinkoi.com) is Asia's leading online marketplace for original design goods, digital creations, and workshop experiences.
## About
- [ZhgChg.Li](https://zhgchg.li/)
- [ZhgChgLi's Medium](https://blog.zhgchg.li/)
## Other works
### Swift Libraries
- [ZMarkupParser](https://github.com/ZhgChgLi/ZMarkupParser) is a pure-Swift library that helps you to convert HTML strings to NSAttributedString with customized style and tags.
- [ZPlayerCacher](https://github.com/ZhgChgLi/ZPlayerCacher) is a lightweight implementation of the AVAssetResourceLoaderDelegate protocol that enables AVPlayerItem to support caching streaming files.
- [ZNSTextAttachment](https://github.com/ZhgChgLi/ZNSTextAttachment) enables NSTextAttachment to download images from remote URLs, support both UITextView and UILabel.
### Integration Tools
- [ZReviewTender](https://github.com/ZhgChgLi/ZReviewTender) is a tool for fetching app reviews from the App Store and Google Play Console and integrating them into your workflow.
- [ZMediumToMarkdown](https://github.com/ZhgChgLi/ZMediumToMarkdown) is a powerful tool that allows you to effortlessly download and convert your Medium posts to Markdown format.
- [linkyee](https://github.com/ZhgChgLi/linkyee) is a fully customized, open-source LinkTree alternative deployed directly on GitHub Pages.
# Donate
[](https://www.buymeacoffee.com/zhgchgli)
If you find this library helpful, please consider starring the repo or recommending it to your friends.
Feel free to open an issue or submit a fix/contribution via pull request. :)