AnyChat使用攻略之iOS开发指南
这套攻略主要指导刚开始使用AnyChat SDK For iOS的同学,快速搭建SDK环境,和实现音视频开发流程.
(需要工程案例文件可联系我们)
在iOS平台上使用AnyChat客户端SDK,需要注意以下几点。
(以附带的工程为例子讲解—环境: iOS7.0 ,Xcode5.1.1)
1,首先下载最新的AnyChat for iOS SDK(点击打开下载页面);
2,解压缩下载的SDK包,如下图所示:
3,iOS工程本身必须要引用5个框架。
在xcode软件菜单的Project-->Build Phases-->Link Binary With Libraryes里面增加库,如图:
(有不少同学,出现编译Undefined symbols for architecture i386:"_AVCaptureSessionPreset1280x720", referenced from:……等类似错误,是因为忘记添加所示的iOS Framework.)
4,进入刚下载的官方SDK包里面,目录是【sdk\libs\】,也是要全部添加到你的工程里面。
可以通过在xcode的左下角如图:
地方添加引用工程外的库文件,
(别忘了【sdk\libs\audioprocess】目录下还有几个.a静态库文件。 下图中库文件数量和
最新 SDK包里的库文件数量
会有所不同,以最新 SDK 包为标准),
在添加完成库的时候编译下,如果按流畅走,应该是有一个小警告,不影响正常运行的.警告如下:
(warning: ignoring file /Users/bairuitech/Desktop/AnyChatIOS/libvad.a, file was built for archive which is not the architecture being linked (i386): /Users/bairuitech/Desktop/AnyChatIOS/libvad.a) ,
这个libvad.a 文件 可以先删除,这项目真是没需要到.
5,另外需要配置C++环境,以下两个步骤解决:
第一步:Build Settings-->Apple LLVM 5.1 - Language - C++ --> C++ Standard Library,
设置为:libstdc++(GNU C++ standard library)
第二步:Project-->Build Phases-->Link Binary With Libraryes里面增加库:libstdc++.dylib
第三步:在“Project-->Build Phases-->Link Binary With Libraryes”里面添加库“libstdc++.6.dylib”,如下图所示:
然后Clean工程,然后重新Build。
如果没有配置C++环境,就会在编译时候出现类似 Undefined symbols for architecture i386:"std::_List_node_base::hook(std::_List_node_base*)", referenced from:…….等类似错误,是因为在链接(Link)过程中出错,缺少c++静态库或不兼容.
详情可参考:http://bbs.anychat.cn/forum.php? ... =806&extra=page%3D1
6,配置调试器环境。
为了兼容不同设备的内核,请在如图地方设置:
修改Build Active Architecture Only选项为Yes,或者修改Valid Architectures选项为armv7,两个方法选一个即可。
如果没配置的话,在调试时会出现以下错误:
、Undefined symbols for architecture x86_64: "_OBJC_CLASS_$_AnyChatPlatform", referenced from: objc-class-ref in AnchatViewController.old :symbol(s) not found for architecture x86_64 clang: error: linker command failed with exit code 1 (use -v to see invocation)
7,SDK解压包的【sdk\include】目录里面是AnyChat的Objective-c SDK协议文件. 如图:
在制作过程中,工程都需要引用此协议到代码.h头文件处。
#import "AnyChatPlatform.h"
#import "AnyChatDefine.h"
#import "AnyChatErrorCode.h"
(如果要获取本地视频另外还需要引用 #import "AVFoundation.h" )
8, 在应用程序启动时(AppDelegate),设置默认端口和IP地址参数(为了连接服务器做准备)。
ServerIP : “demo.anychat.cn”
ServerPort : “8906”
9,程序加载前,做初始化系统和配置登录连接,主要以下方法:
[AnyChatPlatform InitSDK:0]; // 初始化系统
[AnyChatPlatform Connect: ServerIP : ServerPort; // 连接服务器参数
[AnyChatPlatform Login: UserName : @""]; // 登录系统 (UserName参数:登录自定义的用户名)
(以上步骤完成后,运行登录成功会在控制台打印显示 Connection to streaming media server successfully!)
[AnyChatPlatform EnterRoom:1 :@""]; //进入房间
(EnterRoom的值在例子中是设置了第一个房间,目前有6个房间可以自己重新选择)
通过[AnyChatPlatform GetOnlineUser]方法,获取返回值是一个远程用户ID的列表数组
(可以通过此数组获取第一用户ID与他视频聊天。)
10,
1),在显示视图中需要添加AnyChatNotifyMessageDelegate协议,必须实现以下7个方法。
// 连接服务器消息
- (void) OnAnyChatConnect:(BOOL) bSuccess;
// 用户登陆消息
- (void) OnAnyChatLogin:(int) dwUserId : (int) dwErrorCode;
// 用户进入房间消息
- (void) OnAnyChatEnterRoom:(int) dwRoomId : (int) dwErrorCode;
// 房间在线用户消息
- (void) OnAnyChatOnlineUser:(int) dwUserNum : (int) dwRoomId;
// 用户进入房间消息
- (void) OnAnyChatUserEnterRoom:(int) dwUserId;
// 用户退出房间消息
- (void) OnAnyChatUserLeaveRoom:(int) dwUserId;
// 网络断开消息
- (void) OnAnyChatLinkClose:(int) dwErrorCode;
(注意两个事件处理:1当有用户进出房间时触发的事件,2用户自己进房间先后顺序的事件处理。)
2),工程里实现了SDK的
状态改变事件协议
AnyChatStateChangeDelegate,以此为案例和同学们复习一下iOS开发语法,怎样实现协议与委托的三部曲.(ios开发老手可略过,此协议对于视频聊天不是必须实现的)
首先是在实现协议的类.h头文件中添加,你要引用的协议.
然后该协议里面有5个委托方法必须实现在类的.m文件中(在
AnyChatPlatform.h中可以查到那5个方法
),
最后这步是很多iOS初学者忘记的,就是设置委托代理是谁 (如:_cxsAnyChatPlatform.stateChangeDelegate = self;)
11, 在视图现实获取视频图像,只需要在现实的地方添加UIImageView,通过以下方法操作,
[AnyChatPlatform UserSpeakControl: userid:YES]; // 操作用户语音
[AnyChatPlatform SetVideoPos:userid: 自定义的UIImageView对象:0:0:0:0]; // 设置视频显示位置默认为零时,会自动调节为UIImageView同等大小
[AnyChatPlatform UserCameraControl:userid : YES]; // 操作用户视频
注意:在整过视频聊天过程中,有几个地方调用以上3个方法,
1)-(void) OnAnyChatEnterRoom:(int) dwRoomId : (int) dwErrorCode;在收到该委托方法之后,可打开本地用户的音视频.
2)-(void) OnAnyChatOnlineUser:(int) dwUserNum : (int) dwRoomId;在收到该委托方法之后,可打开当前房间在线用户的音视频.
3)-(void) OnAnyChatUserEnterRoom:(int) dwUserId;在收到该委托方法之后,可打开当前进入房间用户的音视频.