之多云应用开发API

为了方便大家开发,之多云提供了丰富且简单的开发API。

同时我们也提供了不同编程语言对应的开发SDK,方面大家直接使用。 SDK下载请点击这里

API为32位dll,路径位于之多云安装目录下, dll 名称为 ZDCloudAPI.dll

1.初始化接口

int Initial(wchar_t* appkey, wchar_t* seckey, ZDCloudAPICallBack zdcCallBack)
参数:
    [in] wchar_t* appkey:   申请时获得的appkey
    [in] wchar_t* seckey:   申请时获得的seckey
    [in] ZDCloudAPICallBack zdcCallBack:传入ZDCloudAPI回调函数,传入NULL,则忽略回调信息
         typedef void(WINAPI *ZDCloudAPICallBack)(int type);
         [out] int type: 0:登录 1:退出 2:注销
返回值:
    0:OK
    1:appkey错误
    2:seckey错误
    其他值:其他错误代码
备注:应用需同之多云保持账号同步,在接到注销回调时,妥善保存数据,并将应用内部登录信息清空,等待之多云的登录回调(或者自主调用Login),再进行新uid的操作

2.释放接口

void UnInitial()
返回值: void
备注:退出时调用

3.获取之多云登录信息

int GetLoginInfo(wchar_t* uid, wchar_t* nick, wchar_t* zdck)
参数:
    [out] wchar_t* uid: 账号,缓冲区大小为32
    [out] wchar_t* nick:    昵称,缓冲区大小为128
    [out] wchar_t* zdck:    登录授权zdck,缓冲区大小为256
返回值:
    0:已登录,uid,nick,zdck已复制到缓冲区
    1:之多云没有登录
    2:App尚未初始化
    其他值:其他错误代码

4.登录

void Login()
返回值:void
备注:之多云尝试自动登录,如果失败将打开登录窗口

5.下载

void NewDownload(wchar_t* url, wchar_t* fileName, wchar_t* path, BOOL bShowWindow)
参数:
    [in] wchar_t* url:          下载url,此参数必须http://开头的下载地址
    [in] wchar_t* fileName: 保存文件名,若为空字符串"",则自动侦测文件名
    [in] wchar_t* path:     保存路径,若为空字符串"",则使用之多云默认下载路径
    [in] BOOL bShowWindow:  TRUE 显示新建下载窗口,FALSE 后台下载
返回值: void

6.显示之多云下载

void ShowDownloadMgr()
返回值: void

7.之多云TTS打断朗读

int SpeakAsync(wchar_t* text, BOOL bWindowChangedStop)
参数:
    [in] wchar_t* text: 要朗读的文本,缓冲区最大为4000
    [in] BOOL bWindowChangedStop:   窗口切换时打断朗读
返回值: 
    0:成功
    1:App尚未初始化
    2:text为NULL或长度大于4000

8.之多云TTS插入朗读

int SpeakInsert(wchar_t* text, BOOL bWindowChangedStop)
参数:
    [in] wchar_t* text: 要朗读的文本,缓冲区最大为255
    [in] BOOL bWindowChangedStop:   窗口切换时打断朗读
返回值: 
    0:成功
    1:App尚未初始化
    2:text为NULL或长度大于255

9.之多云TTS尝试朗读

int SpeakTry(wchar_t* text, BOOL bWindowChangedStop)
参数:
    [in] wchar_t* text: 要朗读的文本,缓冲区最大为4000
    [in] BOOL bWindowChangedStop:   窗口切换时打断朗读
返回值: 
    0:成功    
    1:App尚未初始化
    2:text为NULL或长度大于4000
    3:当之多云正在朗读时,尝试朗读失败

10.之多云TTS停止朗读

void StopSpeak()
返回值: void