在线合成REST-API-C++-SDK
快速入门
安装语音合成 C++ SDK
语音合成 C++ SDK目录结构
├── base
│ ├── base.h // 请求客户端基类
│ ├── base64.h // base64加密相关类
│ ├── http.h // http请求封装类
│ └── utils.h // 工具类
└── speech.h // 语音合成 交互类最低支持 C++ 11+
直接使用开发包步骤如下：
1.在官方网站下载识别、合成 RESTful API C++ SDK压缩包。
2.将下载的aip-cpp-sdk-version.zip解压, 其中文件为包含实现代码的头文件。
3.安装依赖库libcurl（需要支持https） openssl jsoncpp(>1.6.2版本，0.x版本将不被支持)。
4.编译工程时添加 C++11 支持 (gcc/clang 添加编译参数 -std=c++11), 添加第三方库链接参数 lcurl, lcrypto, ljsoncpp。
5.在源码中include speech.h ，引入压缩包中的头文件以使用aip命名空间下的类和方法。
6.调用示例可以参考 https://github.com/Baidu-AIP/sdk-demo
新建client
client是语音合成的C++客户端，为使用语音合成的开发人员提供了一系列的交互方法。当您引入了相应头文件后就可以新建一个client对象
用户可以参考如下代码新建一个client：
#include "speech.h"
// 设置APPID/AK/SK
std::string app_id = "你的 App ID";
std::string api_key = "你的 Api key";
std::string secret_key = "你的 Secret Key";
aip::Speech client(app_id, api_key, secret_key);在上面代码中，常量APP_ID在百度云控制台中创建，常量API_KEY与SECRET_KEY是在创建完毕应用后，系统分配给用户的，均为字符串，用于标识用户，为访问做签名验证，可在AI服务控制台中的应用列表中查看。
接口说明
语音合成
接口描述
基于该接口，开发者可以轻松的获取语音合成能力
请求说明
- 合成文本长度必须小于1024字节，如果本文长度较长，可以采用多次请求的方式。文本长度不可超过限制
举例，要把一段文字合成为语音文件：
void tts(aip::Speech client)
{
std::ofstream ofile;
std::string file_ret;
std::map<std::string, std::string> options;
options["spd"] = "9";
// 合成成功的二进制数据写入文件中
ofile.open("./test.mp3", std::ios::out | std::ios::binary);
// 不带可选参数调用
Json::Value result = client.text2audio("百度语音合成测试", aip::null, file_ret);
// 带可选参数调用, 参数参考参数列表中的可选参数
// Json::Value result = client.text2audio("百度语音合成测试", options, file_ret);
// 如果file_ret为不为空则说明合成成功，返回mp3文件内容回结果
if (!file_ret.empty())
{
ofile << file_ret;
} else {
// 服务端合成错误
std::cout << result.toStyledString();
}
}| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| tex | String | 合成的文本，文本长度必须小于1024GBK字节，建议每次请求文本不超过120字节，约为60个汉字或者字母数字。 请注意计费统计依据：120个GBK字节以内（含120个）记为1次计费调用；每超过120个GBK字节则多记1次计费调用。 |
是 |
| cuid | String | 用户唯一标识，用来区分用户， 填写机器 MAC 地址或 IMEI 码，长度为60以内 |
否 |
| spd | String | 语速，取值0-9，默认为5中语速 | 否 |
| pit | String | 音调，取值0-9，默认为5中语调 | 否 |
| vol | String | 音量，取值0-15，默认为5中音量（取值为0时为音量最小值，并非为无声） | 否 |
| per | String | 普通发音人选择：度小美=0(默认 |
否 |
| per | String | 精品发音人选择：度逍遥（精品）=5003，度小鹿=5118，度博文=106，度小童=110，度小萌=111，度米朵=103，度小娇=5 | 否 |
tex字段2次urlencode
由于urlencode有两个标准 RFC 1738和RFC 3986. 百度为了更好地兼容，支持1次及2次urlencode， 其中2次urlencode可以覆盖全部的特殊字符。SDK内部加了1次urlencode，因而推荐传递tex 参数时再做1次urlencode编码。
测试用例：“1+1=2”。 依靠SDK内的1次urlencode时，“+”可能会没有合成。
返回样例：
返回Json::value对象。 如果合成成功，error_code为Json::nullValue, 下行数据为二进制语音文件数据。 如果合成出现错误，则会填充除data属性外的其它属性。
返回失败：
// 失败返回
{
"err_no":500,
"err_msg":"notsupport.",
"sn":"abcdefgh",
"idx":1
}