融云SDKv2.8.0官方版

融云SDK Android版是一款Android应用程序的开发源码软件。融云SDK针对开发者的不同需求提供了一系列的技术解决方案，如客户端IM组件、客户端IM基础库、WebSDK、服务端REST API等，开发者可以利用这些解决方案在应用中构建自己的产品。

融云SDK Android版是一款Android应用程序的开发源码软件。融云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交换流程请参考服务器开发文档-获取Token方法

客户端集成流程请参考Android开发指南或iOS开发指南

UI界面定制请参考Android开发指南-UI定制或iOS开发指南-UI定制

特征

私人聊天

它指的是两个用户一对一的聊天。会话关系由容云建立和维护。退出聊天界面或离线后，您可以收到推送通知。

讨论组

它指的是两个或多个用户一起聊天。用户可以添加好友，生成讨论群聊天。荣云负责建立和维护会话关系。退出聊天界面或离线后，您可以收到推送通知。

群聊

指两个或多个用户一起聊天。与讨论组不同，参与群聊的群组成员ID 集由您的App 提供和维护。融云只负责将消息传达给群聊中的所有用户并退出聊天。您可以在界面或离线状态下接收推送通知。支持最多3,000 人的大型社区的需求。

聊天室

对于无人数限制的群聊，用户退出聊天界面即视为离开聊天室，将不再收到任何通知或提醒。荣云负责建立和维护会话关系。通过SDK相关接口，用户可以加入或退出聊天室。

客服留言

用户通过消息与您的App后台客服沟通，支持单客服和多客服。

VoIP 音频通话

指使两个用户通过IP网络建立一对一的音频通话。

对话列表

指各个会话按顺序排列的界面，其中会话列表中的每个列表项称为一个会话。排序顺序将取决于固定的、最新的对话、未读的对话和时间等因素。

用户指导

在开发应用程序之前，您需要在融云开发者平台上创建一个应用程序。如果您已经注册了融云开发者账号，请前往融云开发者平台创建应用。

创建应用程序后，您需要知道的第一件事是应用程序密钥/秘密。是融云SDK连接服务器的必要标识。每个App对应一组App Key/Secret。针对开发者的生产环境和开发环境，我们提供了两套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，供后续连接时使用。详细说明请参见《服务器开发指南》中的用户服务和Token获取方式章节。

为了方便您在集成和测试过程中使用，我们还提供了API调试工具。当无法部署服务端程序时，可以通过传入userId和name直接获取Token。请访问融云开发者平台，打开您要测试的应用程序，在左侧菜单中选择“API调试”。

userId：每个用户对应一个userId。这个userId是你自己维护的，所以你可以直接分配。你的两个用户之间的通信对于融云来说就是两个userId之间的通信。

name：用户的显示名称，用于推送时或者不传入用户信息时默认显示用户名。

PortraitUri：用户头像，不传入用户信息时作为默认头像。如果图片不存在，IMKit会显示默认头像。

通过API调试，可以得到一个Token返回值。您可以直接使用该Token为该用户发送和接收消息。