Asterisk 语音识别脚本技术文档

本文档旨在帮助用户安装、使用和理解基于 Asterisk 的语音识别脚本。本文将详细介绍安装指南、项目使用说明以及项目 API 使用文档。

1. 安装指南

在安装前，请确保您的系统已满足以下要求：

• Perl 编程语言
• Perl 的 World-Wide Web 库（perl-libwww）
• Perl 的 JSON 数据操作模块（perl-libjson）
• IO-Socket-SSL Perl 模块
• Free Lossless Audio Codec (flac)
• 来自 Google 的 Cloud Speech API 密钥
• 可以连接到互联网以访问 Google 的语音识别服务

安装步骤如下：

1. 将 speech-recog.agi 文件复制到您的 agi-bin 目录中，通常是 /var/lib/asterisk/agi-bin/。您可以通过检查 /etc/asterisk/asterisk.conf 文件来确认该路径。

2. 项目使用说明

该脚本使用 Google 的 Cloud Speech API 将语音转换成文本，并将结果返回给 Asterisk 的 dialplan，作为 channel 变量。

使用方法如下：

agi(speech-recog.agi,[lang],[timeout],[intkey],[NOBEEP],[rtimeout],[speechContexts])

• 从当前通道录制，直到检测到 2 秒的静音（可以通过 'timeout' 参数设置，-1 表示无超时限制）或按下中断键（默认为 #）。
• 如果设置 NOBEEP，则不播放提示音以指示录音开始。
• 如果设置 rtimeout，则覆盖绝对录音超时。
• SpeechContext 提供了对结果中特定单词和短语的提示。

脚本将以下 channel 变量：

• utterance：生成的文本字符串。
• confidence：介于 0 和 1 之间的值，表示正确识别的概率。大于 0.95 的值通常意味着结果文本是正确的。

在出现意外错误的情况下，这两个变量将被设置为 -1。

3. 项目 API 使用文档

项目 API 使用方法已在项目使用说明中概述。以下是一些具体的示例：

示例代码

exten => 1234,1,Answer()
exten => 1234,n,agi(speech-recog.agi,en-US)
exten => 1234,n,Verbose(1,The text you just said is: ${utterance})
exten => 1234,n,Verbose(1,The probability to be right is: ${confidence})
exten => 1234,n,Hangup()

在这个例子中，当用户拨打 1234 时，系统将播放提示音，并录制用户的语音，然后通过 Google 的语音识别服务将语音转换为文本。

4. 项目安装方式

项目安装方式已在安装指南中详细说明。确保满足所有依赖项后，将脚本复制到适当的目录即可。

---

本文档旨在帮助用户更好地理解和使用 Asterisk 语音识别脚本，从而提高语音识别的准确性和效率。