Decimen Optical Transfer发送教程：调好这2个参数，QR文件传输速度直逼600KB/s
【免费下载链接】decimen-optical-transfer项目地址: https://gitcode.com/gh_mirrors/de/decimen-optical-transfer
Decimen Optical Transfer 是一款用"屏幕 + 摄像头"发送文件的开源工具：把文件渲染成一段循环播放的动画二维码（QR 码流），另一台设备对着屏幕拍摄即可无损还原文件。整个过程无需网络、无需 App、无需配对，官方实测桌面发往手机可持续418.5 KB/s，峰值窗口高达601.5 KB/s。
💡 提示：文中所有数据来自仓库 benchmarks/records.json 的正式跑分记录。
为什么调参数能直逼 600 KB/s？
发送页面的默认参数是为"最佳演示场景"调好的（120 Hz 高刷屏 + 近距手机拍摄），而真实使用场景中屏幕刷新率、拍摄距离各不相同。官方文档 docs/user/sending.md 说得很直白：bytes/frame 和 tx fps 是两个真正起作用的"扳手"（levers）。
调参面板的完整定义就在 shared/send-settings.ts 中：
| 参数 | 默认值 | 可选范围 | 作用 |
|---|---|---|---|
| tx fps（帧率） | 60 | 10 / 15 / 20 / 24 / 30 / 55 / 60 | 每秒发送多少个二维码帧，直接决定理论速度上限 |
| bytes / frame（每帧字节数） | 2953（QR v40） | 500 ~ 2953 | 每个二维码"装多少货"，越大信息密度越高，但越难被摄像头稳定识别 |
| 纠错等级 | L | — | 喷泉码（Fountain Code）已兜底丢帧，保持默认即可 |
| 显示尺寸 | 900 px | — | 全屏展示时自动忽略 |
⚠️ 改任何一项都会重启码流，接收端会自动跟着重置，不用手动操作。
两个参数的调优口诀：先降"每帧字节"，再降"帧率"
官方 docs/user/troubleshooting.md 给出的慢速/卡死修复顺序就是"这两个参数"的标准用法：
- bytes/frame → 1465（QR v27）默认 2953 字节是为"手机对手机近距离"调的密度极限值；普通显示器、手臂距离拍摄时最容易翻车，降到 1465 能大幅提升识别率。
- tx fps → 2460 帧/秒是为 120 Hz 发送端准备的。如果你的发送屏是 60 Hz，帧与屏幕刷新"打架"会导致捕获率骤降，降到 24（或 30）即可稳定。
📌 一句话口诀：传输慢就先降 bytes/frame；还是不行再降 tx fps。顺序别反——先降密度保"收得到"，再降帧率保"看得清"。
一次成功的发送：完整步骤
- 发送端（笔记本/显示器）：打开
/send/→ 切到File模式 → 点Select File（最大 64 MB），码流立即开始；同时把屏幕亮度拉满。 - 接收端（手机）：打开
/receive/→ 点Start camera→ 让二维码充满取景框，并用东西把手机撑住（手持抖动导致的自动对焦漂移是最常见失败原因）。 - 小技巧：点击发送端的二维码可全屏放大，更大的物理码意味着接收端可以站更远、或解码更密的帧。
- 码流会一直循环播放，没有"结束"动作——接收端凑够数据会自动收尾，发送端点Stop transfer停止即可。
进度条走满后，接收端显示文件预览和Save链接——前提是 SHA-256 校验通过，文件与发送端逐字节一致。
速度有多快：带"收据"的实测数据
官方为每次跑分生成完整的诊断报告（run receipt），数据可复核：
| 设备组合 | 持续速度 | 峰值（≥1 秒窗口） | 传输内容 |
|---|---|---|---|
| 桌面 → 手机（Odyssey G9 49″ → iPhone 17 Pro Max） | 418.5 KB/s | 601.5 KB/s | 1 MB 文件，2.5 秒 |
| 手机 → 手机（iPhone 17 Pro Max 对拍） | 199.2 KB/s | 340.8 KB/s | 1 MB 文件，5.1 秒 |
原始跑分记录：benchmarks/runs/2026-08-09T04-12-41-run.json、benchmarks/runs/2026-08-09T04-49-39-run.json。
所以"直逼 600 KB/s"指的是桌面大屏高刷发送端的峰值窗口速度；日常手机对手机也能稳在 200 KB/s 上下——把上面的两个参数调对，你自己的设备对大概率能拿到更好成绩。想复现官方测试，可以用 1 MB 的标准基准文件（sha-256 固定，见 benchmarks/records.json）。
写在最后
- 发送端屏幕亮度拉满，接收端手机撑稳，二维码尽量充满取景框；
- 记住顺序：bytes/frame 1465 → tx fps 24，从这两档开始往下试；
- 码流永不结束，接收端自己收尾；SHA-256 校验保证文件一致。
更多细节可查阅官方文档：快速上手、发送指南、故障排查、隐私说明。
【免费下载链接】decimen-optical-transfer项目地址: https://gitcode.com/gh_mirrors/de/decimen-optical-transfer
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
