TT高速下载器Python使用示例

安装要求

1. Python 3.9及以上版本
2. TT高速下载器动态库文件：
   • Windows平台：TTHighSpeedDownloader.dll
   • macOS平台：TTHighSpeedDownloader.dylib
   • Linux平台：TTHighSpeedDownloader.so

安装步骤

1. 将动态库文件放置在项目目录中
2. 将TTHSD_interface.py复制到项目目录

快速开始

基本下载功能

from TTHSD_interface import TTHSDownloader

# 初始化下载器
downloader = TTHSDownloader()

# 定义进度回调函数
def progress_callback(event_dict, msg_dict):
    print(f"事件: {event_dict}")
    print(f"消息: {msg_dict}")

# 开始下载
downloader_id = downloader.start_download(
    urls=["https://example.com/file.zip"],
    save_paths=["file.zip"],
    thread_count=64,
    chunk_size_mb=10,
    callback=progress_callback,
    is_multiple=False
)

print(f"下载器ID: {downloader_id}")

高级功能

# 1. 创建下载器但不启动下载
downloader_id = downloader.get_downloader(...)

# 2. 稍后启动下载
downloader.start_download_by_id(downloader_id)

# 3. 暂停下载
downloader.pause_download(downloader_id)

# 4. 恢复下载
downloader.resume_download(downloader_id)

# 5. 停止下载
downloader.stop_download(downloader_id)

# 6. 并行下载
downloader.start_download(..., is_multiple=True)

运行示例

# 运行所有示例
python example.py

# 运行特定示例
python -c "import example; example.example1_basic_download()"

注意事项

1. 回调函数：接收两个参数(event_dict, msg_dict)，建议不要在其中执行耗时操作
2. 线程安全：API是线程安全的，但建议对同一个下载器的操作进行序列化处理
3. 错误处理：下载失败会通过回调函数通知，不会抛出异常
4. 资源清理：使用stopDownload或pauseDownload后会自动清理相关资源

核心特性说明

1. 进度回调：实时获取下载进度、速度、错误信息等状态
2. 并行下载：实验性功能，适用于带宽充足的网络环境
3. 暂停/恢复：支持下载过程中的暂停和恢复操作
4. 错误容错：单个文件下载失败不会影响其他文件的下载
5. 灵活配置：线程数、分块大小、User-Agent等参数均可自定义配置