編寫緣由
由于項目需求,需要集成云信聊天,簡單來說就是類似于淘寶客服的功能。網(wǎng)易云信是提供聊天界面的,他們的第三方庫是開源的,意味著你可以根據(jù)自己的需求將他們的UI改成你想要的樣子。雖說他們宣稱的是7*24小時為你解答技術(shù)難題,但畢竟還有很多東西是他們幫不了你的,所以我希望通過分享自己集成過程中遇到的一些坑,讓有需要集成云信聊天的人少走一些彎路,希望我的分享對你有所幫助。好了,廢話不多說,show time。
集成步驟及遇到的坑
首先,到云信官網(wǎng)(http://netease.im/) 注冊一個賬號,當(dāng)然如果你已經(jīng)有賬號了,可以直接登錄即可。然后創(chuàng)建一個app,相信大家都已經(jīng)使用過很多第三方了,所以在這里我就不再贅述創(chuàng)建app的過程了,最后強(qiáng)調(diào)一句,創(chuàng)建好app后需要聯(lián)系網(wǎng)易的技術(shù)人員開通云信聊天服務(wù)就ok了。
然后需要有一個聊天的頁面,網(wǎng)易云信提供了倆種方式導(dǎo)入UI庫,第一種方式是手動導(dǎo)入,第二種方式是使用cocoapods導(dǎo)入。強(qiáng)烈建議你使用cocoapods導(dǎo)入UI庫,當(dāng)然你要是想鍛煉一下自己,你也可以使用手動導(dǎo)入的方式。在這里也主要說的是使用cocoapods導(dǎo)入的方式,打開終端,輸入以下命令:
cd /Users/admin/NetEaseDemo (cd 后面的是文件的路徑,直接將項目拖進(jìn)終端即可)
vim podfile (進(jìn)入podfile文件)
platform:ios,'8.0'
target 'NetEaseDemo'do
pod 'NIMKit'
end
退出終端 輸入pod install
等待一段時間,如果沒有報錯,說明導(dǎo)入UI庫成功。
打開工程,編譯工程,檢查是否有報錯,如果沒有報錯,說明集成成功,可以進(jìn)行下一步操作了。在進(jìn)行下一步操作之前,先了解一下基本的會話流程。我們的app都有注冊的功能,在注冊成功一個賬號后,由后臺調(diào)取網(wǎng)易云信的相關(guān)接口,下發(fā)一個accid和云信的token,accid是云信ID,也稱為“用戶帳號”,在整個應(yīng)用中都是唯一的,在登錄和創(chuàng)建會話的時候會用到,token是云信ID的密碼,用作登錄云信時使用。我們稱每一次聊天為一個會話(即session對象),初始化聊天界面時,上層需要傳入當(dāng)前聊天界面對應(yīng)的會話信息,即 NIMSession,進(jìn)行如下操作便可進(jìn)入聊天界面
NIMSession *session = [NIMSession session:uid type:NIMSessionTypeP2P];
NIMSessionViewController *vc = [[NIMSessionViewController alloc] initWithSession:session];
[self.navigationController pushViewController:vc animated:YES];
聊天界面截圖如下:
因為項目中使用到了系統(tǒng)相機(jī),相冊,位置,和麥克風(fēng)等信息,所以需要進(jìn)行設(shè)置訪問權(quán)限,否則會崩潰,在infoplist文件中填入如下信息即可
<key>NSPhotoLibraryUsageDescription</key>
<string>相冊權(quán)限</string>
<key>NSMicrophoneUsageDescription</key>
<string>麥克風(fēng)權(quán)限</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>地理位置權(quán)限</string>
<key>NSLocationUsageDescription</key>
<string>地理位置權(quán)限</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>地理位置權(quán)限</string>
細(xì)心的朋友會發(fā)現(xiàn)控制臺一直輸出
You should call login api before calling any im related api
意思是提醒我們需要進(jìn)行登錄云信操作,在調(diào)取后臺的登錄成功后,我們需要進(jìn)行如下登錄云信操作,并且在appdelegate中進(jìn)行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){}];
完了之后重新運(yùn)行工程,就沒有該報錯了。
到這里基本上就能完成聊天功能了,接下來說說我遇到的問題,并附上解決方案:
1.點(diǎn)擊輸入框下方的地圖,相冊,拍攝沒有跳轉(zhuǎn)頁面
找到點(diǎn)擊地圖,相冊,拍攝點(diǎn)擊事件,將如下方法
[[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;
}
}
便可進(jìn)行界面跳轉(zhuǎn)
2.點(diǎn)擊加號后,相冊,拍攝,位置的圖片沒有顯示
在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:@"位置"],
];
即可顯示圖片,如果想添加新的模塊,也可以在該方法中添加新的模塊,默認(rèn)的是相冊,拍攝,和位置