編寫緣由
由于項目需求井濒,需要集成云信聊天,簡單來說就是類似于淘寶客服的功能列林。網易云信是提供聊天界面的瑞你,他們的第三方庫是開源的,意味著你可以根據(jù)自己的需求將他們的UI改成你想要的樣子希痴。雖說他們宣稱的是7*24小時為你解答技術難題者甲,但畢竟還有很多東西是他們幫不了你的,所以我希望通過分享自己集成過程中遇到的一些坑砌创,讓有需要集成云信聊天的人少走一些彎路虏缸,希望我的分享對你有所幫助。好了嫩实,廢話不多說刽辙,show time。
集成步驟及遇到的坑
首先甲献,到云信官網(http://netease.im/) 注冊一個賬號,當然如果你已經有賬號了宰缤,可以直接登錄即可。然后創(chuàng)建一個app,相信大家都已經使用過很多第三方了慨灭,所以在這里我就不再贅述創(chuàng)建app的過程了朦乏,最后強調一句,創(chuàng)建好app后需要聯(lián)系網易的技術人員開通云信聊天服務就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都有注冊的功能厢汹,在注冊成功一個賬號后,由后臺調取網易云信的相關接口谐宙,下發(fā)一個accid和云信的token,accid是云信ID烫葬,也稱為“用戶帳號”,在整個應用中都是唯一的凡蜻,在登錄和創(chuàng)建會話的時候會用到搭综,token是云信ID的密碼,用作登錄云信時使用划栓。我們稱每一次聊天為一個會話(即session對象)兑巾,初始化聊天界面時,上層需要傳入當前聊天界面對應的會話信息忠荞,即 NIMSession蒋歌,進行如下操作便可進入聊天界面
NIMSession *session = [NIMSession session:uid type:NIMSessionTypeP2P];
NIMSessionViewController *vc = [[NIMSessionViewController alloc] initWithSession:session];
[self.navigationController pushViewController:vc animated:YES];
聊天界面截圖如下:
因為項目中使用到了系統(tǒng)相機月匣,相冊,位置奋姿,和麥克風等信息,所以需要進行設置訪問權限素标,否則會崩潰,在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>
細心的朋友會發(fā)現(xiàn)控制臺一直輸出
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:@"位置"],
];
即可顯示圖片赏淌,如果想添加新的模塊踩寇,也可以在該方法中添加新的模塊,默認的是相冊六水,拍攝俺孙,和位置