手机当麦克风和键盘

已发布

安装 Voltip 的 Android 应用后，手机可以当作电脑的麦克风和键盘：在手机上按住说话，文字会出现在电脑的光标处。没有在线的电脑时，手机也可以单独识别。

安装应用

每个发布版本都附带应用安装包 Voltip_<版本>_android_arm64.apk，适用于 Android 8.0 及以上、64 位 Arm 处理器的手机和平板电脑。在手机上打开这个文件即可安装；具体步骤和核对下载文件的方法见安装，之后如何更新见更新。

从 0.0.50 起，应用的界面使用 Android 原生控件。在旧版本上覆盖安装即可升级，配对、设置和记录都会保留，见安装。

应用随设备旋转，竖屏和横屏都可以使用。手机横屏时，底部的标签栏移到屏幕左侧。在平板电脑或展开的折叠屏手机上，页面内容保持适合阅读的宽度，显示在屏幕中间。

在应用中，系统的返回手势或返回键回到上一级页面：在「记录」和「设置」中返回会回到「说话」；在「说话」中连续返回两次即可退出应用。打开的对话框会先被关闭。

单独使用手机

尚未配对任何电脑时，以及已配对的电脑都不在线时，「按住说话」在手机上单独使用，卡片中写明「松开后在手机上识别并润色，结果自动复制」。内置服务识别并润色你说的内容，文字自动复制到手机剪贴板，可以粘贴到任何应用中。

手机有自己的一套设置，在底部的「设置」中修改：

• 「语音模型」和「AI 模型与预设」：选择识别服务和 AI 润色服务，可以使用内置服务，也可以填写自己的服务商、接口地址、模型和 API 密钥。密钥仅保存在手机的系统密钥库中。手机不支持本地模型。
• 是否用 AI 润色、使用哪个预设，以及识别语言和中文字形。
• 「外观与语言」和「录音」：界面语言、主题和单次录音的最长时间。
• 「个人词典」「替换规则」和「场景」：纠正识别时常听错的写法，对文字做固定替换，以及按场景调整 AI 润色、预设、语言、中文字形和给 AI 的补充要求。规则可以粘贴 TOML 导入，导出的 TOML 可以复制或分享。

手机无法得知你在哪个应用中输入，所以场景不按应用匹配：在「按住说话」上方的「场景」中选择一个场景，之后在手机上识别的录音都按它处理，选择「不使用场景」即可取消。

这些设置只用于在手机上识别的录音。发送到电脑的录音按电脑上的设置处理。

使用内置服务时，「按住说话」卡片的底部显示今天的用量，「设置」›「用量」列出两项服务的详情。内置服务按设备计算每天的用量，手机自己识别的录音计入这部手机，发送到电脑的录音计入电脑，见内置服务的用量。今天的内置识别用完后，「按住说话」暂时不可用：有在线的电脑时可以改为发送到电脑识别，也可以在「语音模型」中换用其他服务商。

「最近结果」显示最新的 3 条手机识别的内容和发送到电脑的听写，每条写明时间和去向：已插入某台电脑，或在手机上识别。点开一条可以查看详情和分享，也可以用右侧的按钮直接复制。底部的「记录」列出全部结果：可以搜索、按时间或收藏筛选，查看今天、本周、本月和累计的听写次数与节省的时间，发送到电脑的听写也计算在内。打开一条记录后，可以查看润色后的文字和识别原文，复制、分享、收藏或删除；较长的录音还可以用 AI 预设重新处理，或把字幕（SRT）和文本（TXT）作为文件分享到其他应用。在「设置」›「历史记录」中可以关闭保存、选择保留的条数或清空全部记录。这些记录保存在手机上；与已配对的电脑同步时，手机单独识别的记录会把副本上传到电脑，见同步电脑的记录和设置。

在「设置」›「反馈」中可以直接报告问题或提出建议，并从相册添加截图或录屏；发送前，页面会列出随反馈附带的全部信息，详见隐私。

「设置」›「关于 Voltip」列出版本和许可证，并可以在浏览器中打开源代码、发布版本和隐私政策。

有已配对的电脑在线时，「说话」顶部的「识别方式」为「发送到 电脑名称」，录音会像下文所述那样发给电脑；选择「在手机上识别」则改由手机单独识别。一次录音会保持开始时的去向直到结束，即使中途有电脑上线或离线。

悬浮球

悬浮球是显示在其他应用上方的说话按钮：在聊天或备忘录等应用里按住它说话，识别结果复制到手机剪贴板，在输入框中长按即可粘贴。录音由这部手机识别，与「说话」页的「在手机上识别」相同，使用手机自己的语音模型、AI 润色和词典。

开启方法：

1. 打开「设置」›「悬浮球」。
2. 依次允许三项权限：麦克风；「显示在其他应用上层」（点「去设置」，在系统设置中为 Voltip 打开）；通知（悬浮球显示时，通知栏保留一条通知，可以随时从这里关闭悬浮球）。
3. 打开「显示悬浮球」。

使用方法：

• 「按住说话」（默认）：按住悬浮球说话，松开结束；手指离开按下的位置较远后再松开则取消，悬浮球这时变红。按下后直接拖动可以移动悬浮球，松开后它会停靠到较近的屏幕边缘，并记住位置。
• 「轻点开始，再点结束」：点一下开始录音，再点一下结束；录音时点卡片上的「取消」可以放弃这次录音。
• 不使用时，可以将悬浮球收进屏幕边缘：拖动悬浮球，直到手指到达屏幕左侧或右侧的边缘，悬浮球一半隐入边缘时松开，屏幕上只保留一个小把手。轻点把手或将它向内拉即可恢复悬浮球；上下拖动把手可以调整位置。
• 「空闲时自动收起」（默认关闭）：选择 5、10 或 30 秒后，悬浮球在这段时间内未被使用就自动收进屏幕边缘。触摸、录音、识别和显示结果期间不会收起，每次触摸后重新计时。
• 识别完成后，悬浮球旁显示「已复制 · 长按输入框粘贴」和识别出的文字，5 秒后收起，「再说一次」重新录音。打开「显示「不复制」按钮」后另有「不复制」，点一下清空剪贴板。关闭「显示识别结果」后只在悬浮球上短暂显示对勾。
• 「AI 润色」与「说话」页和「AI 模型」页的设置相同。使用内置服务时，悬浮球的录音计入这部手机的用量。

关闭 Voltip 的界面后，悬浮球仍然可用；在通知中点「关闭」，或在「设置」›「悬浮球」中关闭开关即可停止。部分手机（如小米、OPPO、vivo）需要在系统设置中允许 Voltip 自启动或在后台运行，否则系统可能关闭悬浮球；具体位置因机型而异，通常在「应用管理」或「电池」的设置中。

手势粘贴

使用手势粘贴时，悬浮球把识别结果直接粘贴到正在输入的输入框中，无需长按输入框。此功能使用 Android 无障碍服务，需要自行开启：

1. 在「设置」›「悬浮球」中打开「滑动松手自动粘贴」，阅读说明后点「同意并开启」。
2. 系统打开「无障碍」设置。打开「Voltip 手势粘贴」并启用。

如果开关为灰色、无法启用，说明 Android 13 及以上版本限制了通过下载的安装包（例如 GitHub 上的 APK）安装的应用：打开 Voltip 的「应用信息」（悬浮球设置页上的「应用信息」按钮），点右上角的菜单，选择「允许受限制的设置」，再重新启用服务。从 Google Play 安装的应用不受此限制。

粘贴时，先在其他应用中点一下输入框，使它获得焦点。按住悬浮球说话，按住期间将手指向屏幕内侧滑动（悬浮球在右侧时向左，在左侧时向右），直到卡片显示「松开后粘贴到输入框」，然后松开。识别完成后，文字复制到剪贴板；如果同一个输入框仍然获得焦点，Voltip 请求它粘贴一次，卡片显示「已发出粘贴请求」。大多数应用会立即粘贴，但应用也可能不接受这一请求。

• 不滑动直接松开：只复制，与之前相同。
• 取消：向上、向下或向屏幕边缘滑离按下的位置后松开，悬浮球变红。
• 识别期间切换到了其他应用或其他输入框，或者输入框是密码框时，不会粘贴：文字保留在剪贴板中，卡片显示「未能粘贴 · 已复制到剪贴板」。识别失败或没有听到声音时也不会粘贴。
• 服务启用之前，悬浮球只复制，向任意方向滑远都会取消。

该服务不读取输入框中的文字，不跟踪你在其他应用中的操作，也不保存任何信息，详见隐私。要停止使用，在系统「无障碍」设置中关闭服务，或关闭「滑动松手自动粘贴」。

配对

一部手机与一台电脑只需配对一次：

1. 在电脑上打开「手机」页并开始配对。页面显示一个二维码和一个 6 位验证码，有效期 120 秒。
2. 在手机上扫描二维码，或输入 6 位验证码。
3. 扫码时，二维码已经核对了两台设备，只需在手机上点「确认并信任」，电脑上不用再操作。输入验证码时，两台设备会显示同一组安全码：确认一致后，在两台设备上分别确认配对；不一致时拒绝配对。

扫到二维码的手机不需要电脑确认就能配对，所以不要截图，也不要在共享屏幕上展示配对二维码。配对后的手机会出现在电脑的设备列表里，不认识的设备可以随时忘记。

电脑上开启「常开配对」后，会一直为下一部手机保持配对窗口，二维码到期前自动更新，直到你关闭为止。扫码的手机同样只需在手机上确认，输入验证码的仍需在电脑上核对安全码并确认。

手机和电脑经中继连接，默认使用内置中继，电脑上也可以改用其他中继，所以配对和连接在任何网络下都可用。在电脑上关闭中继会断开它的手机。网络中断，或在 Wi-Fi 与移动数据之间切换后，两台设备会自动重新连接，通常只需几秒。

手机上的配对页面会显示手机与中继的连接状态。配对前需要先连上中继；连不上时，页面会写明上次连接失败的原因（例如连接超时或无法解析中继地址），并提供「连接自检」，可以据此检查网络或代理设置。

在手机上说话

在手机上按住「按住说话」，说话，然后松开。音频在说话的同时传到电脑。电脑使用自己的设置识别，包括识别服务、词典、AI 润色、规则和场景，并把文字插入电脑的光标处。按住时，卡片显示录音时长和音量，并写明松开后文字发到哪台电脑；之后手机显示每个步骤和最终结果。要取消，把手指滑离按钮，等按钮变成「松开取消」再松开；按住时手指稍有移动不会取消。

不想一直按住时，把按钮下方的「说话方式」改为「点按」：点一下开始录音，再点一下结束并发送；录音时点按钮下方的「取消录音」可以取消。录音进行中不能切换说话方式，手机会记住你的选择。

如果电脑识别出了文字，却无法插入光标处，例如电脑已锁屏，或前台窗口以管理员身份运行，文字会留在电脑的剪贴板中，手机显示「已放到电脑剪贴板」；因为其他原因未能插入时，手机会提示文字已保存在电脑的历史记录中。这两种情况下，电脑的历史记录里都有这段文字。

电脑插入文字后，手机也会在自己的「记录」中保存一条，标为「发送到 电脑名称」，内容是电脑回传的文字（最多 2000 字）和录音时长；识别和润色的详细信息保存在电脑的记录中。这条记录不会再上传到电脑。在手机的「设置」›「历史记录」中关闭保存后，手机不再保存这些记录。

如果有多台已配对的电脑在线，可以选择发送给哪一台。

发送文字

手机也可以不说话，直接发送文字：输入一段文字，或点「发送剪贴板」发送手机剪贴板中的内容。电脑会像处理听写结果一样把它插入光标处，不经过识别和润色。电脑正在听写时，文字会排队等待，听写结束后再插入。

同步电脑的记录和设置

已配对的电脑会把它的历史记录和设置同步到手机。在手机上只能查看，不能修改。

• 在「记录」顶部选择电脑名称，可以查看这台电脑的历史记录：搜索、筛选，打开一条记录查看润色后的文字、识别原文和来源，复制或分享。电脑的记录在手机上不能收藏或删除。超过 5 万字的记录无法整段复制或分享；特别长的记录在手机上只显示一部分，完整内容请在电脑上查看。
• 在「设置」›「电脑」中打开「电脑名称 的设置」，可以查看这台电脑的界面语言和主题、语音模型、AI 润色、预设、词典、规则和场景。手机自己的外观和设置不会因此改变。
• 手机单独识别的记录，会在手机连接到已配对的电脑时，把副本上传到这台电脑；同时配对了多台电脑时，上传给最先连接的那一台。副本在电脑的历史记录中标为「手机 · 手机名称」。手机上的记录保留，之后两边各自删除，互不影响。
• 一台电脑最多与 5 部手机同步，一部手机最多同步 5 台电脑。
• 在电脑的「手机」页中，每部手机有一个「同步」开关，默认开启。关闭后，手机上这台电脑的记录和设置会被删除，手机也不再向这台电脑上传记录。
• 在以下情况下，手机上这台电脑的记录和设置会被删除：在手机上忘记这台电脑；电脑关闭了与这部手机的同步；手机在线时电脑忘记了这部手机。电脑在手机不在线时忘记它，手机上的这些记录会保留，在手机上忘记这台电脑后才会删除。
• 电脑上的 Voltip 需要更新到支持同步的版本，否则手机上会显示「电脑上的 Voltip 需要升级才能同步」。

连接如何受到保护

• 配对时建立加密连接。扫码配对由二维码核对两台设备：手机确认连上的是屏幕上的那台电脑，电脑确认手机读过它的二维码，中继和只知道验证码的人都无法冒充；输入验证码配对时，由你核对两边的安全码。
• 配对之后，两台设备经中继连接，由中继转发数据。所有内容都经过端到端加密，中继无法读取音频和文字。
• 音频发送前经过 Opus 压缩。
• 「忘记设备」会解除配对；对方在线时，两边会同时解除。解除后可以立即重新配对。
• 「连接自检」会检测与中继的连接，以及到每台已配对设备的加密往返时间。

手机上的词典、规则和场景只用于手机自己识别的录音；同步过来的电脑设置仅供查看，不会用于手机上的识别。