Trên GitHub, danikula/AndroidVideoCache đã đạt 5.5k sao, nhóm Mobile, ngôn ngữ Java. Cache support for any video player with help of single line
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Because there is no sense to download video a lot of times while streaming!
AndroidVideoCache allows to add caching support to your VideoView/MediaPlayer, ExoPlayer or any another player with help of single line!
Features
caching to disk during streaming;
offline work with cached resources;
partial loading;
cache limits (max cache size, max files count);
multiple clients for same url.
Note AndroidVideoCache works only with direct urls to media file, it doesn't support any streaming technology like DASH, SmoothStreaming, HLS.
Get started
Just add dependency (AndroidVideoCache is available in jcenter):
and use url from proxy instead of original url for adding caching:
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
HttpProxyCacheServer proxy = getProxy();
String proxyUrl = proxy.getProxyUrl(VIDEO_URL);
videoView.setVideoPath(proxyUrl);
}
private HttpProxyCacheServer getProxy() {
// should return single instance of HttpProxyCacheServer shared for whole app.
}
To guarantee normal work you should use single instance of HttpProxyCacheServer for whole app.
For example you can store shared proxy in your Application:
public class App extends Application {
private HttpProxyCacheServer proxy;
public static HttpProxyCacheServer getProxy(Context context) {
App app = (App) context.getApplicationContext();
return app.proxy == null ? (app.proxy = app.newProxy()) : app.proxy;
}
private HttpProxyCacheServer newProxy() {
return new HttpProxyCacheServer(this);
}
}
or use simple factory.
More preferable way is use some dependency injector like Dagger.
Recipes
Disk cache limit
By default HttpProxyCacheServer uses 512Mb for caching files. You can change this value:
private HttpProxyCacheServer newProxy() {
return new HttpProxyCacheServer.Builder(this)
.maxCacheSize(1024 * 1024 * 1024) // 1 Gb for cache
.build();
}
or can limit total count of files in cache:
private HttpProxyCacheServer newProxy() {
return new HttpProxyCacheServer.Builder(this)
.maxCacheFilesCount(20)
.build();
}
Use HttpProxyCacheServer.registerCacheListener(CacheListener listener) method to set listener with callback onCacheAvailable(File cacheFile, String url, int percentsAvailable) to be aware of caching progress. Do not forget to to unsubscribe listener with help of HttpProxyCacheServer.unregisterCacheListener(CacheListener listener) method to avoid memory leaks.
Use HttpProxyCacheServer.isCached(String url) method to check was url's content fully cached to file or not.
See sample app for more details.
Providing names for cached files
By default AndroidVideoCache uses MD5 of video url as file name. But in some cases url is not stable and it can contain some generated parts (e.g. session token). In this case caching mechanism will be broken. To fix it you have to provide own FileNameGenerator:
public class MyFileNameGenerator implements FileNameGenerator {
// Urls contain mutable parts (parameter 'sessionToken') and stable video's id (parameter 'videoId').
// e. g. http://example.com?videoId=abcqaz&sessionToken=xyz987
public String generate(String url) {
Uri uri = Uri.parse(url);
String videoId = uri.getQueryParameter("videoId");
return videoId + ".mp4";
}
}
...
HttpProxyCacheServer proxy = new HttpProxyCacheServer.Builder(context)
.fileNameGenerator(new MyFileNameGenerator())
.build()
Adding custom http headers
You can add custom headers to requests with help of HeadersInjector:
public class UserAgentHeadersInjector implements HeaderInjector {
@Override
public Map<String, String> addHeaders(String url) {
return Maps.newHashMap("User-Agent", "Cool app v1.1");
}
}
private HttpProxyCacheServer newProxy() {
return new HttpProxyCacheServer.Builder(this)
.headerInjector(new UserAgentHeadersInjector())
.build();
}
Using exoPlayer
You can use exoPlayer with AndroidVideoCache. See sample app in exoPlayer branch. Note exoPlayer supports cache as well.
Sample
See sample app.
Known problems
In some cases clients can't connect to local proxy server ('Error pinging server' error). May be it is result of previous error. Note in this case video will be played, but without caching.
Whats new
See Release Notes here
Code contributions
If it's a feature that you think would need to be discussed please open an issue first, otherwise, you can follow this process:
Fork the project
Create a feature branch (git checkout -b my_branch)
Fix a problem. Your code must contain test for reproducing problem. Your tests must be passed with help of your fix
Push your changes to your new branch (git push origin my_branch)
Initiate a pull request on github
Rebase master branch if your local branch is not actual. Merging is not acceptable, only rebase
Your pull request will be reviewed and hopefully merged :)
Copyright 2014-2017 Alexey Danilov
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
danikula/AndroidVideoCache thuộc nhóm Mobile trên TopGit, cùng 3 topic GitHub. Trang Trending và Topics liệt kê các repo cùng số sao và cùng ngôn ngữ để so sánh.
danikula/AndroidVideoCache có phải mã nguồn mở không?
Có — danikula/AndroidVideoCache phát hành theo license Apache-2.0, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/danikula/AndroidVideoCache.
danikula/AndroidVideoCache là gì?
danikula/AndroidVideoCache (danikula/AndroidVideoCache) là dự án Java trên GitHub. Theo mô tả gốc: Cache support for any video player with help of single line
danikula/AndroidVideoCache so với các dự án Mobile khác thế nào?
danikula/AndroidVideoCache được TopGit xếp vào nhóm Mobile, với 5.5k sao GitHub và viết bằng Java. Xem trang chủ đề Mobile trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
Đọc thêm về danikula/AndroidVideoCache ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/danikula/AndroidVideoCache là nguồn chính thức.
Vì sao danikula/AndroidVideoCache được xếp vào nhóm Mobile?
TopGit xếp danikula/AndroidVideoCache vào nhóm Mobile dựa trên GitHub topics và mô tả của repo (gắn thẻ: "android", "cache", "video"). Việc phân loại dựa trên metadata thật của repo, không phải đoán theo cảm tính biên tập.
Đọc đầy đủ README ở tab phía trên.
AndroidVideoCache có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về AndroidVideoCache.