diff --git a/Aria参数配置.md b/Aria参数配置.md new file mode 100644 index 0000000..b968bb3 --- /dev/null +++ b/Aria参数配置.md @@ -0,0 +1,98 @@ +## Aria参数配置 +在Aria中,你可以在配置文件或调用Aria代码配置Aria的参数。 + +## 配置文件设置参数 +创建`aria_config.xml` 文件,将其放在`assets`目录下 +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +## 代码中设置参数 +除了文件方式外修改Aria参数外,同样的,你也可以在代码中动态修改Aria参数
+通过`Aria.get(this).getDownloadConfig()`或`Aria.get(this).getUploadConfig()`直接获取配置文件,然后修改参数
+如以下所示: +```java +// 修改最大下载数,调用完成后,立即生效 +// 如当前下载任务数是4,修改完成后,当前任务数会被Aria自动调度任务数 +Aria.get(this).getDownloadConfig().setMaxTaskNum(3); +``` + +## 一些参数说明 +### 执行队列类型 +* wait模式 + 队列模式为等待模式。
+ 当正在执行的任务数已经达到队列设置的最大任务数时,继续下载新任务,Aria则会把新任务缓存到缓存队列中 +* now模式 + 队列模式为优先下载模式。
+ 当正在执行的任务数已经达到队列设置的最大任务数时,继续下载新任务,Aria会停止执行队列中的队首任务,新任务会立刻下载 + +### 设置最大任务数说明(Wait模式下的说明) +* 如果你在下载任务中最大任务数设置为3 + - 当你连续下载的任务数小于3,任务会自动执行 + - 当正在执行的任务有3个时,如果你继续开始新任务,Aria则会将新任务存放在缓存队列中 + - 当正在执行的任务数有3个时,并且缓存队列中有1个任务,这时,如果你调用`setMaxTaskNum(4);`接口将最大任务数设置为4,则Aria会自动执行缓存队列中的任务,直到正在执行的任务数达到最大任务数为止 + - 如果正在执行的任务数有3个,这时,如果你调用`setMaxTaskNum(2);`接口将最大任务数设置为2,那么Aria会自动停止正在执行的队列中的第一个任务。 + +* 在Aria中,上传任务和下载任务的最大任务数相互独立,互不影响的。 +如:在上传类型的任务中,设置的最大的上传任务数为2,同时设置的最大下载任务为4。那么在下载队列中连续打开4个任务也不会暂停任何一个上传任务。 + + +