======iOS SDK简介 ======
云之讯iOS平台SDK为第三方应用提供了简单易用的API调用服务,旨在为第三方开发者在应用内快速、高效、低成本集成语音业务提供了一站式的服务。基于SDK可更快速的为现有业务的客户提供了视频通话、语音通话、IM等基础通讯服务。当前为开发者提供
* Tcp SDK (无论使用IM SDK还是视频版SDK的功能都基于与云平台的连接,其中Tcp SDK提供连接云平台的能力)
* IM SDK
* 视频版SDK (其中视频版包含音频版所有功能)
开发者可根据实际需要选择不同版本进行集成开发。为更好的与平台进行对接,我们建议开发者不仅仅阅读该模块的文档内容,同时还建议同步阅读[[:平台架构概述]]、[[:应用接入建议]]等相关内容,提前为更大型的系统响应做准备。
* 推荐同步阅读:[[video_sdk:iossdkguide]]
===== SDK 内容介绍 =====
云之讯融合通讯开放平台iOS SDK是以C++静态库的方式提供给iOS开发人员,该SDK提供了端对端 语音聊天、视频聊天等通讯能力。集成此SDK可快速为您的iOS应用实现发起通话和接听通话的功能,包括在游戏中实现实时语音聊天等功能。
====1. SDK 文件介绍====
* UCSService.h 能力类文件。
* UCSService 类连接客户端到云之讯融合通讯开放平台服务器。 这个类包含了注册服务器,电话,实时语音等能力接口。
* UCSEvent.h 代理协议类文件。
* UCSCommonClass.h 消息公共类文件,主要包含了接口中所需要的数据相关类。
====2. SDK 头文件的组成====
SDK 头文件包含了能力接口和能力代理接口:
- 能力接口为开发者提供 语音聊天 视频聊天 等相关功能
- 能力代理接口为开发者提供 语音聊天 视频聊天 等相关功能的状态通知。
====3. SDK开发环境与要求====
Mac OS X 10.8 (Lion)及以上版本; XCode5.0及以上版本。
(推荐使用最新官方发布版本,因版本差异部分配置项不同,可能造成编译不通过)
====4. 名词解释====
-ObjC
这个flag告诉链接器把库中定义的Objective-C类和Category都加载进来,
如果静态库中有类和category的话只有加入这个flag才行。 详情开发指南
Architectures
设置你想支持的指令集,目前云之讯SDK指令集支持以下几种:armv7s armv7 arm64 详情开发指南
====5. iOS FAQ====
Q:为什么不支持模拟器调试?
//A:为了缩小SDK的体积,所以目前不支持模拟器调试。//
Q:DEMO为什么需要.mm后缀的源文件
//A:静态库中采用ObjectC++实现,因此需要您保证您工程中至少有一个.mm后缀的源文件(您可以将使用到SDK功能的.m后缀的其中一个文件改名为.mm),或者在工程属性中指定编译方式,即将Xcode的Build Setting中搜索Compile Sources As,将 Compile Sources As设置为"Objective-C++"//
平台的常见问题。详情==》 [[:faqs|常见问题FAQ]]
====6. iOS 全局返回码====
当功能集成后通过IDE编译到真机运行时,此时我们通过对应的回调函数返回全局返回码进行通知。
我们针对不同的场景定义了一批全局返回码。
全局码详情 ==》 [[video_sdk:iosv3returncode|iOS 返回码]]
====7. 其他====
为了方便第三方开发者快速云之讯iOS SDK,我们提供了以下联系方式,协助开发者进行集成:\\
* 邮箱:service@ucpaas.com \\
* QQ群:469065721 316069017(此群已满)\\
* 服务电话:400-097-0020 \\
另外,关于SDK的Bug反馈、用户体验、以及好的建议,请大家尽量提交到 [[http://bbs.ucpaas.com/forum.php|技术支持]] 上,我们会尽快解决。
目前,我们正在逐步完善云之讯 iOS SDK,争取为第三方开发者提供一个规范、简单易用、可靠、可扩展、功能全面的 SDK,敬请期待。