云之讯融合通讯开放平台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编译运行和 测试
启动调试
阿里云香港配置图提速啦是成立于2012年的十分老牌的一个商家这次给大家评测的是 阿里云香港 16核32G 20M 这款产品,单单说价格上就是十分的离谱原价8631元/月的现价只要 999元 而且还有个8折循环优惠。废话不多说直接进入正题。优惠时间 2021年8月20日-2021年9月20日 优惠码 wn789 8折优惠阿里云香港BGP专线 16核32G 10M带宽 优惠购买 399元购买链接阿里云...
RackNerd 商家我们应该是比较熟悉的商家,速度一般,但是人家便宜且可选机房也是比较多的,较多集中在美国机房。包括前面的新年元旦促销的时候有提供年付10美元左右的方案,实际上RackNerd商家的营销策略也是如此,每逢节日都有活动,配置简单变化,价格基本差不多,所以我们网友看到没有必要囤货,有需要就选择。RackNerd 商家这次2022农历新年也是有几款年付套餐。低至RackNerd VPS...
LOCVPS商家我们还是比较熟悉的老牌的国内服务商,包括他们还有其他的产品品牌。这不看到商家的信息,有新增KVM架构轻量/迷你套餐,提供的机房包括香港云地和美国洛杉矶,适用全场8折优惠,月付29.6元起。LOCVPS是一家成立于2011年的稳定老牌国人商家,主要从事XEN、KVM架构的国外VPS销售,主推洛杉矶MC、洛杉矶C3、香港邦联、香港沙田电信、香港大埔、日本东京、日本大阪、新加坡等数据中心...