軟件特色
IM 界面組件 - IMKit
IMKit 是融云 SDK 的核心特色之一。融云將即時通訊產品中最復雜的會話列表、聊天窗口、消息內容展現、會話設置等功能封裝為組件,通過簡短的代碼,您就可以直接將以上界面集成到您的 App 產品中,省去大量的開發調試時間。融云同時支持業內最豐富的自定義界面組件功能,您可以針對自己界面需求自由設計開發。
IMKit 的核心類在 Android 平臺是 RongIM,在 iOS 平臺是 RCIM,這兩個類在今后的開發中和 IMKit 代表相同的意義。
IM 通訊能力庫 - IMLib
IMLib 是不含界面的基礎 IM 通訊能力庫,封裝了通信能力和會話、消息等對象。引用到 App 工程中后,需要開發者自己實現 UI 界面,相對較輕量,適用于對 UI 有較高訂制需求的開發者。
IMLib 的核心類在 Android 平臺是 RongIMClient,在 iOS 平臺是 RCIMClient,這兩個類在今后的開發中和 IMLib 代表相同的意義。
融云的集成流程如下圖所示,其中幾個關鍵環節需要注意:
App 服務端換取 Token 流程,可以參考 Server 開發文檔 - 獲取 Token 方法
客戶端集成流程,可以參考 Android 開發指南 或者 iOS 開發指南
UI 界面自定義,可以參考 Android 開發指南 - UI 自定義 或者 iOS 開發指南 - UI 自定義
功能介紹
單聊
指兩個用戶一對一進行聊天,會話關系由融云負責建立并保持,退出聊天界面或者離線后可以收到推送通知。
討論組
指兩個以上用戶一起進行聊天,用戶可以自行添加好友生成一個討論組聊天,會話關系由融云負責建立并保持,退出聊天界面或者離線后可以收到推送通知。
群組聊天
指兩個以上用戶一起進行聊天,與討論組不同的是,參與群組聊天的群成員 Id 集合由您的 App 提供并維系,融云只負責將消息傳達給群聊中的所有用戶,退出聊天界面或者離線后可以收到推送通知。支持最大至 3000 人的大型社群需求。
聊天室
不設用戶上限的群體聊天行為,用戶退出聊天界面即視為離開聊天室,不再會接收到任何通知和提醒。會話關系由融云負責建立并保持連接,通過 SDK 相關接口,可以讓用戶加入或者退出聊天室。
客服消息
用戶與您的 App 后臺客服進行消息通訊,支持單客服和多客服。
VoIP 音頻通話
指通過 IP 網絡,使兩個用戶建立一對一的音頻通話。
會話列表
指各種會話依照順序先后排列的界面,其中會話列表中的每一個列表項稱之為一條會話。排列的先后順序會依賴于置頂、最新會話、未讀會話和時間等因素
使用指南
要進行應用開發之前,需要先在融云開發者平臺創建應用。如果您已經注冊了融云開發者帳號,請前往 融云開發者平臺 創建應用。
您創建完應用后,首先需要了解的是 App Key / Secret,它們是融云 SDK 連接服務器所必須的標識,每一個 App 對應一套 App Key / Secret。針對開發者的生產環境和開發環境,我們提供兩套 App Key / Secret,兩套環境的功能完全一致。您在應用最終上線前,使用開發環境即可。
image
App Key / Secret 位置
開發環境 App Key / Secret 是專門為您提供的僅供開發使用的,開發環境將和生產環境的數據隔離,避免開發環境數據和線上生產環境數據互相沖突。
生產環境的 App Key / Secret 默認先不提供,等您提交上線后,我們會提供生產環境的 App Key / Secret。
4、獲取 Token
Token 稱為用戶令牌,App Key 是您的 App 的唯一標識,Token 則是您 App 上的每一個用戶的身份授權象征。您可以通過提交 userId 等信息來獲得一個該用戶對應的 Token,并使用這個 Token 作為該用戶的唯一身份憑證與其他用戶進行通信。
Token 的主要作用是身份授權和安全,因此不能通過客戶端直接訪問融云服務器獲取 Token,您必須通過 Server API 從融云服務器 獲取 Token 返回給您的 App,并在之后連接時使用。詳細描述請參考 Server 開發指南 中的用戶服務和獲取 Token 方法小節。
為了方便您在集成和測試過程中使用,我們還提供了 API 調試工具,在您不能部署服務器程序時,可以直接通過傳入 userId 和 name 來獲得 Token。請訪問 融云開發者平臺,打開您想測試的應用,在左側菜單中選擇“API 調試”即可。
userId : 每一個用戶對應一個 userId,這個 userId 是您維護的,所以您可以直接賦值,兩個您的的用戶通信,對于融云來說就是兩個 userId 間通訊。
name : 用戶的顯示名稱,用來在 Push 推送時,或者您沒有傳入用戶信息時,默認顯示的用戶名稱。
portraitUri : 用戶頭像,用來當您沒有傳入用戶信息時作為默認頭像,如果圖片不存在,IMKit 會顯示默認頭像。
通過 API 調試,您可以得到一個 Token 返回值。你就可以直接使用這個 Token 為這位用戶進行發送和接受消息。
您的評論需要經過審核才能顯示
有用
有用
有用