以下是一个基于 Python 的中文语音识别控制系统从零开始的实践教程，涵盖环境搭建、语音识别、指令解析和控制执行全流程。代码可直接运行，适合智能家居控制、机器人指令等场景。

一、基础环境准备

1. 安装必要库

pip install SpeechRecognition pyaudio requests  # 核心库
pip install pyttsx3  # 文字转语音（可选）

2. 解决麦克风权限问题

• Windows：确保麦克风已启用
• Mac/Linux：终端执行 sudo chmod a+rw /dev/input/* 临时授权

二、语音识别模块（支持离线+在线）

import speech_recognition as sr

def recognize_speech():
    r = sr.Recognizer()
    with sr.Microphone() as source:
        print("请说出指令...")
        audio = r.listen(source, timeout=5, phrase_time_limit=3)

    try:
        # 方案1: 离线识别（需安装Vosk，中文模型约1.4GB）
        # text = r.recognize_vosk(audio, language="zh-CN")

        # 方案2: 在线识别（百度API，免费但需注册）
        text = r.recognize_baidu(
            audio, 
            app_key='你的API Key', 
            secret_key='你的Secret Key', 
            language='zh-CN'
        )
        print(f"识别结果: {text}")
        return text
    except Exception as e:
        print(f"识别失败: {str(e)}")
        return ""

注：百度API免费额度500次/天，注册地址

三、指令解析与控制逻辑

# 指令映射表（可自由扩展）
command_map = {
    "开灯": "light_on",
    "关灯": "light_off",
    "打开空调": "ac_on",
    "增大音量": "volume_up",
    # ... 更多自定义指令
}

def execute_command(text):
    for cmd, action in command_map.items():
        if cmd in text:  # 关键词匹配
            print(f"执行动作: {action}")

            # 这里添加实际控制代码
            if action == "light_on":
                # GPIO控制代码 or 智能家居API调用
                print("[模拟] 已打开灯光")
            elif action == "ac_on":
                # 调用空调API
                print("[模拟] 空调已启动")
            return True
    return False

四、完整系统集成

import time

if __name__ == "__main__":
    while True:
        try:
            text = recognize_speech()  # 获取语音转文字
            if text:
                if not execute_command(text):
                    print("未识别到有效指令")

            time.sleep(1)  # 防止频繁拾音

        except KeyboardInterrupt:
            print("系统已退出")
            break

五、进阶优化方案

1. 降低误触发

   # 添加唤醒词检测
   if "小助手" in text:  
      print("唤醒成功！")
      command = recognize_speech()  # 二次拾音获取指令
      execute_command(command)

2. 多平台控制扩展

   # 控制小米智能设备示例
   import miio
   def control_yeelight(action):
      yeelight = miio.Device("192.168.1.2", "token")
      if action == "light_on":
          yeelight.send("set_power", ["on"])

3. 加入语音反馈

   import pyttsx3
   engine = pyttsx3.init()
   engine.say("指令执行成功")
   engine.runAndWait()

六、调试技巧

1. 识别率优化：
   • 使用定向麦克风
   • 增加r.energy_threshold = 300 调整环境噪音阈值
2. 离线替代方案：
   • 安装Vosk中文模型：pip install vosk + 下载中文模型

     model = Model("vosk-model-zh-CN")  # 加载模型
     r = sr.Recognizer()
     text = r.recognize_vosk(audio).get("text", "")

完整代码示例

GitHub Gist链接 包含完整可运行代码+API配置指南

通过此系统，你可实现：

• ? 中文语音控制家电/设备
• ⚡ 自定义指令扩展
• ? 与HomeAssistant/米家等智能家居平台联动
• ? 离线运行保障隐私

遇到问题欢迎交流！常见错误处理：

1. OSError: No Default Input Device → 检查麦克风是否被占用
2. speech_recognition.UnknownValueError → 降低环境噪音或增大音量