全部产品

c++ restful sdk

更新时间:2017-08-11 10:02:16   分享:   

c++ 录音文件转写SDK 使用说明

功能介绍

C++ 录音文件转写SDK以Restful方式提供长语音文件识别接口的功能,用户可以通过此sdk可以方便的进行录音文件转写。

SDK下载地址

录音文件转写C++ SDK

demo 编译命令及注意事项

  1. g++ -o demo demo.cpp -I ../include -L ../lib -lrestfulUnity -lcurl -lssl -lcrypto

  2. 编译命令中-lssl -lcrypto 为sdk中作权限验证需要依赖的库,sdk发布包中已经包含该库(64位)

  3. 此sdk的运行环境为linux 64位,编译前请确保已安装curl(运行curl -V),并安装了相关依赖(主要是openssl,版本是1.0.2j)。

  4. 由于此sdk没有采用c11,因此如果您的编译器版本较高(超过5.0),编译时请加上-D_GLIBCXX_USE_CXX11_ABI=0

  5. 由于使用到了libcurl第三方库,多线程调用请参考libcurl的相关说明

  6. sdk采用ISO 标准c++编写,运行环境最低要求:glibc:2.5 gcc 版本:4.1.2

  7. sdk提供的库文件为librestfulUnity.so 该库文件仅支持64位运行环境,暂不支持32位运行环境

SDK调用顺序

  1. 创建一个RestfulClient对象,该对象可用来创建具体的request对象

  2. 通过1中的对象调用createRestfulRequest获取request对象,该对象提供对请求录音文件转写和查询转写结果的功能

  3. 对于创建功能来说,需要准备一个参数的结构体对象,具体可下载sdk并参考demo程序

  4. 调用相应的方法并返回结果

重要接口说明


词表配置sdk对外暴露的类,调用程序通过调用该类的createRequest()、getRequest()、updateRequest()、deleteRequest()方法来对词表进行增、查、改、删操作。

初始化RestfulClient

RestfulClient(bool curlInitglobal = true, bool ssl = true)

  • 说 明
    • 初始化RestfulClient对象
  • 参 数
    • bool curlInitglobal 是否全局初始curl(适用于多线程),详情参见libcurl官网说明
    • bool ssl 是否做openssl多线程初始化,详情参见openssl官网说明
  • 返回值

创建用于请求的对象

IRestfulRequest* createRestfulRequest(std::string url, std::string id, std::string secret,RequestType type)

  • 说 明
    • 根据type创建IRestfulRequest* 对象,包括kws,hw,和recoderTranscription
  • 参 数
    • string url 词表的配置url地址,一般比较固定
    • string id 用户id
    • string secret 用户密码
    • RequestType type kws为关键词,hw为热词,和recoderTranscription为录音文件转写
  • 返回值
    • IRestfulRequest*对象

创建请求

std::string createRequest(std::string body)

  • 说 明
    • 该函数用来创建录音文件识别请求
  • 参 数
    • string body 创建请求需要的参数,该串中包含有哪些参数和验证
  • 返回值
    • string 返回创建请求的结果,成功则包含请求id

查询结果

std::string getRequest(std::string id)

  • 说明
    • 该函数用来id对应请求的结果
  • 参数
    • string id 请求的id
  • 返回值
    • string 返回查询结果
本文导读目录
本文导读目录
以上内容是否对您有帮助?