环信集成流程说明

1.注册环信开发者账号

2.用户体系集成和好友体系集成

①用户体系集成

服务器端集成

将已上线的 APP 的现有用户集成到环信

用户管理 REST API 提供了一个创建环信账号的 REST 方法。这个方法很简单,只需要提供账号 ID 和密码2个参数,就可以创建一个环信账号。对一个已经上线,已经有很多现有用户的 APP 来说,要集成环信,只需要写一个脚本,循环调用创建环信用户的 REST 方法即可。

环信账号中的 username 可以和已有的 APP 用户体系的用户的 primarykey 相同。这样做的好处是不需要对现有 APP 后台的数据库的用户表做任何修改(比如不需要给用户表增加一个叫环信账号 ID 的字段)。

APP 创建新用户时创建环信账号

为保证安全,强烈建议只在服务器端调用创建环信账号的 REST 方法。具体方法见用户管理 REST API。即每次当APP客户端调用APP自己的业务后台创建新用户时,也在环信上为该 APP 用户创建一个环信账号。

通常的做法是在自己 APP 创建用户成功后调用创建环信账号的 REST 方法来创建环信账号。因为这个方法是服务器对服务器的调用,所以因为网络不稳定原因失败的可能很小。但开发者仍旧需要对该方法的返回结果做处理,如果该方法失败,应该做个 retry,如果仍旧失败,应该回滚在自己 APP 创建用户的操作。否则会导致 APP 的用户账号和环信账号不一致的问题。

APP 删除用户时删除环信账号

为保证安全,强烈建议只在服务器端调用删除环信账号的 REST 方法。具体方法见用户管理 REST API。即每次当APP客户端调用APP自己的业务后台删除新用户时,也在环信上将该 APP 用户对应的环信账号删除。

APP 修改用户密码时更新环信账号的密码

为保证安全,强烈建议只在服务器端调用修改环信账号密码的 REST 方法。具体方法见用户管理 REST API。即每次当 APP 用户的密码被修改时,也要更新该 APP 用户对应的环信账号的密码。

客户端集成

客户端登录集成

APP 客户端在登录自己的 APP 服务器后台成功后,需要调用环信客户端 SDK 的登录方法。

客户端退出登录集成

APP 客户端在退出登录自己的 APP 服务器后台成功后,需要调用环信客户端 SDK 的退出登录方法。

③好友体系集成

所谓好友体系,是指谁是谁的好友的关系体系。环信提供好友体系,但不是必须使用的,仅在需要控制消息发送权限时才启动。

比如对一个企业内部移动办公 APP 来说,因为企业内部同事是彼此认识的,那么此 APP 可能是不需要消息发送权限控制的。即任何人都可以给任何人发消息。

但一个交友类的 APP 就必须要控制只有我的好友才能给我发消息,不是我的好友的人需要向我发送加好友邀请,我批准后才能给我发消息。这种情况下,就需要启用环信提供的好友体系。

服务器端集成

APP 需要将现有 APP 的好友关系导入到环信的好友体系中,这样环信才有足够的信息去控制谁可以给谁发消息。

将已上线的 APP 的现有用户的好友体系导入到环信

好友列表管理 REST API 提供了一个修改环信账号好友体系的 REST 方法。对一个已经上线,已经有很多现有用户的 APP 来说,只需要写一个脚本,循环调用修改环信账号好友体系的 REST 方法即可。

APP 用户好友列表更新时也同步更新环信账号的好友体系

好友列表管理 REST API 提供了一个修改环信账号好友体系的 REST 方法。即每次当 APP 业务后台的用户的好友列表发生变化时,也在环信上更新该 APP 用户的好友体系。

打开或关闭发送消息权限控制

如前文所述,是否在环信中建立好友体系,是否开启或关闭发送消息的权限控制,是由 APP 管理者自己决定的。

客户端集成

通常来说,“将已上线的 APP 的现有用户的好友体系导入到环信”这个是在 APP 的服务器端做的。但“APP 用户好友列表更新时也同步更新环信账号的好友体系”这个操作则根据 APP 具体的业务场景,即可以在服务器端做,也可以在客户端做。

iOS 客户端操作好友列表
  • 获取好友列表,监听好友列表
  • 根据账号(查找、添加、删除,黑名单)
Android 客户端操作好友列表
  • 好友列表管理

3. 通信过程及聊天记录保存

①通信过程


②聊天记录保存


客户端A发送消息到环信服务器的同时,SDK 会保存这条消息到本地数据库(SDK 内部创建数据库,不允许直接操作),环信服务器在推送消息到客户端B的同时也会在服务器记录下来(消息历史记录只会保留14天),客户端B收到消息后,SDK 会将这条消息存储到本地数据库。

注:客户端并未提供去服务器获取聊天记录的接口,所以,如果换了设备或者清空了数据,聊天记录都不会存在。如果有需求要从服务器拉取聊天记录,可以在自己服务器处理。


4.实时消息回调

实时消息回调经常用在应用需要针对用户发送的消息进行处理的场景。比如:

  • 针对客户消息的内容进行自动回复
  • 在 APP 自己的服务端实时保存聊天历史实时消息回调为增值服务,需要付费开通。
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值