bug 修复,readme编写
This commit is contained in:
77
README.md
77
README.md
@ -79,43 +79,49 @@ compile 'com.arialyy.aria:Aria:3.1.5'
|
||||
|
||||
### 下载状态获取
|
||||
如果你希望读取下载进度或下载信息,那么你需要创建事件类,并在onResume(Activity、Fragment)或构造函数(Dialog、PopupWindow),将该事件类注册到Aria管理器。
|
||||
* 创建事件类
|
||||
|
||||
* 将对象注册到Aria
|
||||
|
||||
` Aria.download(this).register();`或`Aria.upload(this).register();`
|
||||
```java
|
||||
@Override protected void onCreate(Bundle savedInstanceState) {
|
||||
super.onCreate(savedInstanceState);
|
||||
Aria.download(this).register();
|
||||
}
|
||||
```
|
||||
|
||||
* 使用'@Download'或'@Upload'注解你的函数
|
||||
**注意:**
|
||||
- 注解回掉采用Apt的方式实现,所以,你不需要担心这会影响你机器的性能
|
||||
- 被注解的方法**不能被private修饰**
|
||||
- 被注解的方法**只能有一个参数,并且参数类型必须是`DownloadTask`或`UploadTask`**
|
||||
- 方法名可以为任意字符
|
||||
|
||||
```java
|
||||
final static class MySchedulerListener extends Aria.DownloadSchedulerListener{
|
||||
@Override public void onTaskPre(DownloadTask task) {
|
||||
//通过下载地址可以判断任务是否是你指定的任务
|
||||
if (task.getKey().equals(DOWNLOAD_URL)) {
|
||||
mUpdateHandler.obtainMessage(DOWNLOAD_PRE, task.getDownloadEntity().getFileSize())
|
||||
.sendToTarget();
|
||||
}
|
||||
}
|
||||
@Download.onPre protected void onPre(DownloadTask task) {}
|
||||
|
||||
@Override public void onTaskStop(DownloadTask task) {
|
||||
super.onTaskStop(task);
|
||||
@Download.onTaskStart void taskStart(DownloadTask task) {
|
||||
//通过下载地址可以判断任务是否是你指定的任务
|
||||
if (task.getKey().equals(DOWNLOAD_URL)) {
|
||||
}
|
||||
|
||||
@Override public void onTaskCancel(DownloadTask task) {
|
||||
super.onTaskCancel(task);
|
||||
}
|
||||
|
||||
@Override public void onTaskRunning(DownloadTask task) {
|
||||
super.onTaskRunning(task);
|
||||
}
|
||||
|
||||
...
|
||||
}
|
||||
|
||||
@Download.onTaskRunning protected void running(DownloadTask task) {}
|
||||
|
||||
@Download.onTaskResume void taskResume(DownloadTask task) {}
|
||||
|
||||
@Download.onTaskStop void taskStop(DownloadTask task) {}
|
||||
|
||||
@Download.onTaskCancel void taskCancel(DownloadTask task) {}
|
||||
|
||||
@Download.onTaskFail void taskFail(DownloadTask task) {}
|
||||
|
||||
@Download.onTaskComplete void taskComplete(DownloadTask task) {}
|
||||
|
||||
@Download.onNoSupportBreakPoint public void onNoSupportBreakPoint(DownloadTask task) {}
|
||||
|
||||
```
|
||||
|
||||
* 将事件注册到Aria
|
||||
|
||||
```java
|
||||
@Override protected void onResume() {
|
||||
super.onResume();
|
||||
Aria.whit(this).addSchedulerListener(new MySchedulerListener());
|
||||
}
|
||||
```
|
||||
|
||||
### 使用广播接收器接收Aria的任务下载状态
|
||||
有的时候,你可能希望在广播中接收Aria的下载事件,那么你需要
|
||||
* 在[配置文件](#配置文件设置参数)中把` <openBroadcast value="false"/>`中的value改为true
|
||||
@ -134,7 +140,7 @@ compile 'com.arialyy.aria:Aria:3.1.5'
|
||||
<!--设置下载线程,线程下载数改变后,新的下载任务才会生效-->
|
||||
<threadNum value="4"/>
|
||||
|
||||
<!--是否打开下载广播,默认为false-->
|
||||
<!--是否打开下载广播,默认为false,不建议使用广播,你可以使用Download注解来实现事件回调-->
|
||||
<openBroadcast value="false"/>
|
||||
|
||||
<!--设置下载队列最大任务数, 默认为2-->
|
||||
@ -144,7 +150,7 @@ compile 'com.arialyy.aria:Aria:3.1.5'
|
||||
<reTryNum value="10"/>
|
||||
|
||||
<!--设置重试间隔,单位为毫秒,默认2000毫秒-->
|
||||
<reTryInterval value="2000"/>
|
||||
<reTryInterval value="5000"/>
|
||||
|
||||
<!--设置url连接超时时间,单位为毫秒,默认5000毫秒-->
|
||||
<connectTimeOut value="5000"/>
|
||||
@ -159,12 +165,15 @@ compile 'com.arialyy.aria:Aria:3.1.5'
|
||||
<ca name="" path=""/>
|
||||
|
||||
<!--是否需要转换速度单位,转换完成后为:1b/s、1kb/s、1mb/s、1gb/s、1tb/s,如果不需要将返回byte长度-->
|
||||
<convertSpeed value="false"/>
|
||||
<convertSpeed value="true"/>
|
||||
|
||||
<!--设置最大下载速度,单位:kb, 为0表示不限速-->
|
||||
<maxSpeed value="0"/>
|
||||
|
||||
</download>
|
||||
|
||||
<upload>
|
||||
<!--是否打开上传广播,默认为false-->
|
||||
<!--是否打开上传广播,默认为false,不建议使用广播,你可以使用Upload注解来实现事件回调-->
|
||||
<openBroadcast value="false"/>
|
||||
|
||||
<!--设置上传队列最大任务数, 默认为2-->
|
||||
|
Reference in New Issue
Block a user