C++ Demo

前提条件

• 当前最新版本：1.2.2。发布日期：2018年11月14日。

• 使用SDK前，请先阅读接口说明，详情请参见接口说明。

• 已开通智能语音交互并获取AccessKey ID和AccessKey Secret，详情请参见从这里开始。

示例说明

录音文件识别示例使用了nlsCommonSDK的AlibabaNlsCommon::FileTrans提交识别请求和查询识别结果，采用的是RPC风格的POP API调用方式。

下载安装

下载nlsCommonSDK，文件包含如下几部分：

• CMakeLists.txt：示例代码工程的CMakeList文件。

• readme.txt：SDK说明。

• release.log：更新记录。

• version：版本号。

• build.sh：Demo编译脚本。

• demo：示例文件。

  文件名	描述
  fileTransDemo.cpp	录音文件识别示例。

• include：包含SDK头文件，以及部分第三方头文件。各文件如下表所示。

  文件名	描述
  openssl	OpenSSL头文件目录，Linux下使用。
  curl	curl头文件目录。
  uuid	UUID头文件目录，Linux下使用。
  json	jsoncpp头文件目录。
  Global.h	全局声明头文件。
  FileTrans.h	录音文件识别头文件。

• lib：包含curl、jsoncpp动态库。

  根据平台不同，使用如下版本软件加载库文件：

  • Linux（Glibc：2.5及以上，Gcc4或Gcc5）

  • Windows（VS2013、VS2015）

  编译运行操作步骤：

  重要

  • Linux下安装工具要求如下：

    • Glibc 2.5及以上

    • Gcc4或Gcc5

  • Windows下需要您自行搭建示例工程（请将示例文件修改为含有BOM的UTF-8编码格式），依赖库如下：

    • openssl-1.0.2j

    • libuuid-1.0.3

    • curl-7.60.0

    • jsoncpp-0.10.6

  假设示例文件已解压至path/to路径下，在Linux终端依次执行如下命令编译运行程序。

• 支持Cmake：

  确认本地系统已安装Cmake 2.4及以上版本。

  1. 切换目录：cd path/to/sdk/lib。

  2. 解压缩文件：tar -zxvpf linux.tar.gz。

  3. 切换目录：cd path/to/sdk。

  4. 执行编译脚本：./build.sh。

  5. 切换目录：cd path/to/sdk/demo。

  6. 执行文件识别示例程序：./fileTransDemo your-AccessKeyId your-AccessKeySecret your-appkey。

• 不支持Cmake：

  1. 切换目录：cd path/to/sdk/lib。

  2. 解压缩文件：tar -zxvpf linux.tar.gz。

  3. 切换目录：cd path/to/sdk/demo。

  4. 使用g++编译命令编译示例程序：g++ -o fileTransDemo fileTransDemo.cpp -I path/to/sdk/include/ -L path/to/sdk/lib/linux -ljsoncpp -lssl -lcrypto -lcurl -luuid -lalibabacloud-idst-common -D_GLIBCXX_USE_CXX11_ABI=0。

  5. 指定库路径：export LD_LIBRARY_PATH=path/to/sdk/lib/linux/。

  6. 执行文件识别示例程序：./fileTransDemo your-AccessKeyId your-AccessKeySecret your-appkey。

关键接口

FileTrans：录音文件识别对象。您可以从中获取录音文件识别结果、失败信息等。

代码示例

#include <iostream>
#include <string>
#include "FileTrans.h"

#ifdef _WIN32
#include <windows.h>
#endif // _WIN32

using std::string;
using std::cout;
using std::endl;
using namespace AlibabaNlsCommon;

#if defined _WIN32
string UTF8ToGBK(const string &strUTF8) {

        int len = MultiByteToWideChar(CP_UTF8, 0, strUTF8.c_str(), -1, NULL, 0);
        unsigned short * wszGBK = new unsigned short[len + 1];
        memset(wszGBK, 0, len * 2 + 2);

        MultiByteToWideChar(CP_UTF8, 0, (char*)strUTF8.c_str(), -1, (wchar_t*)wszGBK, len);

        len = WideCharToMultiByte(CP_ACP, 0, (wchar_t*)wszGBK, -1, NULL, 0, NULL, NULL);

        char *szGBK = new char[len + 1];
        memset(szGBK, 0, len + 1);
        WideCharToMultiByte(CP_ACP, 0, (wchar_t*)wszGBK, -1, szGBK, len, NULL, NULL);

        string strTemp(szGBK);
        delete[] szGBK;
        delete[] wszGBK;

        return strTemp;
}
#endif

// 录音文件识别
int fileTrans(const char* accessKeyId, const char* accessKeySecret, const char* appKey, const char* fileLink) {
    FileTrans request;

    /*设置阿里云账号AccessKey Id*/
    request.setAccessKeyId(accessKeyId);
    /*设置阿里云账号AccessKey Secret*/
    request.setKeySecret(accessKeySecret);
    /*设置阿里云AppKey*/
    request.setAppKey(appKey);
    /*设置音频文件url地址*/
    request.setFileLinkUrl(fileLink);
    /*设置闲时版连接域名,这里默填写的是上海地域,如果要使用其它地域请参考各地域POP调用参数*/
    request.setDomain("speechfiletranscriberlite.cn-shanghai.aliyuncs.com");
    /*设置闲时版连接版本*/
    request.setServerVersion("2021-12-21");
    /*设置连接地域*/
    request.setRegionId("cn-shanghai");

    /*开始文件识别, 成功返回0, 失败返回-1*/
    int ret = request.applyFileTrans();
    if (-1 == ret) {
        cout << "FileTrans failed: " << request.getErrorMsg() << endl; /*获取失败原因*/
        return -1;
    } else {
        string result = request.getResult();

#ifdef _WIN32
        result = UTF8ToGBK(result);
#endif

                cout << "FileTrans successed: " << result << endl;

                return 0;
    }
}

int main(int argc, char* argv[]) {
    if (argc < 4) {
        cout << "FileTransDemo need params : <AccessKey Id> <AccessKey Secret> <app - key>" << endl;
        return -1;
    }

    const char* accessKeyId = argv[1];
    const char* accessKeySecret = argv[2];
    const char* appKey = argv[3];
    const char* fileLink = "https://gw.alipayobjects.com/os/bmw-prod/0574ee2e-f494-45a5-820f-63aee583045a.wav";

    fileTrans(accessKeyId, accessKeySecret, appKey, fileLink);

    return 0;
}

常见问题