前言

在开发语音控制产品时，一个常见的需求是通过语音传递数值参数，比如"设置温度25度"、"打开空调到26度"或"定时30分钟"。许多开发者初次接触离线语音模块时，会期望像使用在线语音服务那样，直接从语音中提取数字变量。

然而， 离线语音识别与在线语音识别有着本质的区别。本文将深入分析离线语音模块对数字处理的技术限制，并提供多种实用的替代方案，帮助开发者在技术约束下实现产品需求。

一、核心问题：为什么离线语音不能"识别任意数字"？

1.1 技术原理差异

在线语音识别（如小爱同学、天猫精灵）：

• 采用云端大模型，拥有几乎无限的词汇表
• 能够实时解析句子中的数字、单位、参数
• 支持自然语言理解（NLU），提取语义要素

离线语音识别（如SmartPi的CI/SU系列）：

• 基于本地固定的命令词模板匹配
• 只能识别预先在平台配置好的词条
• 无法从语音中实时提取未预设的数字参数

1.2 一个真实的用户案例

来自技术交流群的对话很好地说明了这个问题：

用户："能否识别20.5度的？我想把20.5提取出来怎么办呢？"

技术支持："只能设置20.5的固定命令然后变量配置设置固定的数值，离线的就是限定词条控制，需要预先在平台上面设置好词条指令。"

用户进一步追问："即使没有小数，整数也必须可以设置的！再比如设置时间，也需要这样的变量的。不可能0-59秒、0-59分、0-23时、0-31日、0-12月都设置词条吧？这得多少词条啊？"

这个困惑代表了很多人对离线语音模块的误解—— 期望它具备在线语音的动态参数提取能力。

二、技术限制分析

2.1 固定词条机制

SmartPi平台的离线语音模块（CI-03T、SU-03T等）采用 命令词模板匹配的工作方式：

用户语音 → 特征提取 → 与预设词条模板比对 → 匹配成功则触发对应动作

这种机制的特点：

• 精确匹配：语音必须与预设词条高度一致
• 非语义理解：不理解"含义"，只比对"声音模式"
• 本地计算：所有处理在芯片内完成，无需联网

2.2 为什么不支持任意数字？

从硬件和软件层面看：

2.3 文档明确说明

根据SmartPi官方文档《串口输入参数配置》的说明：

"当前平台不支持将语音识别的数字动态转换为UART数据帧... UART端口输出只能发送预设的固定参数，不支持动态转换。"

三、实用替代方案

虽然离线语音无法真正"识别任意数字"，但通过合理的交互设计，大多数产品需求都可以实现。以下是几种经过验证的实用方案。

方案一：预设常用数值命令

适用场景：数值变化范围有限，或只有几个常用值

实现方法： 将常用数值作为独立命令词预先配置

示例应用：

场景：空调温度控制
命令词配置：
- "空调20度" → 发送串口数据 0x14
- "空调25度" → 发送串口数据 0x19
- "空调26度" → 发送串口数据 0x1A
- "空调30度" → 发送串口数据 0x1E

优点：

• 配置简单，无需额外逻辑
• 响应快速，用户体验好

缺点：

• 只能支持预设的数值
• 数值较多时占用词条资源

方案二：分段输入法

适用场景：需要支持较大范围的数值，但可接受分步操作

实现方法： 将数值拆分为"十位/个位"或"百位/十位/个位"分别设置

示例应用：

场景：设置定时时间（0-99分钟）
命令词配置：
- "定时10分" → 基础命令
- "定时20分" → 基础命令
- "定时30分" → 基础命令
- "定时40分" → 基础命令
- "定时50分" → 基础命令
个位调整：
- "加1分钟" → 变量+1
- "加5分钟" → 变量+5
- "减1分钟" → 变量-1

平台配置示例：

变量定义：
- timer_value（int）：定时值，默认30
命令词："加5分钟"
控制动作：
- 变量设置
- 变量：timer_value
- 操作：增加
- 方式：数值 5

优点：

• 可覆盖较大数值范围
• 词条占用少
• 支持精确调节

缺点：

• 需要多次交互
• 交互逻辑略复杂

方案三：数值组合法

适用场景：时间和日期类参数设置

实现方法： 将数值按位/按单位拆分，分别设置

示例应用：

场景：设置时间（时:分）
命令词配置：
小时设置（0-23）：
- "1点"、"2点"... "23点"
分钟设置（0-59）：
- "0分"、"5分"、"10分"... "55分"（按5分钟步进）
设置流程：
1. 用户说："8点" → 设置小时为8
2. 用户说："30分" → 设置分钟为30
3. 用户说："确认" → 保存时间配置

进阶优化： 使用变量记录中间状态，通过"确认"命令统一提交：

变量定义：
- hour_temp（int）：临时小时值
- minute_temp（int）：临时分钟值
命令词："确认时间"
控制动作：
- 条件判断：hour_temp > 0 AND minute_temp >= 0
- 满足条件：发送最终时间数据到主控
- 播报："时间设置为X点Y分"

方案四：使用双麦模块 + 数字识别功能

适用场景：需要一定程度的动态数字识别

技术说明： 部分SmartPi模块（如SU-03T）支持 数字识别功能（0-99），可以在特定命令词后提取数字。

配置方法：

命令词："设置温度"
启用数字识别功能
语音："设置温度25度"
→ 识别"设置温度"命令
→ 提取数字"25"作为温度参数
→ 通过变量传递温度值

注意事项：

• 数字识别范围有限（通常0-99）
• 需要特定硬件支持
• 识别准确率受环境影响较大
• 小数点识别不支持

方案五：外部MCU辅助方案

适用场景：复杂参数设置，或需要更灵活的交互

实现架构：

语音模块（识别命令） → 串口通信 → MCU（参数处理） → 执行设备

工作流程：

1. 用户通过语音输入基础命令（如"设置温度"）
2. 语音模块触发MCU进入参数设置模式
3. MCU通过其他方式（如按键、旋钮、触摸屏）接收数值输入
4. 数值确认后，MCU控制执行设备

优点：

• 绕开语音模块的限制
• 支持任意数值输入
• 交互方式灵活

缺点：

• 需要额外的硬件成本
• 系统复杂度增加

方案六：混合语音方案（离在线结合）

适用场景：对自然交互有高要求的产品

实现方案： 使用支持离在线混合的模块（如JX-A7T）：

离线模式：
- 基础控制（开关、模式选择）
- 快速响应，无网络依赖
在线模式：
- 复杂参数设置（"把温度调到25度"）
- 自然语言理解
- 需要网络连接

切换策略：

• 优先使用离线命令
• 复杂操作自动切换到在线识别
• 网络异常时降级为纯离线模式

四、平台配置实操示例

4.1 变量递增调节配置

以音量调节为例，展示如何通过变量实现参数的动态调整：

步骤1：定义变量

变量名：volume
类型：int
默认值：50
备注：音量值（0-100）

步骤2：配置递增命令

命令词："音量加"
控制动作：
- 类型：变量设置
- 变量：volume
- 操作：增加
- 方式：数值 5
- 附加条件：volume < 100（不超过最大值）

步骤3：配置递减命令

命令词："音量减"
控制动作：
- 类型：变量设置
- 变量：volume
- 操作：减少
- 方式：数值 5
- 附加条件：volume > 0（不低于最小值）

步骤4：配置查询命令

命令词："音量多少"
回复语：
- "当前音量为{volume}%"（引用变量播报）

4.2 同一命令控制多个GPIO

来自技术交流群的实际需求：

用户："我的意图是同一命令词，关掉2个或多个端口"

解决方案：使用变量控制

变量定义：
- port_state（int）：端口状态记录
命令词："全部关闭"
控制动作：
1. GPIO_A0 → 低电平
2. GPIO_A1 → 低电平
3. GPIO_A2 → 低电平
4. 变量设置：port_state = 0

如果需要"同一个命令词配置8次，控制8个不同端口"：

方法一：在控制详情中添加多个GPIO控制动作

命令词："关闭所有"
控制动作：
- 添加控制 → GPIO_A0 → 低电平
- 添加控制 → GPIO_A1 → 低电平
- 添加控制 → GPIO_A2 → 低电平
...（继续添加其他端口）

方法二：使用变量批量控制

变量定义：
- port_mask（int）：端口掩码
命令词："关闭所有"
控制动作：
- 变量设置：port_mask = 0x00
- 串口发送：将port_mask值发送给外部MCU
- 外部MCU根据掩码控制多个端口

五、选型建议

5.1 需求评估矩阵

5.2 成本与功能权衡

成本维度：
离线基础模块 < 离在线混合模块 < 在线语音模块
功能维度：
简单固定命令 < 变量递增调节 < 数字识别 < 自然语言理解
建议：在满足核心需求的前提下，优先选择成本较低的方案

六、常见问题

Q1：为什么不能像小爱同学那样说"设置25度"就自动识别数字？

A：小爱同学使用的是云端大模型，所有语音数据上传到服务器进行处理，拥有近乎无限的词汇表和语义理解能力。SmartPi离线模块的所有处理都在本地芯片内完成，受限于存储和算力，只能采用固定词条匹配的方式。

Q2：词条数量大概能设置多少条？

A：不同模块的词条容量不同：

• SU-03T：约150条
• CI-03T：约300条
• CI-33T：约500条
• 双麦版本：由于降噪算法占用资源，词条数略少

Q3：如果必须要支持任意数字怎么办？

A：有以下选择：

1. 使用外部MCU辅助，通过其他输入方式接收数值
2. 使用JX-A7T等支持在线语音的模块
3. 使用纯在线语音方案（如天猫精灵模组）

Q4：变量设置的"增加0"是什么意思？

A："变量增加0"表示变量值不变，主要用于：

• 保持逻辑完整性
• 配合条件判断使用
• 占位符作用

Q5：如何实现定时器的时长设置？

A：推荐使用"预设时间档位 + 微调"的方式：

预设档位：
- "定时10分钟"、"定时30分钟"、"定时60分钟"
微调命令：
- "加1分钟"、"减1分钟"（通过变量调节）

七、总结

离线语音识别模块的核心优势是 低成本、低延迟、无网络依赖，但同时也有 固定词条、有限词汇的技术限制。理解这些限制，并选择合适的替代方案，是成功开发语音产品的关键。

核心要点回顾：

1. 离线语音不等于在线语音：不能期望离线模块具备在线语义理解能力
2. 固定词条是核心机制：所有可识别的语音都必须预先配置
3. 变量控制是重要工具：通过变量可以实现参数的递增/递减调节
4. 交互设计可以弥补技术限制：合理的交互流程能让用户感觉不到限制
5. 按需选择最经济的方案：在满足需求的前提下，优先选择低成本方案

希望本文的分析和方案能够帮助开发者在离线语音产品的开发中少走弯路，更好地平衡产品需求与技术实现。

参考资料

• SmartPi官方文档 - 串口输入参数配置
• SmartPi官方文档 - 变量控制配置
• SmartPi FAQ - SU-03T平台配置常见问题
• 技术交流群真实案例整理（2026年2月）

本文档整理自SmartPi技术支持团队的实践经验和用户真实案例，如有更新请以官方文档为准。