pslab-mini-hardware完全指南：从安装到部署的10分钟快速上手教程

【免费下载链接】pslab-mini-hardware DNN based hotword and wake word detection toolkit 项目地址: https://gitcode.com/gh_mirrors/sno/pslab-mini-hardware

pslab-mini-hardware是一款基于深度神经网络的热词和唤醒词检测工具包，能够让你轻松创建属于自己的唤醒词，如“OK Google”或“Alexa”。它具有高度可定制性、保护隐私、轻量级和嵌入式等特点，支持多种平台和语言，是开发语音交互应用的理想选择。

核心功能与优势

pslab-mini-hardware作为一款强大的唤醒词检测工具，具备以下核心功能和优势：

• 高度可定制：你可以自由定义自己的唤醒词，无论是“芝麻开门”还是“你好梦想家”，都能轻松实现。
• 隐私保护：无需联网，不将语音流上传到云端，始终在本地运行，有效保护用户隐私。
• 轻量级嵌入式：即使在树莓派等资源受限的设备上也能高效运行，在最基础的树莓派（单核700MHz ARMv6）上CPU占用率不到10%。
• 多平台支持：目前支持树莓派、64位Mac OS X、64位Ubuntu、iOS、Android等多种平台，详见lib目录。
• 多语言支持：提供多种语言的封装，包括Java/Android、Go、Node、Perl、Python、iOS/Swift3、iOS/Object-C等。

快速安装步骤

1. 克隆仓库

首先，克隆pslab-mini-hardware项目到本地：

git clone https://gitcode.com/gh_mirrors/sno/pslab-mini-hardware
cd pslab-mini-hardware

2. 安装依赖

根据不同的操作系统，安装所需的依赖：

Mac OS X：

brew install swig portaudio sox
pip install pyaudio

Ubuntu/Raspberry Pi/Pine64：

sudo apt-get install swig3.0 python-pyaudio python3-pyaudio sox
pip install pyaudio
sudo apt-get install libatlas-base-dev

安装完成后，确保麦克风可以正常录音：

rec t.wav

Python快速入门示例

pslab-mini-hardware提供了简单易用的Python接口，让你快速体验唤醒词检测功能。

1. 进入Python示例目录：

cd examples/Python

2. 在Python控制台中执行以下代码：

import snowboydecoder

def detected_callback():
    print("唤醒词被检测到！")

# 初始化唤醒词检测器，使用通用模型"resources/snowboy.umdl"
detector = snowboydecoder.HotwordDetector("../../resources/snowboy.umdl", sensitivity=0.5, audio_gain=1)
# 开始检测
detector.start(detected_callback)

3. 对着麦克风说出“snowboy”，即可看到“唤醒词被检测到！”的输出。

自定义唤醒词模型

pslab-mini-hardware支持创建自定义唤醒词模型，你可以通过以下步骤实现：

1. 访问官方网站或使用热词API创建个人唤醒词模型。
2. 将下载的个人模型（.pmdl文件）替换示例中的通用模型。
3. 调整灵敏度（sensitivity）和音频增益（audio_gain）参数，以获得最佳检测效果。

多平台部署指南

pslab-mini-hardware支持在多种平台上部署，以下是部分平台的部署要点：

• Node.js：通过npm安装预编译模块，详见examples/Node目录。
• Java/Android：编译Java封装，详见swig/Java目录和Android README。
• iOS：提供Objective-C和Swift3示例，详见examples/iOS目录。
• Go：编译Go封装，详见examples/Go目录。

常见问题解决

• TypeError: init() got an unexpected keyword argument 'model_str'：这通常是由于SWIG版本过旧导致的，请升级到3.0.7或更高版本。
• 麦克风无法录音：确保已正确安装PortAudio和PyAudio，并检查麦克风是否正常工作。
• 检测灵敏度问题：调整sensitivity参数，较高的灵敏度更容易触发唤醒词，但可能会增加误报率。

通过本教程，你已经掌握了pslab-mini-hardware的基本安装、使用和部署方法。现在，你可以开始创建自己的语音交互应用，体验智能唤醒的便捷与乐趣！更多高级用法和详细文档，请参考项目中的Full Documentation。

【免费下载链接】pslab-mini-hardware DNN based hotword and wake word detection toolkit 项目地址: https://gitcode.com/gh_mirrors/sno/pslab-mini-hardware