一：準備工作
1、集成流程
(1)注冊成為云通訊平臺用戶。
(2)登陸云通訊平臺，進入管理控制臺，創(chuàng)建自己的應用。
(3)下載云通訊Android SDK，根據(jù)開發(fā)指南進行編碼實現(xiàn)。
2、前期準備
(1)注冊成為云通訊的用戶
(2)登陸云通訊平臺，進入管理控制臺，創(chuàng)建自己的應用。在創(chuàng)建IM類應用的時候，只需填寫應用名稱，不必選擇"啟用應用回調(diào)地址"、"啟用IVR"、"啟用TTS"、"服務器白名單"等選項。
(3)應用創(chuàng)建成功后，在"應用列表"里面可以看見自己剛剛創(chuàng)建的應用，可以對該應用進行編輯和刪除操作。當該應用集成完云通訊IM能力后準備正式對外發(fā)布時，需要點擊"上線"。
注意：使用5.0以上的SDK集成客戶端，測試音視頻、音視頻會議、群組等需要先將在我們控制臺對應的應用上線，才可以進行測試。
3、核心概念
(1)生產(chǎn)環(huán)境：對應的接入域名為：https://app.cloopen.com:8883
(2)開發(fā)者主賬號：每個開發(fā)者在云通訊平臺對應一個主賬號
(a)ACCOUNT SID：主賬號id。
(b)AUTH TOKEN：主賬號驗證token。
(3)AppID：應用標識，每個創(chuàng)建的應用都對應唯一的id標識。
(4)子賬號：每個App用戶在云通訊對應一個子賬號，包括賬號id和驗證token，用于安全性驗證。
(5)通訊賬號：通訊賬號主要用于云通訊平臺的語音通訊能力，每個子賬號都對應一個通訊賬號，由系統(tǒng)自動生成。
說明：
每一個注冊開發(fā)者對應一個主賬號。
每一個主賬號下可以創(chuàng)建多個應用。
每一個應用下面可以創(chuàng)建億級子賬號。
每一個子賬號對應一個通訊賬號。
二：使用介紹
1、云通訊IM 賬號體系
為了方便開發(fā)者進行開發(fā)和兼容IM4.0以前版本，云通訊支持兩種賬號體系。
（1）固定子賬號體系(即通訊賬號+通訊密碼登錄方式)：開發(fā)者需要自己調(diào)用創(chuàng)建子賬號接口 ，為app的用戶創(chuàng)建對應的云通訊通訊賬號，并將通訊賬號和用戶id進行綁定，通訊密碼和用戶密碼進行綁定，登錄 的時候必須用云通訊通訊賬號和通訊密碼登錄。
說明：固定子賬號體系在所有IM版本中都支持，需要注意的是4.0之前的版本登錄需要使用子賬號，子賬號密碼，通訊賬號，通訊密碼進行登 錄，5.0的固定子賬號體系，直接用通訊賬號和通訊密碼就可以。如果要在demo中測試加密碼登錄方式，需要先在官網(wǎng)控制臺創(chuàng)建自己的應 用，然后將demo默認的應id和token替換成自己創(chuàng)建的應用的，登錄的通訊賬號和密碼，需要是該應用下創(chuàng)建的通訊賬號和密碼。
Android中替換應用id和token的地方是ECPreferenceSettings類，ios 是在AppConfig.plst文件中修改，demo中的appkey就是用戶在控制臺創(chuàng)建的應用的appid。
（2）任意子賬號體系(即自定義登錄方式)：用戶不必自己在云通訊后臺為用戶創(chuàng)建云通訊子賬號，可以直接使用用戶自己開發(fā)的App中的賬號進行登錄，該登錄方式我們不驗證密碼。用戶在集成的過程中，可以自己實現(xiàn)對自己登錄賬號密碼的驗證。
說明：任意子賬號體系在IM5.0以后的版本中支持，登錄的用戶名，不能包含中文，特殊符號，不能以g或者gg開頭，建議在5-20位之間。
2、登錄流程
對應賬號體系，登錄云通訊也有兩種驗證方式：
? 賬號和密碼驗證方式：在登錄的時候，輸入云通訊的通訊賬號和對應的通訊密碼即可登錄。
使用此種登陸方式，在app用戶注冊的時候，需要同時向云通訊后臺注冊，如圖所示：
使用此種登陸方式，登陸流程如圖所示：
? 賬號和appId，appToken驗證方式：此種方式登陸無需使用云通訊子賬號，直接使用app的自有賬號登陸即可，appID和appToken可以在官網(wǎng)的"控制臺"相關應用的描述頁面得到，此種方式的登陸流程如圖所示：
3、業(yè)務指南
3.1、業(yè)務指南
兩個用戶一對一進行聊天，支持文本、表情、語音、圖片、附件5種消息格式。支持已發(fā)送（指消息已經(jīng)發(fā)送到服務端）回執(zhí)。
3.2、群組
兩個以上用戶一起聊天。支持文本、表情、語音、圖片、附件5種消息格式。同樣也支持已發(fā)送回執(zhí)。
3.3、群組操作
支持創(chuàng)建群組、主動加入群組、邀請加入群組、成員主動退出群組、群主解散群組、群主踢人、設置消息免打擾操作。
群組又分為私有群組和公開群組。私有群組是指主動加入時必須經(jīng)管理員同意才能加入的群組，公開群組是指主動加入時無需經(jīng)管理員同意就能加入的群組。
3.4、離線消息
指用戶不在線時候，有人給其發(fā)送消息，此時消息存儲在服務端，當用戶再上線時，從服務端獲取這些之前未收到的消息。
3.5、設備推送
用戶不在線時，有人給其發(fā)送消息，服務端會給用戶設置發(fā)送推送通知。用戶可以選擇查看通知喚起應用，此時消息會被獲取到。也可以選擇忽略，此時消息變成離線消息。
注意：為了使在推送通知里面顯示的是用戶昵稱而不是用戶的賬號ID，用戶需要調(diào)用設置個人信息接口來設置用戶的昵稱。
Ios支持離線推送，離線推送是通過蘋果的apns推送實現(xiàn)的，需要自己上傳推送證書，請參考“iOS推送證書”文檔，Android沒有離線推送一說，當前最新版本支持在調(diào)用登出接口后，通過廣播實現(xiàn)消息通知。
3.6、自定義消息
可以通過自定義消息發(fā)送指令來實現(xiàn)一些擴展功能。如消息已經(jīng)送達，消息已讀，位置分享、閱后即焚……。
4、體系架構
4.1技術特點
容聯(lián)IM通訊云服務，聚焦于"場景·連接"服務，幫助開發(fā)構建更完整的產(chǎn)品體驗。
容聯(lián)IM通訊云的主要技術特點有：
1、無需更改App原有框架和App Server架構，集成sdk接口即可實現(xiàn)IM通訊能力。
2、采取無DNS設計，實現(xiàn)快速登錄體驗。
3、自適應網(wǎng)絡和最小心跳包相結合的心跳技術，消耗更少電量。
4、采取特有的二進制協(xié)議和包體精簡、包體壓縮、智能多包合并策略實現(xiàn)最小流量包和最快的收發(fā)速度。
5、參考微信、陌陌的系統(tǒng)設計方案，采取真正的push-pull系統(tǒng)架構，保證不丟消息、有序到達以及弱網(wǎng)絡環(huán)境下的消息接收。
4.2第三方應用和云通訊IM云交互示意圖：
如圖：
藍色應用為開發(fā)者開發(fā)的App和開發(fā)者的后臺服務器，后臺服務器實現(xiàn)開發(fā)者自己的業(yè)務邏輯和保存自己的私有數(shù)據(jù)。綠色為容聯(lián)IM通訊云，紅色為容聯(lián)IM的sdk。
藍色空心箭頭為開發(fā)者app和自己的后臺服務器進行信令及業(yè)務交互，藍色箭頭為開發(fā)者App,黃色箭頭表示App server通過RESTFUL API接口的方式調(diào)用容聯(lián)云的服務，如獲取歷史消息，廣播消息等。
4.3 SDK 體系結構：
如圖：
容聯(lián)IM SDK是一個能力庫，提供各種IM相關的接口，包括Yuntx_IMLib 和LibCore兩部分。Yuntx_IMLib采取Native語言開發(fā)，封裝各種消息結構和能力結構。LibCore是核心IM SDK的核心協(xié)議棧，主要處理特有的二進制協(xié)議和傳輸層協(xié)議，采取c語言開發(fā)。iOS和Android采取同一套LibCore，保證消息處理的一致性。
1、Android 類結構：
ECDevice 是IM sdk的核心類，包括：
(1)方法集：主要有登陸方法，登出方法，設置個人信息方法，獲取個人信息方法，以及獲取群組管理和IM聊天管理接口
(2)ECChatManager包含IM聊天相關接口以及回調(diào)接口的定義
(3)ECGroupManager包含群組管理接口以及回調(diào)接口的定義
(4)ECVoIPCallManager包含音視頻通訊接口以及相應的回調(diào)接口的定義
(5)ECMeetingManager包含實時對講接口，語音會議接口，視頻會議接口以及相應的回調(diào)接口的定義
2、iOS 類結構：
ECDevice 是IM sdk的核心類，包括：
(1)方法集：主要有登陸方法，登出方法，設置個人信息方法，獲取個人信息方法。
(2)MessageManager實例：包括GroupManager，處理群組的相關功能，ChatManager處理聊天的相關消息
(3)ECVoIPCallManager實例：包含音視頻通訊接口以及相應的回調(diào)接口的定義
(4)ECMeetingManager實例：包含實時對講接口，語音會議接口，視頻會議接口以及相應的回調(diào)接口的定義
(5)Delegate：通知回調(diào)接口集：包括ECChatDelegate通知回調(diào)接口集，ECBaseDelegate登錄、登出回調(diào)接口集，ECGroupDelegate群組管理通知回調(diào)接口集，ECVoIPCallDelegate音視頻功能通知回調(diào)接口集，ECMeetingDelegate音視頻會議功能回調(diào)接口集。
3、消息類結構：
ECMessage是消息基類，ECMessageBody是抽象的消息內(nèi)容類,包括：
(1)ECTextMessageBody：文本消息內(nèi)容類。
(2)ECFileMessageBody：附件消息內(nèi)容類，同事時也是多媒體消息內(nèi)容基類，分別是：
1.ECVoiceMessageBody:語音消息內(nèi)容類。
2.ECVideoMessageBody:視頻消息內(nèi)容類。
3.ECImageMessageBody:圖片消息內(nèi)容類。