前言
因爲項目中用到了騰訊雲通信,網上雲通信IM的文章很少,所以我打算詳細寫一下,希望對大家有所幫助。
什麼是雲通信IM
雲通信 IM(Instant Messaging)承載億級 QQ 用戶即時通訊技術,數十年技術積累,騰訊云爲您提供超乎尋常即時通訊聊天服務。針對開發者的不同階段需求及不同場景,雲通信 IM 提供了一系列解決方案,包括: Android/iOS/Windows/Web 的 SDK 組件、服務端集成接口、第三方回調接口等,利用這些組件,可以在應用中構建自己的即時通訊產品,解決開發者面臨的高併發、高可用性的一系列問題。
首先我們要知道雲通信IM登錄流程,直接看下面圖:
不難看懂,說的簡單一點就是我們調後臺接口去獲取Identifier 與UserSig。
我們在測試階段可以 獲取測試 userSig,這點在下面會講到。
集成
一.配置
1.創建應用
2.配置應用-管理員
3.獲取UserSig
完成賬號管理員配置後,單擊下載公私鑰的鏈接,即可獲得一個名爲 keys.zip 的壓縮包。解壓後可以得到兩個文件,即 public_key 和 private_key,用記事本打開 private_key 文件,並將其中的內容拷貝到開發輔助工具的私鑰文本輸入框中。其中:identifier 即爲您的測試賬號(也就是 userId),私鑰爲 private_key 文件裏的文本內容,生成的簽名就是userSig。identifier 和 userSig 是一一對應的關係。
具體操作可以看下面網址:
https://cloud.tencent.com/doc...
Android-demo下載地址:
https://github.com/tencentyun...
二.集成SDK
在項目中添加 IM SDK 的依賴
dependencies {
api 'com.tencent.imsdk:imsdk:版本號'
}
版本號最好用當前最新的版本,我用的是4.3.118
dependencies {
api 'com.tencent.imsdk:imsdk:4.3.118'
}
TUIKit集成
TUIKit 是基於騰訊雲 IM SDK 的一款 UI 組件庫,裏面提供了一些通用的 UI 組件,開發者可通過該組件庫選取自己所需要的組件快速的搭建一個 IM 應用。
IM 軟件都具備一些通用的 UI 界面,如會話列表,聊天界面等。TUIKit 提供了這一類的組件,並提供了靈活的 UI 和交互擴展接口,方便用戶做個性化開發。
TUkit我們不一定要集成,只是說如何有需要的可以去集成
集成的方式:
- 直接依賴它的aar包
- 把aar源碼文件拷貝到咱們項目中
我建議用第二種方式,因爲TUkit視圖實在是過於簡潔,很大程度上我們都需要修改,而且功能上我們也要去修改,用aar包方式的話我們不能去更改文件。
如果有朋友對aar不瞭解,可以看我之前的文章:
https://mp.weixin.qq.com/s/_m...
基本操作
1.初始化
可以直接看官網址:
https://cloud.tencent.com/doc...
或者我們可以下載雲通信IM的demo,然後仿照它的初始化配置也可以的。
2.登錄
// identifier爲用戶名,userSig 爲用戶登錄憑證
TIMManager.getInstance().login(identifier, userSig, new TIMCallBack() {
@Override
public void onError(int code, String desc) {
//錯誤碼 code 和錯誤描述 desc,可用於定位請求失敗原因
//錯誤碼 code 列表請參見錯誤碼錶
Log.d(tag, "login failed. code: " + code + " errmsg: " + desc);
}
@Override
public void onSuccess() {
Log.d(tag, "login succ");
}
});
先講到這裏,希望對大家有幫助,下節講一下具體的功能!
想多瞭解的朋友可以加我的微信,交個朋友:lengquele5311
大家可以關注我的微信公衆號:「秦子帥」一個有質量、有態度的公衆號!