?這里介紹IMKit開發(fā),在使用之前共苛,首先詳細閱讀融云提供的官方文檔判没,和視頻教程蜓萄。閱讀后,對融云有了一定的了解澄峰。??
1.前期準備??
注冊開發(fā)者賬號嫉沽,在融云開發(fā)者控制臺創(chuàng)建應(yīng)用,系統(tǒng)會自動分配生產(chǎn)換的App Key和App Secret俏竞。? 可以使用CocoaPods導入SDK绸硕,也可以選擇手動導入SDK,這里不詳細介紹方法魂毁,可以進入官方文檔查看詳情玻佩。??
2.快速集成IMKit??
初始化SDK
1.在使用融云SDK功能時,加入頭文件:#import <RongIMKit/RongIMKit.h>
2.通過AppKey初始化融云:[[RCIM sharedRCIM] initWithAppKey:@"AppKey"];
?3.獲取Token席楚,App通過Token值連接融云服務(wù)器咬崔。
?4.連接融云服務(wù)器
使用融云即使通訊,必須要連接融云服務(wù)器烦秩,可以將連接的過程放在App登錄用戶過程中垮斯,在此時連接融云可以確保用戶登錄后,可以使用融云即時聊天闻镶,也可以收到融云接收到回復信息甚脉。此時注意,App用戶登錄分為手動登錄與自動登錄铆农,需要在這兩處均連接融云服務(wù)器,為避免重復連接融云服務(wù)器狡耻,在連接時判定SDK的連接狀態(tài)墩剖。還有一點注意,在用戶退出登錄時夷狰,設(shè)置融云SDK斷開連接岭皂。
在 App 整個生命周期,只需要調(diào)用一次融云服務(wù)器建立連接沼头。之后無論是網(wǎng)絡(luò)出現(xiàn)異骋妫或者 App 有前后臺的切換等,SDK 都會負責自動重連进倍。除非已經(jīng)手動將連接斷開土至,否則不需要再手動重連。
下面的代碼為連接融云服務(wù)器的方法:
下面的圖片即為連接狀態(tài):
首先判定融云連接服務(wù)器狀態(tài)猾昆,避免重復連接融云服務(wù)器陶因,使用方法:
5.啟動聊天界面:
融云 IMKit 中已經(jīng)實現(xiàn)了完整的聊天界面,包含發(fā)送垂蜗、接收楷扬、更新等 UI解幽,并覆蓋常用的IM交互場景,您直接使用或繼承 RCConversationViewController烘苹,即可快速啟動和使用聊天界面躲株。若要自定義聊天界面,可以繼承RCConversationViewController镣衡。
6.啟動會話列表界面:
融云 IMKit 已經(jīng)實現(xiàn)了一個默認的會話列表視圖控制器霜定,您直接使用或繼承 RCConversationListViewController,即可快速啟動和使用會話列表界面捆探,若要自定義UI界面然爆,也可創(chuàng)建ChatListViewController,繼承于RCConversationListViewController黍图。
(1)創(chuàng)建會話列表ViewController
(2)點擊會話列表曾雕,進入聊天會話界面以上只是簡單的繼承融入,可以實現(xiàn)簡單的聊天助被。
以上只是簡單的繼承融入剖张,可以實現(xiàn)簡單的聊天,接下來介紹更多的功能揩环。
7.若要實現(xiàn)進入聊天列表時搔弄,列表中的顯示用戶信息,即用戶ID丰滑、頭像顾犹、昵稱,需要調(diào)用下圖方法褒墨。因為融云不維護和管理用戶的基本信息炫刷。因此,需要在本地存儲用戶數(shù)據(jù)郁妈,我使用SQLite將用戶的信息存儲在本地浑玛。
8.融云推送,實現(xiàn)圖標上顯示未讀消息條數(shù)噩咪,方法如下如:
9.推送聲音顾彰,來信息了顯示提示聲音,方法如下圖: