云之讯融合通讯开放平台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编译运行和 测试
启动调试
傲游主机商我们可能很多人并不陌生,实际上这个商家早年也就是个人主机商,传说是有几个个人投资创办的,不过能坚持到现在也算不错,毕竟有早年的用户积累正常情况上还是能延续的。如果是新服务商这几年确实不是特别容易,问到几个老牌的个人服务商很多都是早年的用户积累客户群。傲游主机目前有提供XEN和KVM架构的云服务器,不少还是亚洲CN2优化节点,目前数据中心包括中国香港、韩国、德国、荷兰和美国等多个地区的CN...
轻云互联成立于2018年的国人商家,广州轻云互联网络科技有限公司旗下品牌,主要从事VPS、虚拟主机等云计算产品业务,适合建站、新手上车的值得选择,香港三网直连(电信CN2GIA联通移动CN2直连);美国圣何塞(回程三网CN2GIA)线路,所有产品均采用KVM虚拟技术架构,高效售后保障,稳定多年,高性能可用,网络优质,为您的业务保驾护航。活动规则:用户购买任意全区域云服务器月付以上享受免费更换IP服...
欧路云新上了美国洛杉矶cera机房的云服务器,具备弹性云特征(可自定义需要的资源配置:E5-2660 V3、内存、硬盘、流量、带宽),直连网络(联通CUVIP线路),KVM虚拟,自带一个IP,支持购买多个IP,10G的DDoS防御。付款方式:PayPal、支付宝、微信、数字货币(BTC USDT LTC ETH)测试IP:23.224.49.126云服务器 全场8折 优惠码:zhujiceping...