Skip to content

README_DEV.md

Latest commit

 

History

History
100 lines (69 loc) · 4.7 KB

README_DEV.md

File metadata and controls

100 lines (69 loc) · 4.7 KB

mediaProxy (goProxy) 开发与调试指南

本文档详细介绍了 drpy-plugin 中 mediaProxy (由 Go 编写的视频代理服务，即 goProxy) 的完整开发、测试、调试及编译打包流程。

1. 环境准备

确保您的本地开发环境已安装以下工具：

  • Go: 建议 1.21 或更高版本（用于编译 proxy.go）
  • Python: 3.x（用于运行模拟播放器及测试脚本）
  • PowerShell: Windows 环境默认自带（用于执行编译及打包脚本）
  • Git: 用于版本控制
  • UPX: 可选，用于压缩编译后的可执行文件（在 Android 环境下能大幅缩小体积）

2. 本地启动代理服务

在开发阶段，我们直接使用 Go 命令在本地启动代理服务。服务默认运行在 5575 端口。

cd mediaProxy
go run proxy.go -port 5575

如果需要查看更详细的调试信息（例如每个分片的下载情况、错误日志），请添加 -debug 参数：

go run proxy.go -debug -port 5575

3. 测试与模拟播放器请求

在本地服务启动后，需要验证代理是否能正确处理视频的完整播放以及拖拽操作（即 HTTP Range 请求）。

3.1 准备测试数据

在 mediaProxy 目录下创建一个名为 playinfo.txt 的文件，将你需要测试的视频直链（例如迅雷等网盘解析出的原始播放链接）粘贴进去。

3.2 运行测试脚本

我们编写了两个 Python 脚本来模拟不同场景的测试：

  1. 基础流程测试 (test_proxy.py): 该脚本模拟了完整下载、拖拽到中部、拖拽到尾部以及拖拽后继续播放四个场景。

    python test_proxy.py

    预期结果: 各个场景返回 206 Partial Content，并且能正确下载对应字节数的数据。

  2. 播放器模拟测试 (test_player_sim.py): 该脚本更贴近实际播放器的行为，通过读取 playinfo.txt 中的链接，发起不同 Range 的请求，并打印响应头，方便检查 Content-Range 和 Content-Length 是否正确。

    python test_player_sim.py

4. 调试错误与代码修改

当遇到播放截断、无法拖拽等问题时，通常是因为 HTTP Range 处理或并发控制不当。以下是常见的排查点：

  • 观察 Debug 日志: 检查 go run proxy.go -debug 输出的日志，特别关注 statusCode、Range 以及 ProxyRead/ProxyWorker 相关的报错。
  • 416 错误处理: 网盘（如迅雷）在请求到达文件末尾时常返回 416 Range Not Satisfiable。这不是一个致命错误，代理不应该直接中断。正确的做法是跳出当前分片的下载循环，平滑结束。
  • 429/503 频率限制: 多线程并发请求可能触发服务器的防刷机制。需要加入退避重试（Retry Backoff）机制，并在 handleGetMethod 中限制最大线程数（如限制为 16）。
  • Context 与协程泄漏: 使用 context.WithCancel 控制并发任务的生命周期。当主请求结束（如用户关闭播放器）时，通过 cancel() 通知所有 worker 退出，避免后台持续下载导致内存和连接泄漏。

修改建议: 所有代理逻辑的核心在 ConcurrentDownload、ProxyRead 以及 ProxyWorker 三个函数中，修改时需仔细处理 channel 和 buffer 的读写。

5. 编译 Android 二进制文件

在本地测试通过后，需要将 proxy.go 交叉编译为 Android 平台可执行文件。

在 mediaProxy 目录下，直接运行提供的 PowerShell 脚本：

.\scripts\build_goproxy.ps1

脚本主要工作:

  1. 设置环境变量 GOOS=linux，分别针对 GOARCH=arm (32位) 和 GOARCH=arm64 (64位) 进行编译。
  2. 禁用 CGO (CGO_ENABLED=0)，移除调试信息 (-ldflags="-s -w") 以减小体积。
  3. 输出文件存放至 goProxy/goProxy-arm 和 goProxy/goProxy-arm64。
  4. (可选) 如果系统中存在 upx 命令，脚本会自动对编译结果进行 UPX 压缩。

6. 打包 custom_spider.jar

编译好的 Android 可执行文件最终需要打包进 custom_spider.jar 中的 assets 目录下供 TVBox 等客户端使用。

在 mediaProxy 目录下，运行打包脚本：

.\scripts\update_jar.ps1

脚本主要工作:

  1. 将 goProxy 目录下的 goProxy-arm 和 goProxy-arm64 添加或更新到上一级目录的 custom_spider.jar 的 assets/ 路径中。
  2. 自动计算更新后 custom_spider.jar 的 MD5 值。
  3. 将生成的 MD5 值写入 custom_spider.jar.md5 文件中。

至此，整个开发、测试、编译、打包的闭环流程完成。你可以将生成的 custom_spider.jar 和 custom_spider.jar.md5 发布到你的源中供用户更新。