环信即时通信
即时通信,简称IM(InstantMessaging),是指能够即时发送和接收互联网消息等的业务。
市场上有大量的即时通信产品,如:QQ,微信等
环信即时通讯云为开发者提供基于移动互联网的即时通讯能力,如单聊、群聊、发语音、发图片、发位置、实时音频、实时视频等,让开发者摆脱繁重的移动IM通讯底层开发,24小时即可让App拥有稳定健壮的内置IM能力
一、工作流程
APP端
- 在APP端与服务端,都需要完成与环信的集成。
- 在APP端,通过服务端查询用户在环信的账号密码。
- APP端,登录环信,进行好友聊天
服务端
- 将用户信息同步注册到环信
- 将用户好友信息同步到环信
二、基础api
初始化
EMProperties emProperties = EMProperties.builder()
.setAppkey("1138221030088106#tanhua")
.setClientId("YXA6Ak-XKvubS225XMjH_0E4TA")
.setClientSecret("YXA6uZpLoPl4akTUnm72hL-XtuiEmgo")
.build();
EMService service = new EMService(emProperties);
api
//创建环信用户
service.user().create("user01", "123456").block();
//添加好友
service.contact().add("user01","user02").block();
//删除好友
service.contact().remove("user01","user02").block();
//服务端发送消息
Set<String> set = CollUtil.newHashSet("123");
service.message().send("user01","users",
set,
new EMTextMessage().text("java"),null).block();
三、项目抽取组件
1.先在tanhua-app-server的application.yml配置环信信息
tanhua:
huanxin: #环信的即时通信(在线聊天)api配置信息
appkey: 1138221030088106#tanhua
clientId: YXA6Ak-XKvubS225XMjH_0E4TA
clientSecret: YXA6uZpLoPl4akTUnm72hL-XtuiEmgo
2.在tanhua-autoconfig创建与配置信息对应的配置类
package com.tanhua.autoconfig.properties;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
/**
* 读取tanhua-app-server application.yml配置文件的属性类
*/
@Data
@Configuration
@ConfigurationProperties(prefix = "tanhua.huanxin")
public class HuanXinProperties {
private String appkey;
private String clientId;
private String clientSecret;
}
3. 编写HuanXinTemplate
package com.tanhua.autoconfig.template;
import cn.hutool.core.collection.CollUtil;
import com.easemob.im.server.EMProperties;
import com.easemob.im.server.EMService;
import com.easemob.im.server.model.EMTextMessage;
import com.tanhua.autoconfig.properties.HuanXinProperties;
import lombok.extern.slf4j.Slf4j;
import java.util.Set;
/**
* 即时通信(模板)
*/
@Slf4j
public class HuanXinTemplate {
private EMService emService;
//通过构造方法把emProperties配置信息注入
public HuanXinTemplate(HuanXinProperties huanXinProperties) {
EMProperties emPro = EMProperties.builder()
.setAppkey(huanXinProperties.getAppkey())
.setClientId(huanXinProperties.getClientId