Java IM环信服务端集成之创建应用(一)

移动端用户注册 VS 环信IM创建应用

环信即时通讯云V3.0

---

环信简介

环信成立于2013年4月，是一家国内领先的企业级软件服务提供商，于2016年荣膺“Gartner 2016 Cool Vendor”。产品包括国内上线最早规模最大的即时通讯云平台——环信即时通讯云，以及移动端最佳实践的全媒体智能云客服平台——环信客户互动云。

环信即时通讯云 V3.0

环信即时通讯云是全球最大的即时通讯云 PaaS 平台。V3.0 版本对 SDK 和通讯协议进行了全面深度的改造与优化：

• 全新的通信协议：全新的基于消息同步的私有协议，在不稳定网络环境下更稳定更省流量，确保消息投递的可靠、顺序以及实时性，并具有更高的安全性。同时提供了更好的扩展性，将支持更多的对接和设备同步场景。
• 全新的 SDK：全面重构，将核心通信模块做了更好的封装；简化了接口，结构更清晰，集成更容易；提升了登录速度和弱网络环境下的可靠性。

如果您希望从V2.x升级到V3.x，请参考：Android SDK 2.x 至 3.0 升级指南和iOS SDK 2.x 至 3.0 升级指南。关于服务端集成、Linux SDK集成和Web IM SDK集成，V2.x和V3.x没有区别。

平台架构

集成概述

APP 服务器与环信服务器的集成

环信只是即时通讯的消息通道。环信本身不提供用户体系，环信既不保存任何 APP 业务数据，也不保存任何 APP 的用户信息。比如说，你的 APP 是一个婚恋交友 APP，那么你的 APP 用户的头像、昵称、身高、体重、三围、电话号码等信息是保存在你自己的 APP 业务服务器上，这些信息不需要告诉环信，环信也不想知道。

环信这样设计的目的有2个：

• 尽量少的侵入开发者自己 APP 的业务数据和用户体系。用户体系是一个 APP 的最最核心的数据，在当前中国的环境下，部分开发者会比较难信赖一个第三方厂商，把自己最关键的用户体系信息托管到一个第三方平台上。
• 大多数 APP 都有自己的服务器后台，有自己的用户体系。所以环信要尽力做好的环节是尽可能方便开发者把环信和自己的用户体系集成，而不是为开发者提供他们可能并不会用的用户体系。

环信服务器提供了 RESTAPI 服务用来集成用户和好友体系：

• 用户体系：用户管理 REST API 提供了一个创建环信账号的 REST 方法。这个方法很简单，只需要提供账号 ID 和密码2个参数，就可以创建一个环信账号。对一个已经上线，已经有很多现有用户的 APP 来说，要集成环信，只需要写一个脚本，循环调用创建环信用户的 REST 方法即可。
• 好友体系：环信提供好友体系，但不是必须使用的，APP 可以将现有 APP 的好友关系导入到环信的好友体系中。好友列表管理 REST API 提供了一个修改环信账号好友体系的 REST 方法。对一个已经上线，已经有很多现有用户的 APP 来说，只需要写一个脚本，循环调用修改环信账号好友体系的 REST 方法即可。

手机 APP 端集成

请参照客户端集成来集成相应的环信 SDK。

• Android SDK 介绍及导入
• 集成 iOS SDK

---

注册并创建应用

---

注册环信开发者账号

第 1 步：在环信官网上点击“即时通讯云”，并点击“免费使用”，如下图：

第 2 步：在环信管理后台的注册页面中，填写详细资料，如下图：

第 3 步：点击注册。注册成功后，我们会向您填写的邮箱中发送验证信息，请前往邮箱进行账号激活。

创建应用

账号激活成功后，回到控制台登录页面登录到开发者后台。

第 1 步：在我的应用中，点击创建应用按钮，如下图：

第 2 步：填写创建应用的名称（内容只限于数字、大小写字母），如下图：

（应用名称会存在于你生成的 AppKey 中，如：测试 Demo 中 AppKey 为dousers#sandbox，则 sandbox 为填写的应用名称。注册授权根据需要自行选择，AppKey的长度限制为1k字节以内。）

第 3 步：填写好应用名称后，点确定。创建成功，系统会为你生成 AppKey 以及相关配置信息，如下图：

之后，将此 AppKey 配置到 Android、iOS、Web IM 上即可。

名词

解释

org_name

企业的唯一标识，开发者在环信开发者管理后台注册账号时填写的企业 ID

app_name

同一“企业”下“APP”唯一标识，开发者在环信开发者管理后台创建应用时填写的“应用名称”

org_admin

开发者在环信开发者管理后台注册时填写的“用户名”，企业管理员拥有对该企业账号下所有资源的操作权限

AppKey

一个 APP 的唯一标识，规则是 ${org_name}#${app_name}