融云sdk v5.2.2

融云sdk是國(guó)內(nèi)首家專業(yè)的即時(shí)通訊云服務(wù)提供商，專注為互聯(lián)網(wǎng)、移動(dòng)互聯(lián)網(wǎng)開(kāi)發(fā)者提供即時(shí)通訊基礎(chǔ)能力和云端服務(wù)。通過(guò)融云平臺(tái)，開(kāi)發(fā)者不必搭建服務(wù)端硬件環(huán)境，就可以將即時(shí)通訊、實(shí)時(shí)網(wǎng)絡(luò)能力快速集成至應(yīng)用中。目前軟件擁有android、ios和web三大版本，本次小編這里提供的是針對(duì)android平臺(tái)而開(kāi)發(fā)的融云sdk穩(wěn)定版，包括VoIP。

融云即時(shí)通訊云，專注為App開(kāi)發(fā)者提供IM云服務(wù)，針對(duì)開(kāi)發(fā)者所需的不同場(chǎng)景，融云平臺(tái)提供了一系列產(chǎn)品、技術(shù)解決方案，包括：客戶端 IM 組件，客戶端 IM 基礎(chǔ)庫(kù)，服務(wù)端 REST API，客戶端實(shí)時(shí)網(wǎng)絡(luò)通訊基礎(chǔ)庫(kù)等。利用這些解決方案，開(kāi)發(fā)者可以直接在自己的應(yīng)用中構(gòu)建出即時(shí)通訊產(chǎn)品，也可以無(wú)限創(chuàng)意出自己的即時(shí)通訊場(chǎng)景。

使用教程

一、注冊(cè)開(kāi)發(fā)者帳號(hào)

請(qǐng)前往 融云官方網(wǎng)站 注冊(cè)開(kāi)發(fā)者帳號(hào)。注冊(cè)時(shí)，您需要提供真實(shí)的郵箱和手機(jī)號(hào)，以方便我們向您發(fā)送重要通知并在緊急時(shí)刻能夠聯(lián)系到您。如果您沒(méi)有提供正確可用的郵箱和手機(jī)號(hào)，我們隨時(shí)可能關(guān)閉您的應(yīng)用。

二、下載 SDK

SDK 下載包中分為如下兩部分：

融云 IM 界面組件 - RongCloud IMKit （包含 IMLib）

融云 IM 通訊能力庫(kù) - RongCloud IMLib

好的，下載應(yīng)該已經(jīng)開(kāi)始了，您可以在下載過(guò)程中繼續(xù)向下閱讀。

首先，讓我們先創(chuàng)建您的第一個(gè)應(yīng)用吧！

創(chuàng)建應(yīng)用

您要進(jìn)行應(yīng)用開(kāi)發(fā)之前，需要先在融云開(kāi)發(fā)者平臺(tái)創(chuàng)建應(yīng)用。如果您已經(jīng)注冊(cè)了融云開(kāi)發(fā)者帳號(hào)，請(qǐng)前往 融云開(kāi)發(fā)者平臺(tái) 創(chuàng)建應(yīng)用；如果您還沒(méi)有注冊(cè)融云開(kāi)發(fā)者帳號(hào)，請(qǐng)前往 融云官方網(wǎng)站 首先注冊(cè)開(kāi)發(fā)者帳號(hào)，注冊(cè)后創(chuàng)建應(yīng)用。

您創(chuàng)建完應(yīng)用后，最需要了解的就是 App Key / Secret，它們是融云 SDK 連接服務(wù)器所必須的標(biāo)識(shí)，每一個(gè) App 對(duì)應(yīng)一套 App Key / Secret。針對(duì)開(kāi)發(fā)者的生產(chǎn)環(huán)境和開(kāi)發(fā)環(huán)境，我們提供兩套 App Key / Secret，您在應(yīng)用最終上線前，使用開(kāi)發(fā)環(huán)境即可，兩套環(huán)境的功能完全一致。

開(kāi)發(fā)環(huán)境 App Key / Secret 是專門為您提供的僅供開(kāi)發(fā)使用的，開(kāi)發(fā)環(huán)境將和生產(chǎn)環(huán)境的數(shù)據(jù)隔離，避免開(kāi)發(fā)環(huán)境數(shù)據(jù)和線上生產(chǎn)環(huán)境數(shù)據(jù)互相沖突。在“開(kāi)發(fā)環(huán)境”分類下，您可以找到開(kāi)發(fā) App Key / Secret。您在申請(qǐng)上線前可以一直使用開(kāi)發(fā)環(huán)境的 App Key / Secret 開(kāi)發(fā)。 

生產(chǎn)環(huán)境的 App Key / Secret 默認(rèn)先不提供，等您提交上線后，我們會(huì)提供生產(chǎn)環(huán)境的 App Key / Secret。 

Token 有效期默認(rèn)為永久有效，也可以設(shè)置有效期，這有助于提高您 App 的安全性，具體請(qǐng)參考 Server 開(kāi)發(fā)文檔。

開(kāi)發(fā)準(zhǔn)備

以下文檔將向大家介紹 IMKit 界面組件的開(kāi)發(fā)方法。

我們的 SDK 最低支持到 Android API 9: Android 2.3(Gingerbread)，請(qǐng)您在構(gòu)建項(xiàng)目時(shí)注意。

1、引用文件

將官網(wǎng)下載的 Rong_Cloud_Android_SDK_vx_x_x.zip 包解壓到任意目錄。解壓后您得到的是一個(gè)項(xiàng)目，將 "IMKit" 項(xiàng)目拷貝到您的項(xiàng)目中，然后在您的項(xiàng)目中添加對(duì) "IMKit" 項(xiàng)目的依賴即可。

2、修改 AndroidManifest 文件

添加配置和 App Key

修改您的 AndroidManifest.xml 文件，將包中提供的 AndroidManifest.xml 相關(guān)配置寫入您的 AndroidManifest.xml。

您需要在 AndroidManifest.xml 中配置 App Key，

修改 android:host 屬性

請(qǐng)找到您的 AndroidManifest.xml 文件中的 android:host 屬性，修改為您的 中 package 的屬性值，也就是您自己應(yīng)用的包名。

請(qǐng)務(wù)必注意修改 android:host 屬性，否則程序?qū)o(wú)法正常運(yùn)行。

3、修改 build.gradle 文件

如果您使用的 IDE 是 Android Studio，您還需要修改下 build.gradle 文件，以便編譯時(shí)將 .so 文件拷貝到相關(guān)目錄。

如果您使用的是 Eclipse / ADT / IntelliJ IDEA，請(qǐng)忽略此節(jié)。

功能介紹

1、單聊

提供文字、表情、語(yǔ)音片段、圖片、VoIP 等多種輸入內(nèi)容，解決 App 內(nèi)用戶的溝通瓶頸。

- 會(huì)話界面、會(huì)話列表、好友列表，三個(gè)頁(yè)面適應(yīng)多種使用場(chǎng)景

- 支持 UI 界面的自定義配置，完美整合在 App 中

2、討論組

支持用戶創(chuàng)建多人討論組，滿足 App 內(nèi)用戶進(jìn)行多人聊天的需求。

- 用戶自組建多人討論組

- 會(huì)話設(shè)置界面，完善 App 的體驗(yàn)細(xì)節(jié)

3、群組

基于已有多人好友關(guān)系創(chuàng)建的多人聊天服務(wù)，滿足 App 內(nèi)群體性實(shí)時(shí)交流需求。

- 支持 3000 人的大型社群需求

- 基于 App 自身群組的用戶關(guān)系，無(wú)縫融合

4、聊天室

多人在線實(shí)時(shí)聊天服務(wù)，無(wú)上限人數(shù)同時(shí)在線支持，增加 App 內(nèi)直播、討論的互動(dòng)性，提升人氣。

- 完善的管理員權(quán)限 API

- 無(wú)上限人數(shù)聊天室，即時(shí)顯示在線人數(shù)

- 多種樣式方案，支持不同場(chǎng)景

5、VoIP

基于 IP 網(wǎng)絡(luò)的點(diǎn)對(duì)點(diǎn)語(yǔ)音通話服務(wù)，可在二人會(huì)話內(nèi)使用或直接喚起，實(shí)現(xiàn)實(shí)時(shí)語(yǔ)音交流。

- 基于互聯(lián)網(wǎng)的點(diǎn)對(duì)點(diǎn)實(shí)時(shí)語(yǔ)音通話

- 自有技術(shù)，保障優(yōu)質(zhì)的通話質(zhì)量

- 適應(yīng)不同網(wǎng)絡(luò)環(huán)境，智能調(diào)節(jié)通話方式