编写缘由
由于项目需求,需要集成云信聊天,简单来说就是类似于淘宝客服的功能。网易云信是提供聊天界面的,他们的第三方库是开源的,意味着你可以根据自己的需求将他们的UI改成你想要的样子。虽说他们宣称的是7*24小时为你解答技术难题,但毕竟还有很多东西是他们帮不了你的,所以我希望通过分享自己集成过程中遇到的一些坑,让有需要集成云信聊天的人少走一些弯路,希望我的分享对你有所帮助。好了,废话不多说,show time。
集成步骤及遇到的坑
首先,到云信官网(http://netease.im/) 注册一个账号,当然如果你已经有账号了,可以直接登录即可。然后创建一个app,相信大家都已经使用过很多第三方了,所以在这里我就不再赘述创建app的过程了,最后强调一句,创建好app后需要联系网易的技术人员开通云信聊天服务就ok了。
然后需要有一个聊天的页面,网易云信提供了俩种方式导入UI库,第一种方式是手动导入,第二种方式是使用cocoapods导入。强烈建议你使用cocoapods导入UI库,当然你要是想锻炼一下自己,你也可以使用手动导入的方式。在这里也主要说的是使用cocoapods导入的方式,打开终端,输入以下命令:
cd /Users/admin/NetEaseDemo (cd 后面的是文件的路径,直接将项目拖进终端即可)
vim podfile (进入podfile文件)
platform:ios,'8.0'
target 'NetEaseDemo'do
pod 'NIMKit'
end
退出终端 输入pod install
等待一段时间,如果没有报错,说明导入UI库成功。
打开工程,编译工程,检查是否有报错,如果没有报错,说明集成成功,可以进行下一步操作了。在进行下一步操作之前,先了解一下基本的会话流程。我们的app都有注册的功能,在注册成功一个账号后,由后台调取网易云信的相关接口,下发一个accid和云信的token,accid是云信ID,也称为“用户帐号”,在整个应用中都是唯一的,在登录和创建会话的时候会用到,token是云信ID的密码,用作登录云信时使用。我们称每一次聊天为一个会话(即session对象),初始化聊天界面时,上层需要传入当前聊天界面对应的会话信息,即 NIMSession,进行如下操作便可进入聊天界面
NIMSession *session = [NIMSession session:uid type:NIMSessionTypeP2P];
NIMSessionViewController *vc = [[NIMSessionViewController alloc] initWithSession:session];
[self.navigationController pushViewController:vc animated:YES];
聊天界面截图如下:
聊天界面截图如下因为项目中使用到了系统相机,相册,位置,和麦克风等信息,所以需要进行设置访问权限,否则会崩溃,在infoplist文件中填入如下信息即可
<key>NSPhotoLibraryUsageDescription</key>
<string>相册权限</string>
<key>NSMicrophoneUsageDescription</key>
<string>麦克风权限</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>地理位置权限</string>
<key>NSLocationUsageDescription</key>
<string>地理位置权限</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>地理位置权限</string>
细心的朋友会发现控制台一直输出
You should call login api before calling any im related api
意思是提醒我们需要进行登录云信操作,在调取后台的登录成功后,我们需要进行如下登录云信操作,并且在appdelegate中进行SDK配置操作
///sdk配置
[[NIMSDK sharedSDK] registerWithAppID:您的APPKEY
cerName:您的推送证书名];
///登录云信
///account 为云信ID,
///token为云信token
[[[NIMSDK sharedSDK] loginManager] login:account
token:token
completion:^(NSError *error) {}];
///退出云信
[[[NIMSDK sharedSDK] loginManager] logout:^(NSError *error){}];
完了之后重新运行工程,就没有该报错了。
到这里基本上就能完成聊天功能了,接下来说说我遇到的问题,并附上解决方案:
1.点击输入框下方的地图,相册,拍摄没有跳转页面
找到点击地图,相册,拍摄点击事件,将如下方法
[[UIApplication sharedApplication].keyWindow.rootViewController presentViewController:nav animated:YES completion:nil];
替换为
[[self topViewController] presentViewController:nav animated:YES completion:nil];
- (UIViewController*)topViewController
{
return [self topViewControllerWithRootViewController:[UIApplication sharedApplication].keyWindow.rootViewController ];
}
- (UIViewController*)topViewControllerWithRootViewController:(UIViewController*)rootViewController
{
if ([rootViewController isKindOfClass:[UITabBarController class]]) {
UITabBarController *tabBarController = (UITabBarController *)rootViewController;
return [self topViewControllerWithRootViewController:tabBarController.selectedViewController];
} else if ([rootViewController isKindOfClass:[UINavigationController class]]) {
UINavigationController* navigationController = (UINavigationController*)rootViewController;
return [self topViewControllerWithRootViewController:navigationController.visibleViewController];
} else if (rootViewController.presentedViewController) {
UIViewController* presentedViewController = rootViewController.presentedViewController;
return [self topViewControllerWithRootViewController:presentedViewController];
} else {
return rootViewController;
}
}
便可进行界面跳转
2.点击加号后,相册,拍摄,位置的图片没有显示
在NIMKitUIConfig的.m中将下面代码
return @[[NIMMediaItem item:@"onTapMediaItemPicture:"
normalImage:[UIImage nim_imageInKit:@"bk_media_picture_normal"]
selectedImage:[UIImage imageNamed:@"bk_media_picture_nomal_pressed"]
title:@"相册"],
[NIMMediaItem item:@"onTapMediaItemShoot:"
normalImage:[UIImage imageNamed:@"bk_media_shoot_normal"]
selectedImage:[UIImage imageNamed:@"bk_media_shoot_pressed"]
title:@"拍摄"],
[NIMMediaItem item:@"onTapMediaItemLocation:"
normalImage:[UIImage imageNamed:@"bk_media_position_normal"]
selectedImage:[UIImage imageNamed:@"bk_media_position_pressed"]
title:@"位置"],
];
替换为
return @[[NIMMediaItem item:@"onTapMediaItemPicture:"
normalImage:[UIImage nim_imageInKit:@"bk_media_picture_normal"]
selectedImage:[UIImage nim_imageInKit:@"bk_media_picture_nomal_pressed"]
title:@"相册"],
[NIMMediaItem item:@"onTapMediaItemShoot:"
normalImage:[UIImage nim_imageInKit:@"bk_media_shoot_normal"]
selectedImage:[UIImage nim_imageInKit:@"bk_media_shoot_pressed"]
title:@"拍摄"],
[NIMMediaItem item:@"onTapMediaItemLocation:"
normalImage:[UIImage nim_imageInKit:@"bk_media_position_normal"]
selectedImage:[UIImage nim_imageInKit:@"bk_media_position_pressed"]
title:@"位置"],
];
即可显示图片,如果想添加新的模块,也可以在该方法中添加新的模块,默认的是相册,拍摄,和位置
网友评论
session == (null)
[!] /usr/bin/git clone https://github.com/netease-im/NIM_iOS_UIKit.git /var/folders/m0/qyj6krw57zs5f9882wfs8r1c0000gn/T/d20180810-13730-saj30v --template= --single-branch --depth 1 --branch 1.8.0
Cloning into '/var/folders/m0/qyj6krw57zs5f9882wfs8r1c0000gn/T/d20180810-13730-saj30v'...
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
调用这个方法 NimUIKit.startChatting(this, account, SessionTypeEnum.P2P, sessionCustomization,null);时一直报这个错误!官方的方法,好奇怪
java.lang.RuntimeException: Parcelable encountered IOException writing serializable object (name = com.netease.nim.uikit.api.model.session.SessionCustomization)