end 事件 - 下载完成
事件概述
end 事件在整个下载任务组全部完成时触发，标志着整个下载会话的结束。此事件在所有单个任务结束后发送。
事件特征
- 事件类型：end
- 触发时机：所有下载任务处理完毕时
- 触发频率：每个下载会话仅触发一次
Event 字段信息
Event字段信息
json
{
"Type": "end",
"Name": "下载器实例标识符",
"ShowName": "任务显示名称",
"ID": "会话/实例ID"
}字段说明
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Type | String | 是 | 事件类型，固定值"end" |
| Name | String | 是 | 下载器实例的唯一标识符 |
| ShowName | String | 是 | 任务的显示名称，通常为文件名或用户指定的名称 |
| ID | String | 是 | 会话/实例ID |
Msg 字段说明
源码中 end 事件通常以空 msg 发送（即 {}）。如果调用方或实现方额外扩展，可包含统计汇总，但不能依赖这些扩展字段，接收方应能兼容空 msg。
使用建议
- 将 end 事件作为释放资源、显示会话结束状态的触发点
- 不要假设 msg 中包含统计信息，若需要统计请在程序内维护并在自定义回调中传递