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

云之讯WIN开发说明,教你如何从最简单的步骤建立工程,最好完成开发。

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

1 概述

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

1.1 介绍

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

1.2 开发流程

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

1.您的客户端应用集成云之讯融合通讯开放平台提供的SDK，同时客户端向您的应用服务器请求分配client账号信息；

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

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

云之讯WIN开发说明,教你如何从最简单的步骤建立工程,最好完成开发。

2 VoIP快速体验

在云之讯融合通讯开放平台注册账号，创建Demo账号，并下载获取UcsDemo程序（具体过程请参考以下内容）。在Demo程序中，演示了云通讯平台提供的基础VoIP通话功能。

2.1 申请测试账号

在Ucpaas平台上获取Demo账号信息，须注册后创建Demo，即可获得开发VoIP所需的测试帐号信息。测试账号信息内容有：主账号、主账号密码、client账号、client账号密码，应用ID

2.2 环境搭建

推荐Windows7旗舰版 32位

声卡正常的PC机

有耳麦的耳机

2.3 Demo

下载：在Demo账号信息页面，提供了不同平台下的Demo下载，请选择Windows版下载Ucs Demo功能介绍，Demo演示了Ucpaas SDK的API接口调用，主要实现的功能：

免费电话：需要对方的client账号，双方进行的网络P2P通话，免费通话

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

2.4 解压Demo压缩文件

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

2.5 运行体验

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

云之讯WIN开发说明,教你如何从最简单的步骤建立工程,最好完成开发。

3 创建自己的应用

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

3.1 SDK介绍

SDK下载：从Ucpaas平台下载VoIP的Windows SDK

SDK文件说明：SDK文件放在文件夹SDK中，其中包含四个文件：

UCSClient.h为SDK函数头文件

UCSNetService.lib为SDK静态库文件

UCSNetService.dll为SDK动态库文件

NetService.dll为SDK动态库文件

3.2 环境搭建与创建工程

推荐Microsoft Visual Studio 2010作为开发环境,

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

3.3 编写代码

介绍代码的实现过程，也可参考Demo的代码实现，加深理解UCSClient.h内SDK函数调用

3.3.1 Ucpaas SDK初始化

{

// 初始化SDK，并传入回调函数

Ucs_init( UCS_CALLBACKINTERFACE *CallbackInterface )

}

3.3.2 登录client账号

登录平台

{

// 与Ucpaas平台连接

Ucs_connectconst char *accountSid, const char *accountToken, const char *clientNumber, const char *clientPwd);

}

连接事件相关回调函数

连接成功：

云之讯WIN开发说明,教你如何从最简单的步骤建立工程,最好完成开发。

void OnConnectionSuccessful()

{

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

}

连接失败：

void OnConnectFailed(int reason))

{

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

}

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

创建呼叫

{

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

Ucs_dial(type,(LPCTSTR)calledNumber)

}

连接被叫成功回调函数

void onAlerting(const char *callid)

{

// 连接被叫成功

}

对方接听回调函数

void onAnswer(const char *callid)

{

// 对方已接听

}

呼叫失败(被叫拒接，被叫忙等原因)的回调函数，可参考错误码查找失败原因 void onDialFailed(const char *callid, int reason)

{

// 呼叫失败，可根据reason查找错误原因

}

通话过程中，对方挂断的回调函数

void OnCallReleased(const char *callid)

{

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

}

云之讯WIN开发说明,教你如何从最简单的步骤建立工程,最好完成开发。

3.3.4 接听VoIP通话

有呼叫呼入回调函数

void onIncomingCall (const char* callid, int callType, const char* caller) {

// 有VoIP电话呼入处理

}

接通电话

{

// 接听VoIP电话，使用callid参数标识接听某个具体的VoIP电话

Ucs_answer(callid);

}

接听成功的代理函数

void onAnswer(const char *callid)

{

// 接听成功

}

3.3.5 挂断VoIP通话

{

// 释放呼叫

Ucs_hangUp(callid);

}

3.4 编译运行和测试

启动调试