常见问题
最后更新日期:2026 年 7 月 31 日
以下是使用 VoiceBridge 时最常遇到的问题和解决方法。如果这里没有覆盖你的情况,请发邮件到 flint2026support@gmail.com。
1. 手机扫二维码后提示"绑定失败"
配对二维码有效期 10 分钟,超时后需要刷新。
- 在电脑端 VoiceBridge Agent 窗口,点击"刷新二维码"。
- 用手机重新扫描新的二维码,并在 10 分钟内点击"允许并绑定"。
如果仍然失败,可能是该电脑已被其他账号绑定。
2. 手机端录音时提示"无法访问麦克风"
浏览器需要获得麦克风权限才能录音。
iPhone / iPad(iOS Safari):
- 打开系统"设置" → "隐私与安全性" → "麦克风"。
- 找到"Safari 浏览器",打开开关。
Android(Chrome):
- 长按地址栏左侧的锁形图标 → "权限" → "麦克风" → 允许。
- 或系统"设置" → "应用" → "Chrome" → "权限" → "麦克风"。
3. 录音完成但提示"没有录到声音"
- 点击录音按钮后至少说话 1 秒再停止。
- 关闭可能占用麦克风的 App(微信语音、其他录音软件)。
- 检查手机是否处于静音模式。
- 插上耳机再试一次(排除硬件故障)。
4. 手机发送文字,电脑端没有反应
- 确认电脑端 VoiceBridge Agent 窗口是打开的,状态显示"已上线"。
- 如果状态显示"等待上线",点击窗口内的刷新按钮。
- 检查电脑和手机是否都能上网。
- 如果手机端设备列表显示"(需更新)",请重新下载最新版桌面客户端。
提示:手机和电脑不需要连接同一个 WiFi,只要都能上网就行。
5. 语音识别提示"本月额度已用完"
免费版每月有 600 秒(10 分钟)的语音识别额度。用完后需等到下月 1 号自动重置,或升级到专业版(18000 秒/月)。
6. 语音识别准确率不高怎么办
- 环境噪音:尽量在安静环境录音,靠近手机说话。
- 语速和清晰度:正常语速、吐字清晰效果最好。
- 语言:目前针对普通话优化。方言或中英混杂可能效果不佳。
- 录音距离:手机离嘴 15-30 厘米效果最佳。
7. macOS 提示"已复制,自动粘贴失败"
VoiceBridge 需要系统"辅助功能"权限来模拟键盘粘贴。
- 打开系统"设置" → "隐私与安全性" → "辅助功能"。
- 在列表中找到 VoiceBridge Agent,打开开关。
- 如果没有出现,点"+"手动添加。
- 可能需要重启 VoiceBridge Agent 才能生效。
说明:文字已经复制到剪切板,你也可以手动用 Cmd+V 粘贴。
8. iPhone 上用 Safari 打开后无法录音
iOS 系统只允许在 Safari 浏览器中使用麦克风录音。Chrome、微信内置浏览器等无法录音。
- 用系统自带的 Safari 打开网页。
- 系统版本需 iOS 14.5 或更高。
- 建议点击 Safari 底部的分享按钮 → "添加到主屏幕",体验更好。
9. 登录后提示"云端连接失败"
- 刷新页面(下拉或重新打开网址)。
- 如果仍然失败,退出登录后重新输入邮箱密码登录。
- 检查手机网络是否能正常访问网页。
- 如果你在使用 VPN,尝试关闭 VPN 后重试。
10. 桌面端二维码一直显示"等待配对"
- 在电脑端点击"刷新"按钮,重新生成二维码。
- 确认电脑已联网。
- 如果更换过电脑硬件或重装系统,可能需要先在手机端"账户设置 → 已连接设备"删除旧的电脑设备,再重新配对。
FAQ
Last updated: July 31, 2026
Here are the most common issues and solutions when using VoiceBridge. If your situation isn't covered, email flint2026support@gmail.com.
1. "Pairing failed" after scanning the QR code
The pairing QR code is valid for 10 minutes and must be refreshed after it expires.
- In the VoiceBridge Agent window on your computer, click "Refresh QR".
- Re-scan the new QR code with your phone and tap "Allow and pair" within 10 minutes.
If it still fails, the computer may already be paired with another account.
2. "Cannot access microphone" when recording
The browser needs microphone permission to record.
iPhone / iPad (iOS Safari):
- Open Settings → Privacy & Security → Microphone.
- Find "Safari" and toggle it on.
Android (Chrome):
- Long-press the lock icon left of the address bar → Permissions → Microphone → Allow.
- Or Settings → Apps → Chrome → Permissions → Microphone.
3. "No voice detected" after recording
- Speak for at least 1 second before stopping.
- Close apps that may occupy the microphone (WeChat voice, other recording apps).
- Check if the phone is in silent mode.
- Try with earphones plugged in (rules out hardware issues).
4. Text sent from phone but nothing happens on computer
- Make sure the VoiceBridge Agent window is open and shows "Online".
- If it shows "Waiting", click the refresh button inside the window.
- Check that both computer and phone have internet access.
- If the device list shows "(update needed)", download the latest desktop client.
Tip: The phone and computer do not need to be on the same WiFi. As long as both have internet, it works.
5. "Monthly quota exhausted"
The Free plan has 600 seconds (10 minutes) of recognition per month. Once exhausted, wait until the 1st of next month for reset, or upgrade to Pro (18,000 seconds/month).
6. Low speech recognition accuracy
- Background noise: record in a quiet environment, close to the phone.
- Speed and clarity: normal pace with clear enunciation works best.
- Language: optimized for Mandarin Chinese. Dialects or mixed Chinese-English may perform worse.
- Distance: 15-30 cm from the phone gives the best results.
7. macOS: "Copied, auto-paste failed"
VoiceBridge needs the "Accessibility" permission to simulate keyboard paste.
- Open System Settings → Privacy & Security → Accessibility.
- Find VoiceBridge Agent in the list and toggle it on.
- If it doesn't appear, click "+" to add it manually.
- You may need to restart VoiceBridge Agent for it to take effect.
Note: The text is already in the clipboard. You can also paste manually with Cmd+V.
8. Cannot record in Safari on iPhone
iOS only allows microphone recording in Safari. Chrome, WeChat's built-in browser, and others cannot record.
- Open the page with the system Safari browser.
- iOS 14.5 or later is required.
- Tap Safari's Share button → "Add to Home Screen" for a better experience.
9. "Cloud connection failed" after login
- Refresh the page (pull down or reopen the URL).
- If it still fails, sign out and sign back in with your email and password.
- Check whether the phone's internet works for other websites.
- If using a VPN, try turning it off (some VPNs block Supabase connections).
10. Desktop QR code keeps showing "Waiting for pairing"
- Click the "Refresh" button on the desktop to regenerate the QR code.
- Make sure the computer has internet access.
- If you changed hardware or reinstalled the OS, you may need to remove the old computer in Account Settings → Connected Devices before re-pairing.