融雲SDK v2.3.3官方版

融雲SDK安卓版的是一款安卓應用的開發源件，融雲 SDK針對了開發者所需的不同需要提供了一係列的技術解決方案，例如客戶端 IM 組件，客戶端 IM 基礎庫，Web SDK，服務端 REST API 等，利用這些解決方案開發者可以在應用中構建自己的產品

軟件特色

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 為這位用戶進行發送和接受消息。