如何快速搭建无网络数据传输链路：用 ggwave 三步发出第一声

如何快速搭建无网络数据传输链路用 ggwave 三步发出第一声【免费下载链接】ggwaveTiny>项目地址: https://gitcode.com/GitHub_Trending/gg/ggwave手头有两台设备一台是只有喇叭和麦克风的电脑另一台是刚出厂、没联网、没屏幕的 ESP32中间没有 WiFi、没有蓝牙、没有线缆——一小段数据怎么送过去ggwave 就是为这个问题而生的它是一个轻量级 C/C 声波传输库把数据变成声音播出去、再由对端麦克风听回来并还原。没有网络的设备之间从此多了一条用声音当网线的通道。选协议先明确你的传输场景结论拿不准就用可听声快速档GGWAVE_PROTOCOL_AUDIBLE_FAST先跑通再换档。ggwave 底层用的是 FSK频移键控简单说就是用不同频率的音高代表 0 和 1并内置 Reed-Solomon 纠错码吸收环境噪声。它把协议分成四个家族频率起点不同可听声从 1875Hz 起步人耳能听见超声波从 15000Hz 起步人耳基本听不见。协议家族适合什么注意什么可听声GGWAVE_PROTOCOL_AUDIBLE_*演示、配对、普通 PC 与手机之间互发会发出吱哇声适合安静环境传播距离相对最远超声波GGWAVE_PROTOCOL_ULTRASOUND_*不想被人听见、怕干扰别人的场合距离更近且要求麦克风能听到高频手机/耳机麦通常不行双工GGWAVE_PROTOCOL_DT_*需要一来一回交互的远程控制、握手收发双方都要保持在线占用时间更长多目标GGWAVE_PROTOCOL_MT_*一对多广播一份数据周围多个设备同时收接收端越多现场越吵注意错开重发每个家族都有NORMAL / FAST / FASTEST三档速度速度越快、抗噪越弱。如果你已经确定收发双方用什么协议可以用ggwave_rxToggleProtocol关掉其它接收协议减少误报。协议常量都定义在 include/ggwave/ggwave.h 里。搭一条最小传输链路发送端与接收端结论一条链路只需要两个角色——发送端把数据唱出来接收端把声音听回去两边各自选一种硬件即可。发送端负责把字节编码成音频波形并从扬声器/蜂鸣器播放候选电脑或手机扬声器最简单浏览器 Web Audio 也行Arduino Uno配一个普通蜂鸣器就能当发射机示例在 examples/arduino-tx/。接收端负责持续采集麦克风音频并喂给解码器候选电脑声卡 麦克风零成本起步ESP32板载 12-bit ADC 可直接采模拟麦克风也支持 I2S MEMS 麦克风还能把收到的内容显示到 OLED 上示例在 examples/esp32-rx/RP2040 / Raspberry Pi Pico配模拟麦克风使用示例在 examples/rp2040-rx/。收发两端不要求同款硬件——电脑发、ESP32 收或浏览器发、Arduino 收都成立。三步发出第一声安装、编码、解码结论库的公开 API 只有两件事——ggwave_encode把数据变成波形ggwave_decode把波形变回数据。第 1 步 安装。克隆仓库后用 CMake 构建git clone https://gitcode.com/GitHub_Trending/gg/ggwave --recursive cd ggwave mkdir build cd build cmake .. make第 2 步 编码。先建实例再调用ggwave_encode得到可播放的音频波形。第 3 步 解码。把麦克风采到的音频持续喂给ggwave_decode一旦返回正数输出缓冲区里就是收到的数据。最小骨架如下ggwave_Parameters p ggwave_getDefaultParameters(); ggwave_Instance in ggwave_init(p); int n ggwave_encode(in, payload, 4, GGWAVE_PROTOCOL_AUDIBLE_FAST, 25, NULL, 1); // 按 n 分配 waveformBuffer 后再用 query0 重新调用 ggwave_encode 生成波形 while (true) { /* 捕获一帧音频 frame */ int m ggwave_decode(in, frame, frameBytes, out); if (m 0) { /* out 中有 m 字节有效数据 */ } }注意ggwave_encode传query1时只返回波形需要的字节数不真正生成波形ggwave_decode输出的数据不带结尾\0自己补。真实场景落地场景一给 ESP32 下发 WiFi 凭据物联网设备配置。电脑把SSID:密码拼成一条文本用超声波协议编码后播放ESP32 端在 examples/esp32-rx/ 里持续采麦解码收到后直接WiFi.begin。整个过程不需要屏幕、按键或扫码设备快速配对一次完成。场景二浏览器间互发小文件。Node.js 侧用官方绑定var factory require(ggwave); factory().then(function(ggwave) { var parameters ggwave.getDefaultParameters(); var instance ggwave.init(parameters); // 编码 hello js得到可直接用 Web Audio 播放的波形 var waveform ggwave.encode(instance, hello js, ggwave.ProtocolId.GGWAVE_PROTOCOL_AUDIBLE_FAST, 10); var res ggwave.decode(instance, waveform); // 解码回文本 });浏览器端把波形交给AudioContext播放、把麦克风数据流喂回decode即可适合传几百字节以内的配置片段、剪贴板内容。JS 绑定源码见 bindings/javascript/ggwave.js。场景三声音二维码广播。用多目标协议把剪贴板内容广播出去范围内任何开着接收端的设备都能抓到一份数据多个收点适合局域网外的一对多分发。调优清单距离、速度与抗干扰按场景选家族普通 PC 对 PC 用可听声办公室/课堂用超声波交互控制用双工一对多广播用多目标速度档按需演示用FAST赶时间用FASTEST容噪最弱音量从 25 起步库注释明确通常 25 够用别超过 50收发两端采样率都按 48000Hz 配置采样率不一致时库会自动重采样但保持一致最稳协议已知时用ggwave_rxToggleProtocol关掉多余的接收协议降低误报环境吵就换超声波档并调低接收端soundMarkerThreshold灵敏度应用层再包一层校验值 超时重发把丢了重传做成默认行为避坑问答Q到底能传多远A安静房间里可听声协议几米内一般没问题超声波更近且受麦克风高频能力限制。隔墙、开风扇、有人说话都会明显变差——先把设备挪近、把噪声源关停再测。Q一次能发多少数据A单次有效数据上限 256 字节库常量kMaxDataSize带宽约 8–16 字节/秒。更大的数据请分片每片自带序号接收端拼完校验。Q解码失败怎么办Aggwave_decode返回 -1 是解码出错通常是噪声太大返回 -2 是输出缓冲区不够返回 0 只是这帧还没听到数据。库内置 Reed-Solomon 纠错能吸收一定误码重要数据再在应用层加校验和重传。声音当信道听起来像玩具但 FSK 调制、声音标记、纠错码这些工程细节 ggwave 都替你封好了——你要做的只是调用ggwave_encode和ggwave_decode。仓库 examples/ 里就有现成的收发对Python 看 examples/ggwave-py/PC 命令行看 examples/ggwave-cli/浏览器看 examples/ggwave-js/。挑一套跑起来五分钟就能听到属于你的第一声。【免费下载链接】ggwaveTiny>项目地址: https://gitcode.com/GitHub_Trending/gg/ggwave创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考