云之讯融合通讯开放平台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编译运行和 测试
启动调试
火数云怎么样?火数云主要提供数据中心基础服务、互联网业务解决方案,及专属服务器租用、云服务器、专属服务器托管、带宽租用等产品和服务。火数云提供洛阳、新乡、安徽、香港、美国等地骨干级机房优质资源,包括BGP国际多线网络,CN2点对点直连带宽以及国际顶尖品牌硬件。专注为个人开发者用户,中小型,大型企业用户提供一站式核心网络云端服务部署,促使用户云端部署化简为零,轻松快捷运用云计算!多年云计算领域服务经...
Hostodo 算是比较小众的海外主机商,这次九月份开学季有提供促销活动。不过如果我们有熟悉的朋友应该知道,这个服务商家也是比较时间久的,而且商家推进活动比较稳,每个月都有部分活动。目前有提供机房可选斯波坎、拉斯维加斯和迈阿密。从机房的地理位置和实际的速度,中文业务速度应该不是优化直连的,但是有需要海外业务的话一般有人选择。以前一直也持有他们家的年付12美元的机器,后来用不到就取消未续约。第一、开...
ZJI本月新上线了香港葵湾机房站群服务器,提供4个C段238个IPv4,支持使用8折优惠码,优惠后最低每月1400元起。ZJI是原Wordpress圈知名主机商家:维翔主机,成立于2011年,2018年9月更名为ZJI,提供中国香港、台湾、日本、美国独立服务器(自营/数据中心直营)租用及VDS、虚拟主机空间、域名注册等业务,所选数据中心均为国内普遍访问速度不错的机房。葵湾二型(4C站群)CPU:I...