一、 前言
此文档撰写日期为20160923,后续可能不准确,详细资料以官方为准!
二、 首先访问环信官网
1.1注册开发者账号
第 1 步:在环信官网上点击“即时通讯云”,并点击“免费使用”
第 2 步:在环信管理后台的注册页面中,填写详细资料
企业 ID:只限于数字、字母、横线,且不能以横线开头和结尾。企业ID会存在于生成的 AppKey 中。如:测试 Demo 中 AppKey 为 easemob-demo#chatdemo,则easemob-demo 为填写的企业 ID。
注:如果是个人应用开发的话,企业 ID 直接写成自己定义的 ID 就可以。
第 3 步:点击注册。注册成功后,我们会向您填写的邮箱中发送验证信息,请前往邮箱进行账号激活。
1.2创建应用
第 1 步:在我的应用中,点击“创建应用”按钮
第 2 步:填写创建应用的名称(内容只限于数字、大小写字母)
(应用名称会存在于你生成的 AppKey 中,如:测试 Demo 中 AppKey 为easemob-demo#chatdemo,则 chatdemo 为填写的应用名称。注册授权根据需要自行选择。)
第 3 步:填写好应用名称后,点确定。创建成功,系统会为你生成 AppKey 以及相关配置信息 (appkey的长度要在1k字节以内) 之后,将此 AppKey 配置到 Android、iOS、Web IM 上即可。
名词 | 解释 |
org_name | 企业的唯一标识,开发者在环信开发者管理后台注册账号时填写的企业 ID |
app_name | 同一“企业”下“APP”唯一标识,开发者在环信开发者管理后台创建应用时填写的“应用名称” |
org_admin | 开发者在环信开发者管理后台注册时填写的“用户名”,企业管理员拥有对该企业账号下所有资源的操作权限 |
AppKey | 一个 APP 的唯一标识,规则是 ${org_name}#${app_name} |
三、 服务端集成
2.1登录环信官网,下载最新环信服务端代码
1、选择Java,把easymob文件夹下的文件导入到自己的项目中
2、导入后会发现一堆的“红叉 ”,解决此问题,先检查相关运行环境,JDK1.7,各种jar包。
3、发现依然报错!查看pom.xml文件,仔细核对后发现部分jar包小版本不一致;(★★★★★)
2.2服务端代码集成使用
1、直奔主题,直接找到main方法运行一下看看结果再说
2、报了nullPointException;发现貌似token不能获取,发现集成代码时resouce文件夹下的配置文件被忽略了,查看配置文件config.properties里面有如下:
API_PROTOCAL = https
API_HOST = a1.easemob.com
API_ORG = easemob-playground #企业名
API_APP = test1 #app名
APP_CLIENT_ID = YXA6wDs-MARqEeSO0VcBzaqg5A
APP_CLIENT_SECRET = YXA6JOMWlLap_YbI_ucz77j-4-mI0JA
APP_IMP_LIB = httpclient #调用方式(可选jersey)
3、配置信息完成后,测试创建单个用户,多个用户都没有问题;
4、测试查询获取用户时,报错!!!!!!
[ERROR]: Request body is invalid.
Status: null
Response Body: {}
发现实现类HttpClientRestAPIInvoker下70行有一行body判断为null的,判断为null时,不执行request调用;此行需要注释掉后,执行成功!!!!!(★★★★★)