這兩天集成環(huán)信移動客服误澳,卡在了沒有設(shè)置發(fā)送對象,這個他在文檔里也沒有寫秦躯,因此貼出來記錄一下忆谓。
首先第一步就是sdk集成和環(huán)境配置了,這個看文檔就好踱承,小白操作了:
文檔地址:
iOS SDK 介紹及導(dǎo)入 [環(huán)信開發(fā)文檔]
第二步注冊開發(fā)者賬號倡缠,關(guān)聯(lián)相關(guān)的appkey哨免,這部分文檔也寫得很清楚,照他寫的做基本是不會錯的
文檔地址:APP渠道集成 [環(huán)信開發(fā)文檔]
第三步集成單聊界面昙沦,將sdk里面的ChatView琢唾、EaseUI、EaseUIResource.bundle盾饮、HyphenateSDK(我集成的是3.x)采桃、Resource、emotion(兔斯基的表情包)等文件拖進去丘损,不過他sdk里面有些文件有重名普办,所以需要跟著視頻一起集成,視頻可以看最新的那個徘钥,包含2.x到3.x等版本的集成衔蹲,懶惰的人也可以直接拿我的demo使用就好。
視頻地址:視頻列表 - imGeek開發(fā)者社區(qū)
然后說說集成文件里面的chatView呈础,這個文件夾里面有一個chatViewController舆驶,這個就是單聊界面,你只要在你需要跳轉(zhuǎn)的地方用代碼push過去就可以了而钞,但是push前需要傳遞相關(guān)im賬戶沙廉,也就是你關(guān)聯(lián)appkey時所使用的im賬戶(接收你發(fā)送消息的對象),代碼如下:
//參數(shù)一:對應(yīng)的im賬戶笨忌,若是群聊則改為組id
//參數(shù)二:聊天類型(個人和組)
ChatViewController*chatVC = [[ChatViewControlleralloc]initWithConversationChatter:@"alen"conversationType:EMConversationTypeChat];
chatVC.title=@"客服中心";
[self.navigationControllerpushViewController:chatVCanimated:YES];
你也可以在chatViewController里面設(shè)置更改聊天氣泡蓝仲,圖片之類的俱病,就在方法
viewDidLoad里面的那幾個appearance屬性官疲。
然后關(guān)于拓展消息這部分,擴展消息可以發(fā)送用戶配置信息亮隙,諸如手機位置等信息途凫,他的調(diào)用被放置于EaseMessageViewController類里面,調(diào)用方法如下
- (void)sendTextMessage:(NSString*)text
可以在該方法內(nèi)抒寫拓展信息ext溢吻,拓展信息為字典寫法维费,示例如下:
- (void)sendTextMessage:(NSString*)text
{
NSUserDefaults*user = [NSUserDefaultsstandardUserDefaults];
NSString*phone = [userobjectForKey:@"userId"] ==nil?@"":[userobjectForKey:@"userId"];
NSString*trueName = [userobjectForKey:@"realName"] ==nil?@"":[userobjectForKey:@"realName"];
NSString*address = [userobjectForKey:@"address"] ==nil?@"":[userobjectForKey:@"address"];
NSDictionary*ext =@{
@"weichat":@{
@"visitor":@{
@"trueName":trueName,
@"description":address,
@"phone":phone
}
}
};
[selfsendTextMessage:textwithExt:ext];
}
大致的集成就是這樣了,然后一般放到項目里的話肯定會報很多莫名奇妙的錯誤促王,比如我的項目是用cordova框架進行h5與ios混編犀盟,居然報了一個block的語法錯誤,通篇置換才沒事.
還有一個duplicatesymbol的錯誤蝇狼,這個也很經(jīng)常出現(xiàn)阅畴,錯誤發(fā)生在引用庫的問題上,一般是我上面提到的EaseUI文件里面的lib文件夾迅耘,里面會有兩個.a文件贱枣,刪掉一個就好监署,這個在視頻里面會講,如果還報錯誤的話纽哥,就是第三方庫的問題了钠乏,我的做法是直接刪掉換了一個類似的,其中有個我們比較常用的 MJRefresh,這個庫他本身就添加引用了春塌,版本較老晓避,因此我的做法是直接把自己添加的給刪掉了,用它的就好摔笤。
下面放上demo地址够滑,環(huán)信的集成體積比較大,不過后期打包軟件后會自動縮水: