HCC2D Streamer 1.1 教程
如何使用 HCC2D Streamer 和 HCC2D Decoder 传输文件
本文从应用下载开始，完整介绍文件传输步骤，并说明如何针对所用屏幕与手机摄像头，找出兼顾速度和稳定性的设置。
两个应用的作用
HCC2D Streamer 在发送端电脑上运行，将文件转换为一组在屏幕上循环显示的彩色 HCC2D 码。HCC2D Decoder 在接收端手机上运行，通过摄像头读取这些码并还原原始文件。整个传输过程不需要网络连接、账户、线缆或设备配对。
发送端：Mac、Windows 或 Linux 电脑
HCC2D Streamer 1.1: Mac App Store · Microsoft Store
Linux 版 HCC2D CLI Streamer: APT 软件源 · GitHub 源代码
接收端：iPhone 或 Android 设备
HCC2D Decoder: App Store · Google Play · Huawei AppGallery
兼容性：HCC2D Streamer 1.0 仍兼容旧版 HCC2D Decoder。HCC2D Streamer 1.1 和 HCC2D CLI Streamer 均要求使用 HCC2D Decoder 1.2.4 或更高版本；Decoder 当前的最新版本为 1.2.5。
传输文件
在 Streamer 中选择文件
将文件拖入窗口，或点击“选择文件”。Streamer 1.1 支持最大 2 MiB 的文件；几百 KB 大小的文件通常能更快完成传输。
选择 8 色或 4 色
如果希望每个符号容纳更多数据，可先尝试 8 色模式。如果受到屏幕显示、摄像头或环境光线影响，颜色无法被稳定识别，请改用 4 色模式。
开始传输
点击“开始传输”。尽量放大传输窗口，并确保窗口中的整个符号都清晰可见。
用 Decoder 扫描屏幕
将手机摄像头对准电脑屏幕，确保完整的 HCC2D 符号位于取景框内。读取过程中请尽量保持手机稳定。
等待传输完成
Decoder 收集到足够的符号后，会自动还原原始文件。传输完成后，即可停止电脑端的传输。
使用高密度符号前，先检查实际的摄像头帧分辨率
即使手机摄像头支持高像素照片，应用实际收到的实时视频帧也可能采用较低分辨率。HCC2D Decoder 会显示应用真正接收到的帧分辨率。
- 先打开一次扫描界面，让 Decoder 记录实际收到的实时视频帧尺寸。
- 打开“更多”，然后选择“相机信息”。
- 绿色表示实时视频帧已达到建议的 1200 万像素，可用于尝试高密度 HCC2D 码。黄色表示达到全高清，但低于 1200 万像素；红色表示低于全高清。
只有当“相机信息”显示为绿色，并且 HCC2D 符号能够在电脑屏幕上以足够大的尺寸显示时，才建议尝试版本 40。如果屏幕较小，或相机信息显示为黄色或红色，可从版本 30 左右开始；若读取仍不稳定，再继续降低版本。
四项参数分别有什么作用
不存在一套适用于所有设备的“最高设置”。吞吐量越高，对屏幕、摄像头及拍摄环境的要求也越高。“高级选项”中显示的预计吞吐量适合用来比较不同设置，但设置是否可靠，仍需通过实际传输来确认。
在 macOS 的“设置”菜单或 Windows 的应用菜单中打开“高级选项”。
| 参数 | 侧重提高吞吐量 | 侧重提高稳定性 |
|---|---|---|
| 颜色数量 | 8 色模式能让每个符号容纳更多数据。 | 4 色模式更容易区分颜色，适合光线不理想，或屏幕、摄像头色彩表现不够准确的情况。 |
| EC 级别 | L 分配给纠错的数据最少，因此可用容量最高。 | 如果 L 不够稳定，可依次尝试 M、Q、H。纠错能力会逐步增强，但可用容量也会相应减少。 |
| FPS | 可先尝试 15 FPS，以便每秒显示更多符号。 | 如果手机无法跟上读取速度，可降至 12 FPS；若仍不稳定，再降至 10 FPS。 |
| 符号版本 | 版本越高，单个符号可容纳的数据越多，但组成符号的模块也会更小、更密集。 | 降低版本可以增大模块，更便于摄像头对焦和分辨。一般来说，大屏幕比小屏幕更适合使用较高版本。 |
如何找出速度最高且保持稳定的设置
对于同一组屏幕和手机，这项调试通常只需在首次使用时完成一次。请选择一个与实际待传文件接近的测试文件，并始终使用同一个文件进行测试。每次只更改一项参数，这样更容易判断是哪项调整改善了效果，或导致了不稳定。找到可靠的组合后，请应用并将其作为常用配置保存下来，以后传输时直接复用。只有在更换屏幕、手机、拍摄距离或光线条件后，才需要重新测试。
- 先查看 Decoder 中的“相机信息”。如果显示为绿色，并且屏幕上的符号足够大，可以尝试版本 40；否则建议从版本 30 左右开始。
- 尝试 8 色模式。如果每次都能稳定完成传输，就保留这一设置；如果不稳定，则改用 4 色模式。
- 尝试 EC 级别 L。如果传输可靠，就保留 L，因为它能提供更高吞吐量。如果不可靠，则改用 M；只有在需要更强纠错能力时，再使用 Q 或 H。
- 尝试 15 FPS。如果接收进度时断时续或完全停止，先降至 12 FPS，必要时再降至 10 FPS。
- 只要传输保持稳定，就可以逐步提高符号版本。如果摄像头无法持续识别符号，请退回到最后一个能够稳定工作的版本。
- 在能够多次完成同一文件传输且不中断的设置中，选择预计吞吐量最高的组合。这就是当前屏幕、摄像头、拍摄距离和光线条件下的实际可用上限。
两个可供尝试的起始设置
屏幕较大，且相机信息显示为绿色
8 色 · EC L · 15 FPS · 版本 40
使用 EC L 时，预计吞吐量约为 1 Mbps。这只是一组用于测试的起始设置，并不保证适合所有设备。如果多次传输无法保持稳定，请每次只降低一项参数。
如果 EC L 不稳定：8 色 · EC M · 15 FPS · 版本 40 · 约 0.83 Mbps
屏幕较小，或摄像头帧低于 1200 万像素
8 色 · EC L · 12 FPS · 版本 30 左右
版本 30、EC L 的预计吞吐量约为 0.49 Mbps。如有需要，可每次调整一项：改用 4 色、10 FPS，或更低的符号版本。
如果 EC L 不稳定：8 色 · EC M · 12 FPS · 版本 30 · 约 0.38 Mbps
实用建议
- 确保整个 HCC2D 符号都位于取景框内，并尽量避免从过斜的角度拍摄屏幕。
- 适当提高屏幕亮度，避开反光，并保持摄像头镜头清洁。
- 等待自动对焦完成，并在读取过程中保持手机稳定。
- 使用较高符号版本时，应尽量放大传输窗口。
- 更换屏幕、手机、拍摄距离或光线条件后，请重新测试并调整设置。