开发者社区> 问答> 正文

c++ sdk是什么?




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(适用于多线程),默认为true, 详情参见libcurl官网说明
  • bool ssl 是否做openssl多线程初始化,默认为true, 详情参见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为录音文件转写,这里为hw
返回值
  • IRestfulRequest*对象


创建词表


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


查询词表内容


std::string getRequest(std::string id)
  • 说明该函数用来id对应请求的结果
参数
  • string id 请求的id
返回值
  • string 返回查询结果


更新词表


std::string updateRequest(std::string id, std::string body)
  • 说明该函数用来对具体某个id对应的词表的内容进行更新
参数
  • string id 词表的id,创建成功时会返回
  • string body 更新后的内容
返回值
  • string 返回更新操作的结果


删除词表


std::string deleteRequest(std::string id)
  • 说明该函数用来删除具体id对应的词表
参数
  • string id 词表id
返回值
  • string 返回删除操作结果

展开
收起
nicenelly 2017-10-25 15:17:05 3869 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
跨平台的云服务SDK需要什么 立即下载
一个跨平台的云服务SDK需要什么 立即下载
从 SDK 到编解码:视频直播架构解析 立即下载