# unimrcp_with_huaweicloud_asr

**Repository Path**: xk_git_admin/unimrcp_with_huaweicloud_asr

## Basic Information

- **Project Name**: unimrcp_with_huaweicloud_asr
- **Description**: mrcp协议集成华为云ASR
- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-12-30
- **Last Updated**: 2024-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# unimrcp_with_huaweicloud_asr

#### 介绍

本仓库是基于unimrcp集成华为云实时语音识别+TTS开源代码，旨在帮助社区用户快速搭建外呼系统。本仓库提供了两种安装方法，一是源码安装，二是直接采用release出来的二进制库。

##### 版本更新记录

> v1.0.0 仅支持ASR

> v2.0.0 支持ASR和TTS

#### 安装教程

本代码仓提供两种安装方式供用户选择。

##### 方法一： 源码安装

1. （可选）华为云实时语音识别C++ SDK安装

> 本代码仓提供了已经编译好的C++ SDK库 `plugins/huaweicloud_asr`，建议直接使用

> 若想对SDK进行二次修改，则可参考安装指https://bbs.huaweicloud.com/blogs/392949，安装后替换plugins/huaweicloud_asr



2. 进入根目录/unimcrp-deps-1.6.0，安装安装unimrcp的依赖库

```
./build-dep-libs.sh
```

3. 进入根目录，安装unimrcp

```
./bootstrap
./configure
make
make install

```

4. unimrcp默认安装在/usr/local/unimrcp中

##### 方法二：直接使用release库

```
wget https://gitee.com/computervisionlearner/unimrcp_with_huaweicloud_asr/releases/download/v2.0.0/unimrcp-1.8.0_unimrcp-deps-1.6.0_binary.tar.gz
tar -xzvf unimrcp-1.8.0_unimrcp-deps-1.6.0_binary.tar.gz

```

#### 代码仓目录结构说明

- build：代码编译中间产物，可忽略

- conf：配置文件，**需重点关注**

  - `*.xml`文件为mrcp自带的xml配置文件，可配置协议端口号、日志等功能； 默认端口号8060

  - `*.conf`文件为华为云ASR/TTS配置文件，可设置aksk、project id等鉴权信息、断句参数、音调、语速等

- data：自带的demo音频文件，可用于安装后测试功能是否正常

- docs：unimrcp官方说明文档，可忽略

- libs：unimrcp依赖的库文件，无需关注

- modules：unimrcp所依赖的sofiasip和unirtsp组件，无需关注

- platforms：unimrcp核心代码，提供mrcp通信协议

- plugins：将华为云ASR/TTS集成至Unimrcp定义好的接口之中，**需重点关注**。

  - huaweicloud_asr： 已经编译好的华为云C++ SDK库，推荐直接使用。若想对SDK进行二次开发，则可参考博客https://bbs.huaweicloud.com/blogs/423604，对SDK定制修改后，（用相同的代码结构）安置至此处

  - huawei-recog：华为云ASR集成代码

  - huawei-synth：华为云TTS集成代码


- unimrcp-deps-1.6.0：unimrcp的依赖库


#### 使用说明

本仓库已刷新至**2.0版本**，集成了华为云ASR和TTS。更详细安装说明请移步博客：https://bbs.huaweicloud.com/blogs/423604

```
# 设置环境变量
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/data/workspace/unimrcp/lib  

# 启动服务端
cd unimrcp/bin && ./unimrcpserver

# 启动客户端
cd unimrcp/bin && ./umc
```
启动客服务端效果
![启动服务端效果](image1.PNG)

启动客户端效果
![启动客户端效果](image2.PNG)

mrcp的IP和端口设置：在文件conf/unimrcpserver.xml中
![mrcp的IP和端口设置](image3.PNG)

**欢迎社区各位C++、语音专家多多指点，丰富和完善本代码仓功能**