账号云之讯融合通讯开放平台-WIN开发指南

云之讯融合通讯开放平台Wind ows开发指南

1概述

云之讯融合通讯开放平台旨在为第三方应用开发者提供丰富完善的注册流程、接入机制、安全策略、管理后台以及不同语言的SDK开发包为开发者在应用内快速、高效、低成本集成语音业务提供了一站式的服务。本文档旨在为第三方应用开发者在Windo ws平台下集成Ucp aas SDK来打造语音业务提供参考文档预期的读者为第三方应用开发人员、平台开发人员、相关技术人员等。

1.1介绍

云之讯融合通讯开放平台SDK提供了VoI P通话、落地电话、即时消息等基础能力RESTAPI除了提供上述功能外还提供注册账号、 创建cli ent、营销外呼、语音验证码、各类查询等等。云之讯融合通讯开放平台Wind ows SDK以C++动态库的方式提供给W indow s平台开发人员。 REST API可通过HT TPS GET、 POST方式访问。

1.2开发流程

云之讯融合通讯开放平台作为通讯能力的云计算PAAS平台将传统电信网络的通讯能力、基于IP的通讯能力通过开放API以及SDK的方式提供给开发者和商家协助开发者快速、高效、低成本打造融合通讯能力的产品。

1.您的客户端应用集成云之讯融合通讯开放平台提供的SD K 同时客户端向您的应用服务器请求分配cl i ent账号信息

2.您的应用服务器通过调用云通讯平台REST API得到用户账号并返回给您的客户端应用

3.客户端应用通过调用S DK API发起呼叫请求或者监听呼入

2 VoIP快速体验

在云之讯融合通讯开放平台注册账号创建Dem o账号并下载获取UcsDe mo程序具体过程请参考以下内容。在Demo程序中演示了云通讯平台提供的基础Vo IP通话功能。

2.1 申请测试账号

在Ucpa as平台上获取Dem o账号信息须注册后创建Demo 即可获得开发VoIP所需的测试帐号信息。测试账号信息内容有主账号、主账号密码、client账号、client账号密码

应用ID

2.2环境搭建

推荐Windows7旗舰版32位

声卡正常的PC机

有耳麦的耳机

2.3 Demo

下载在Demo账号信息页面提供了不同平台下的D emo下载请选择Wi ndows版下载Uc sDemo功能介绍 Demo演示了Ucp aas SDK的A PI接口调用主要实现的功能

免费电话需要对方的clien t账号双方进行的网络P2P通话免费通话

电话直拨需要对方的手机号主叫接入网络电话被叫接入普通电话

2.4解压Dem o压缩文件

解压下载的UCS_DEMO_WINDOWS.zip文件到任一目录。

2.5运行体验

配置账号信息完成 即可运行Demo程序。

3创建自己的应用

这一节是为了让开发者能够用最少的代码量和时间来实现基本的VoIP通话功能。

3. 1 SDK介绍

SDK下载从Ucpa as平台下载VoIP的Wind ows SDK

SDK文件说明 SDK文件放在文件夹SDK中其中包含四个文件

UCSCl ient.h为SDK函数头文件

UCSNe tServ ice. lib为S DK静态库文件

UCSNe tServ ice.dll为S DK动态库文件

NetSe rvice.dll为SDK动态库文件

3.2环境搭建与 创建工程

推荐Microsof tVisual Studio2010作为开发环境,

开发者新建项目时选择需要的类型模板

3.3编写代码

介绍代码的实现过程也可参考D emo的代码实现加深理解U CSCli ent.h内SDK函数调用

3.3.1 Ucpaa s SDK初始化

{

//初始化SD K并传入回调函数

Ucs_i nit( UCS_CALLBACKINT ERFAC E*Callb ackIn terfa ce )

}

3.3.2登录cli ent账号

登录平台

{

//与Ucpa as平台连接

Ucs_c onnec tcons tchar*accountSid, const char*accountTok en, const char*clientNumb er, const char *clien tPwd) ;

}

连接事件相关回调函数

连接成功

void OnCon necti onSuc cessf ul()

{

//连接成功后的处理代码

}

连接失败void OnConnectFailed (int reason))

{

//连接失败后的处理代码

}

3.3.3创建VoIP免费通话(或电话直拨)

创建呼叫

{

//拨打免费通话(对方cli ent账号)或电话直拨(对方电话号码)

Ucs_d ial (type, (LPCTS TR)calle dNumb er)

}

连接被叫成功回调函数void onAle rting (const char *calli d)

{

//连接被叫成功

}

对方接听回调函数void onAns wer(const char *calli d)

{

//对方已接听

}

呼叫失败(被叫拒接被叫忙等原因)的回调函数可参考错误码查找失败原因void onDia lFail ed(const char *calli d, int reason)

{

//呼叫失败可根据re ason查找错误原因

}

通话过程中对方挂断的回调函数void OnCal lReleased(const char *calli d)

{

//通话过程中对方挂断电话

}

3.3.4接听VoIP通话

有呼叫呼入回调函数void onInc omingCall (const char* calli d, int callType, const char* caller){

//有VoIP电话呼入处理

}

接通电话

{

//接听VoI P电话使用cal lid参数标识接听某个具体的VoIP电话

Ucs_a nswer (calli d) ;

}

接听成功的代理函数void onAns wer(const char *calli d)

{

//接听成功

}

3.3.5挂断VoIP通话

{

//释放呼叫

Ucs_h angUp (calli d) ;

}

3.4编译运行和 测试

启动调试