融云sdk v5.2.2官方版

融云sdk是国内首家专业的即时通讯云服务提供商，专注为互联网、移动互联网开发者提供即时通讯基础能力和云端服务。通过融云平台，开发者不必搭建服务端硬件环境，就可以将即时通讯、实时网络能力快速集成至应用中。目前软件拥有android、ios和web三大版本，本次小编这里提供的是针对android平台而开发的融云sdk稳定版，包括VoIP。

融云即时通讯云，专注为App开发者提供IM云服务，针对开发者所需的不同场景，融云平台提供了一系列产品、技术解决方案，包括：客户端 IM 组件，客户端 IM 基础库，服务端 REST API，客户端实时网络通讯基础库等。利用这些解决方案，开发者可以直接在自己的应用中构建出即时通讯产品，也可以无限创意出自己的即时通讯场景。

使用教程

一、注册开发者帐号

请前往 融云官方网站 注册开发者帐号。注册时，您需要提供真实的邮箱和手机号，以方便我们向您发送重要通知并在紧急时刻能够联系到您。如果您没有提供正确可用的邮箱和手机号，我们随时可能关闭您的应用。

二、下载 SDK

SDK 下载包中分为如下两部分：

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

融云 IM 通讯能力库 - RongCloud IMLib

好的，下载应该已经开始了，您可以在下载过程中继续向下阅读。

首先，让我们先创建您的第一个应用吧！

创建应用

您要进行应用开发之前，需要先在融云开发者平台创建应用。如果您已经注册了融云开发者帐号，请前往 融云开发者平台 创建应用；如果您还没有注册融云开发者帐号，请前往 融云官方网站 首先注册开发者帐号，注册后创建应用。

您创建完应用后，最需要了解的就是 App Key / Secret，它们是融云 SDK 连接服务器所必须的标识，每一个 App 对应一套 App Key / Secret。针对开发者的生产环境和开发环境，我们提供两套 App Key / Secret，您在应用最终上线前，使用开发环境即可，两套环境的功能完全一致。

开发环境 App Key / Secret 是专门为您提供的仅供开发使用的，开发环境将和生产环境的数据隔离，避免开发环境数据和线上生产环境数据互相冲突。在“开发环境”分类下，您可以找到开发 App Key / Secret。您在申请上线前可以一直使用开发环境的 App Key / Secret 开发。 

生产环境的 App Key / Secret 默认先不提供，等您提交上线后，我们会提供生产环境的 App Key / Secret。 

Token 有效期默认为永久有效，也可以设置有效期，这有助于提高您 App 的安全性，具体请参考 Server 开发文档。

开发准备

以下文档将向大家介绍 IMKit 界面组件的开发方法。

我们的 SDK 最低支持到 Android API 9: Android 2.3(Gingerbread)，请您在构建项目时注意。

1、引用文件

将官网下载的 Rong_Cloud_Android_SDK_vx_x_x.zip 包解压到任意目录。解压后您得到的是一个项目，将 "IMKit" 项目拷贝到您的项目中，然后在您的项目中添加对 "IMKit" 项目的依赖即可。

2、修改 AndroidManifest 文件

添加配置和 App Key

修改您的 AndroidManifest.xml 文件，将包中提供的 AndroidManifest.xml 相关配置写入您的 AndroidManifest.xml。

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

修改 android:host 属性

请找到您的 AndroidManifest.xml 文件中的 android:host 属性，修改为您的 中 package 的属性值，也就是您自己应用的包名。

请务必注意修改 android:host 属性，否则程序将无法正常运行。

3、修改 build.gradle 文件

如果您使用的 IDE 是 Android Studio，您还需要修改下 build.gradle 文件，以便编译时将 .so 文件拷贝到相关目录。

如果您使用的是 Eclipse / ADT / IntelliJ IDEA，请忽略此节。

功能介绍

1、单聊

提供文字、表情、语音片段、图片、VoIP 等多种输入内容，解决 App 内用户的沟通瓶颈。

- 会话界面、会话列表、好友列表，三个页面适应多种使用场景

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

2、讨论组

支持用户创建多人讨论组，满足 App 内用户进行多人聊天的需求。

- 用户自组建多人讨论组

- 会话设置界面，完善 App 的体验细节

3、群组

基于已有多人好友关系创建的多人聊天服务，满足 App 内群体性实时交流需求。

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

- 基于 App 自身群组的用户关系，无缝融合

4、聊天室

多人在线实时聊天服务，无上限人数同时在线支持，增加 App 内直播、讨论的互动性，提升人气。

- 完善的管理员权限 API

- 无上限人数聊天室，即时显示在线人数

- 多种样式方案，支持不同场景

5、VoIP

基于 IP 网络的点对点语音通话服务，可在二人会话内使用或直接唤起，实现实时语音交流。

- 基于互联网的点对点实时语音通话

- 自有技术，保障优质的通话质量

- 适应不同网络环境，智能调节通话方式