Skip to content
Star

悬浮球功能

悬浮球功能让您可以在使用其他输入法时,依然能够通过悬浮球快速调用说点啥的语音识别能力,实现真正的跨应用语音输入。

功能介绍

悬浮球是一个可拖动的圆形按钮,悬浮在屏幕上方,提供以下功能:

  • 跨输入法使用:即使使用第三方输入法(如搜狗、百度输入法),也能调用说点啥语音识别
  • 全局可用:在任何应用中都能使用,包括系统设置、浏览器、聊天软件等
  • 状态指示:通过颜色变化实时显示工作状态
  • 自由定位:可拖动到屏幕任意位置,自动贴边

状态指示

悬浮球通过动画和图标显示当前工作状态:

状态说明
空闲等待用户触发,可点击开始录音
录音中正在录制语音,录音波形动画
处理中语音识别进行中,转圈等待结果
完成对钩表示识别成功,结果已提交

配置选项

所有配置位于 设置 → 界面与交互 → 悬浮球设置

配置项类型默认值说明
floatingAsrEnabledBooleantrue启用语音识别悬浮球
floatingSwitcherOnlyWhenImeVisibleBooleantrue仅在键盘显示时显示悬浮球
floatingSwitcherAlphaFloat1.0悬浮球透明度(0.2-1.0)
floatingBallSizeDpInt44悬浮球大小(28-96dp)
floatingWriteTextCompatEnabledBooleantrue兼容模式开关(全选+粘贴策略)

详细说明

1. 启用语音识别悬浮球

  • 路径设置 → 界面与交互 → 悬浮球设置 → 启用语音识别
  • 说明:总开关,关闭后悬浮球完全隐藏

2. 显示条件

  • 路径设置 → 界面与交互 → 悬浮球设置 → 仅在键盘显示时显示
  • 说明
    • 开启(默认):仅当键盘面板显示时,悬浮球才出现
    • 关闭:悬浮球持续显示,键盘隐藏时半透明贴边

3. 透明度调节

  • 路径设置 → 界面与交互 → 悬浮球设置 → 透明度
  • 范围:0.2(20%透明)- 1.0(完全不透明)
  • 说明:降低透明度可减少遮挡屏幕内容

4. 大小调节

  • 路径设置 → 界面与交互 → 悬浮球设置 → 大小
  • 范围:28dp(最小)- 96dp(最大)
  • 默认:44dp
  • 说明:根据屏幕尺寸和使用习惯自定义大小

5. 兼容模式

  • 路径设置 → 界面与交互 → 悬浮球设置 → 写入兼容模式
  • 说明
    • 开启(默认):使用"全选+粘贴"策略写入文本,兼容性更好
    • 关闭:使用标准 IME API,性能更优但部分应用可能不兼容

兼容模式

由于安装无障碍 API 没有真正意义上的插入文字的概念,部分应用(如微信、QQ、部分游戏等)可能限制无障碍服务的文本输入功能,导致识别结果无法正确输入。兼容性模式能够缓解部分应用的限制问题,但在一些场景仍有缺陷。 推荐优先使用说点啥键盘或者通过小企鹅输入法 Fcitx5 联动进行语音输入。

可在 设置 中配置兼容目标包名列表(每行一个,支持前缀匹配)

权限要求

悬浮球功能需要三个系统权限:

1. 悬浮窗权限

用途:在其他应用上层显示悬浮球

授权方式

  1. 首次启用时应用会自动跳转到系统设置
  2. 找到说点啥,开启"显示在其他应用的上层"权限

2. 无障碍权限

用途:将识别结果输入到活动编辑器

授权方式

  1. 进入 设置 → 辅助功能 → 无障碍
  2. 找到"说点啥语音识别服务"并启用

隐私说明

说点啥的无障碍服务仅用于文本输入,不会读取屏幕内容或其他敏感信息

3. 麦克风权限

用途:录制语音进行识别

授权方式

  1. 首次点击悬浮球时会弹出权限请求
  2. 点击"允许"即可

使用方法

基本操作

  1. 开始录音

    • 默认:长按悬浮球开始录音,松开停止
    • 点按模式:点击开始,再次点击停止(需在设置中启用)
  2. 停止录音

    • 长按模式:松开手指
    • 点按模式:再次点击悬浮球
  3. 取消录音

    • 向上或向左滑动悬浮球(长按模式)
    • 长按悬浮球(点按模式)

高级操作

  • 悬浮球菜单:长按悬浮球并向屏幕中央区域滑动即可弹出菜单,在需要选中的按钮上松手即可触发。菜单包含以下选项:
    • 切换 AI 后处理 Prompt
    • 切换 ASR 供应商
    • 切换输入法
    • 录音判停切换
    • 查看识别历史
    • 上传/拉取粘贴板内容(需要启用粘贴板同步功能)
  • 拖动定位:长按 2s 等待振动反馈两次后即可拖动,松手自动贴边
  • 重置位置:在设置中点击"重置悬浮球位置"恢复默认

常见问题

悬浮球不显示

可能原因

  1. 未启用悬浮窗权限 → 检查系统设置
  2. 关闭了总开关 → 检查 floatingAsrEnabled 配置
  3. 设置了"仅键盘显示时显示" → 需要先呼出键盘
  4. 系统省电策略限制后台显示悬浮窗或者杀死应用的无障碍权限 → 关闭省电优化,开启自启动

识别结果无法输入

可能原因

  1. 未授予无障碍权限 → 检查辅助功能设置
  2. 目标应用限制了无障碍输入 → 尝试启用"兼容模式"

相关功能

Released under the Apache 2.0 License.