Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/changsanjiang/SJMediaCacheServer
SJMediaCacheServer 是一个高效的 HTTP 媒体缓存框架，旨在代理媒体数据请求并优先提供缓存数据，从而减少网络流量并增强播放的流畅性。该框架支持两种类型的远程资源：基于文件的媒体，如 MP3、AAC、WAV、FLAC、OGG、MP4 和 MOV 等常见格式，以及 HLS（HTTP Live Streaming）流。它会自动解析 HLS 播放列表并代理各个媒体片段。
https://github.com/changsanjiang/SJMediaCacheServer
audio cache hls hls-media m3u8 media mp3 mp4 player prefetch video video-cache vod
Last synced: about 2 months ago
JSON representation
SJMediaCacheServer 是一个高效的 HTTP 媒体缓存框架，旨在代理媒体数据请求并优先提供缓存数据，从而减少网络流量并增强播放的流畅性。该框架支持两种类型的远程资源：基于文件的媒体，如 MP3、AAC、WAV、FLAC、OGG、MP4 和 MOV 等常见格式，以及 HLS（HTTP Live Streaming）流。它会自动解析 HLS 播放列表并代理各个媒体片段。
- Host: GitHub
- URL: https://github.com/changsanjiang/SJMediaCacheServer
- Owner: changsanjiang
- License: mit
- Created: 2020-05-30T10:14:20.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-11-14T07:15:09.000Z (2 months ago)
- Last Synced: 2024-11-14T07:19:20.320Z (2 months ago)
- Topics: audio, cache, hls, hls-media, m3u8, media, mp3, mp4, player, prefetch, video, video-cache, vod
- Language: Objective-C
- Homepage:
- Size: 6.62 MB
- Stars: 246
- Watchers: 8
- Forks: 53
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - SJMediaCacheServer - A HTTP Media Caching Framework. It can cache FILE or HLS media. 音视频边播边缓存框架, 支持 HLS(m3u8) 和 FILE(mp4, mp3等). (iOS / HTTPCache)
- awesome - SJMediaCacheServer - A HTTP Media Caching Framework. It can cache FILE or HLS media. 音视频边播边缓存框架, 支持 HLS(m3u8) 和 FILE(mp4, mp3等). (iOS / HTTPCache)
README
# SJMediaCacheServer
**SJMediaCacheServer** is an efficient HTTP media caching framework designed to proxy media data requests and prioritize serving cached data, thereby reducing network traffic and enhancing playback smoothness. The framework supports two types of remote resources: file-based media, such as common formats like MP3, AAC, WAV, FLAC, OGG, MP4, and MOV, as well as HLS (HTTP Live Streaming) streams. It automatically parses HLS playlists and proxies individual media segments.
The design of SJMediaCacheServer effectively reduces the number of network requests by serving cached content, thereby improving the playback experience for remote media resources whenever possible.
## Installation
```ruby
pod 'SJUIKit/SQLite3', :podspec => 'https://gitee.com/changsanjiang/SJUIKit/raw/master/SJUIKit-YYModel.podspec'
pod 'SJMediaCacheServer'
```
## Features
- **Proxy Playback Requests**: Efficiently proxy playback requests by converting original URLs into local proxy URLs. The media player retrieves the data from the local server, which serves cached data if available, or fetches it from the remote server if necessary. This mechanism reduces network usage and enhances playback speed and reliability.
- **Format Support**: Supports two types of remote resources:
- file-based media (e.g., MP3, AAC, WAV, FLAC, OGG, MP4, MOV)
- HLS (HTTP Live Streaming) streams.
- **Cache Management Options**:
- **Cache Count Limits**: Control the number of items stored in the cache to avoid overuse of local storage.
- **Maximum Disk Storage Time**: Configure how long items are retained in the cache before being purged, managing long-term storage effectively.
- **Available Disk Space Limits**: Ensure the cache stays within a specified disk usage limit, preventing cache overflow from occupying too much local storage.
- **Advanced Prefetching Capabilities**:
- **Concurrent Prefetching**: Use the maxConcurrentPrefetchCount property to control the maximum number of concurrent prefetch tasks, optimizing the prefetching process without overwhelming system resources.
- **Flexible Prefetching Methods**:
- **Full Data Prefetching**: Use `prefetchWithURL:` to download all data related to a specific media asset, ensuring that the entire resource is available for playback without additional network requests.
- **Size-Specific Prefetching**: With `prefetchWithURL:prefetchSize:`, request a predefined amount of data for partial prefetching. This is particularly useful for optimizing both bandwidth and storage while ensuring smooth playback.
- **File Count Prefetching for HLS**: Leverage the `prefetchWithURL:prefetchFileCount:` method to prefetch a certain number of segment files for HLS assets. This ensures uninterrupted playback by caching multiple segments in advance, which is especially useful in low-bandwidth environments.
- **Custom Request Configuration**:
- **Request Modification**: Modify outgoing requests by adding custom headers. Example:
```objc
self.requestHandler = ^(NSMutableURLRequest *request) {
[request addValue:@"YourHeaderValue" forHTTPHeaderField:@"YourHeaderField"];
};
```
- **Custom HTTP Headers**: Configure HTTP headers for specific asset URLs, such as HLS keys or segments. Example:
```objc
[self setHTTPHeaderField:@"YourHeaderField" withValue:@"YourHeaderValue" forAssetURL:assetURL ofType:MCSDataTypeHLS];
```
- **Data Encryption & Decryption**: Encrypt data before writing to the cache and decrypt after reading. Example:
```objc
self.writeDataEncryptor = ^NSData *(NSURLRequest *request, NSUInteger offset, NSData *data) {
return encryptedData; // Apply encryption
};
self.readDataDecryptor = ^NSData *(NSURLRequest *request, NSUInteger offset, NSData *data) {
return decryptedData; // Apply decryption
};
```
- **Asset Type & Identifier Resolution**: Use custom logic to determine the asset type and identifier. Example:
```objc
self.resolveAssetType = ^MCSAssetType(NSURL *URL) {
return [URL.pathExtension isEqualToString:@"m3u8"] ? MCSAssetTypeHLS : MCSAssetTypeFILE;
};
self.resolveAssetIdentifier = ^NSString *(NSURL *URL) {
return [NSURLComponents componentsWithURL:URL resolvingAgainstBaseURL:NO].URL.absoluteString;
};
```
## Example Use Case
```objc
@implementation YourPlayerController {
AVPlayer *_player;
}
- (instancetype)initWithURL:(NSURL *)URL {
self = [super init];
if ( self ) {
// Convert the original URL to a proxy URL
NSURL *playbackURL = [SJMediaCacheServer.shared proxyURLFromURL:URL];
_player = [AVPlayer playerWithURL:playbackURL];
}
return self;
}
- (void)play {
[SJMediaCacheServer.shared setActive:YES];
[_player play];
}
- (void)seekToTime:(NSTimeInterval)time {
[SJMediaCacheServer.shared setActive:YES];
[_player seekToTime:time];
}
@end
```
## License
SJMediaCacheServer is released under the MIT license.
## Feedback
- GitHub : [changsanjiang](https://github.com/changsanjiang)
- Email : [email protected]
- QQGroup: 930508201
## Reference
- [KTVHTTPCache](https://github.com/ChangbaDevs/KTVHTTPCache) - KTVHTTPCache is a powerful media cache framework. It can cache HTTP request, and very suitable for media resources.
- https://tools.ietf.org/html/rfc7233#section-2.1