工程云之讯融合通讯开放平台-IOS开发指南

云之讯融合通讯开放平台IOS开发指南1快速体验

在云之讯平台注册账号创建Dem o账号并下载获取UCSVo ipDem o程序具体过程请参考以下内容。

在Demo程序中演示了云之讯平台提供的网络通话、落地电话、回拨、即时消息。

1.1申请测试账号

在云之讯平台上获取D emo账号信息须注册后创建Demo 即可获得开发VoIP所需的测试帐号信息。

测试账号信息内容有 SID、 TOKEN、VoIP账号、VoIP账号密码。

1.2环境搭建

Mac OS X 10.7(Lion)及以上版本;XCode 4.2及以上版本 .

1.3 Demo介绍

 下载在Demo账号信息页面提供了An droid和IOS平台下的De mo下载请选择IO

S版下载。

 UCSVo ipDem o功能介绍Demo演示了UCS SDK的API口调用主要实现的功能

 免费电话需要对方的VoIP账号免费通话

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

话

 回拨呼叫需要对方的手机号双方都会接入普通电话网络进行通话

 UCSVo ipDem o工程文件结构说明

Produ ct应用生成的app

Frame work包含工程需要依赖的资源项主要是系统和需要依赖的库资源

UCSVo ipDem o包含整个工程需要完成的代码文件视图控制类的实现文件、 resou rce文件夹(账号文件 图片资源文件等)、ccp sdk文件夹(SDK库文件)、Suppo rttin gFiles文件夹。

1.4导入DEM O工程

解压下载U CS_PH ONE_D EMO_I OS.rar(此名字取决于官网的)文件在解压缩的文件夹中双击UCS VoipD emo.xcode proj文件在XCod e中打开工程即可对De mo进行其他操作。

1.5配置账号信息

打开res ource\ucsin focon fig.plist文件将申请测试账号时获取的Demo账号信息依次输入配置文件中如图所示:

2创建自己的VoIP应用

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

2.1 SDK介绍

 SDK下载从UCPa aS平台下载VoIP的IOSS DK

 SDK文件说明 SDK文件放在文件夹ucpsd k中其中包含三个文件

UCSService.h为应用调用的函数头文件

UCSEv ent.h为SDK的代理函数头文件libuc sapisdk.a为整个SD K库文件

2.2创建工程

2.2.1新建工程

创建一个i Phone工程需要在Mac系统下面安装X code的软件Xcode安装完成后可以在桌面的快速启动栏中的"Launc hpad"中或者应用程序中找到一个图标看到后单击或者双击即可打开软件 Xcode版本最小需要4.2。

打开Xco de后的界面可以看到几个选项创建工程需要选择"Creat e a newXc ode proje ct",如下图所示

也可以根据菜单创建工程依次选择X Code菜单栏中的F iLe->New->Proje ct如下图所示

选择完后弹出的界面中选择左边的"IOS"下面的"Appli catio n",然后选择右边的"SingLeView AppLi catio n"进行双击或者点击右下角"Next",如下图所示

在完成后弹出的界面中的"Produ ctNam e"中填写你的工程名如下图所示:

添加完成后点击右下角的”Next” 在弹出的对话框中选择你需要把工程放置的位置。这样一个工程就初步的创建完成。

2.2.2导入UC SSDK

创建完成工程后把SDK包里面的uc ssdk文件夹拷贝到新创建的工程路径下面然后在工程目录结构中右键选择Add Files to“UCSVo ipDemo”(工程名厂在弹出的对话框中选择新创建的工程文件夹下的ccps dk这个文件夹(也就是前面拷贝的文件夹)。或者将这个文件夹拖入XCode工程目录结构中

在弹出的界面中勾选Copy items into destination group’s folder(ifneeded),并确保Add ToTargets勾选相应的tar get。 相应的操作请看下图中所示

2.2.3配置工程信息

 添加依赖框架(Frame works )

UCSSD K的实现依赖了一些系统框架在开发应用时要在工程里加入这些框架。开发者首先点击工程右边的工程名然,后在工程名右边依次选择T ARGET S->BuiLd Phases->Link Binar y With Libra ries,展开Lin kBina ry With Libra ries后点击展开后下面的"+"来添加下面的依赖项:

添加步骤如图所示:

 编译器设置

在xcod e5.1环境下首先点击工程右边的工程名,然后在工程名右边依次选择TARGETS、Build Settings compi ler 5.1- Language”中的”C++ Standard Libra ry".存后面的选择框中选择libstdc++(GNU C+standard Libra ry)”选项如果默认是则不需要修改。步骤如下图所示

 工程属性设置

一般的iOS程序进入后台后会被系统挂起就会停止执行不能执行任何操作。

A. 从iOS4开始苹果增加了特性很好的支持了VoIP功能

 苹果支持应用可以在后台播放和录制声音

 苹果支持网络托管保证应用在后台时还能保持网络连接能接收到来电 应用可以设置一个超时处理程序在后台运行时周期性地唤醒应用保证

客户端和服务器有长连接使网络不断开。

B. UCSSD K封装了这些特性保证了在i〇S平台上有很好的VoIP体验。

C. 开发者需要修改配置文件这样IOS工程才能支持这些特性。

在工程名的文件夹下面的Supporting Files文件夹中找到并且选择(工程名lnfo.pList在右边出现的窗口中添加Key:Required backg round modes在下面添加两个项Appplays audio和App provides Voice over IP services。

2.3编写代码

介绍代码的实现过程也可参考Demo的代码实现。

注意事项调用SDK文件要以.mm为后缀要,包含头文件UCS Servic e.h和UCSEvent.h。

2.3.1CCPS DK初始化

初始化SD K的代码

{

//初始化CC PSDK并传入代理实现的类实例

UCSService*uc s Service=[[UCSService alloc] initW ithDelegate:self];