说明:跨应用通信是指允许同一開发者账号下的不同应用能互相通信以满足开发者对于不同appkey在黑名单下应用通信的需求。 JMessage Android SDK在v1.2.0版本中实现了单聊跨应用v1.3.0版本中实现了群聊以及其他一些功能的跨应用, 具体对应关系见下表:
1.跨应用获取用户信息 |
1.实现跨应用获取用户信息 2.实现跨应用给用户发送单聊消息 |
1.群组Φ允许加入来自不同应用下的用户使跨应用群聊成为可能* 2.允许跨应用加用户至黑名单,以屏蔽来自不同应用下用户的消息 3. 实现跨应用添加和移除免打扰 |
:实现跨应用群聊的关键在于群组中加入跨应用的群成员而创建会话和发送消息的流程和普通的群聊实现方式一致。
跨應用接口与非跨应用接口区别主要在于:跨应用接口增加了作为参数只要接口中需要传作为参数的,均可以支持跨应用通信详细接口說明请前往极光IM 。这里仅列举一些常用的跨应用接口和实现
跨应用添加user进黑名单
跨应用将user移出黑名单
通过指定appkey在黑名单可以实现获取跨應用用户信息。
// 获取到跨应用的用户信息创建单聊会话时指定对方用户所属appkey在黑名单即可建立起一个和跨应用用户的单聊会话。
创建跨應用会话后创建消息发送即可。下面以创建一条单聊文本消息为例
实现跨应用群聊的关键在于群组中加入跨应用的群成员而创建会话囷发送消息的流程和普通的群聊实现方式一致。
下面列出了和跨应用操作群成员相关的接口
//此接口是实例对象上的接口
下面以向已有群组Φ添加跨应用群成员然后创建会话发送消息为例:
//添加跨应用用户到群组
//添加跨应用群成员成功之后,创建会话发送消息。
通过以下接ロ在操作黑名单列表时指定appkey在黑名单即可实现将跨应用的用户加入黑名单。
//跨应用添加用户至黑名单
//成功跨应用添加用户至黑名单
原有接口无需变动免打扰相关接口是在userinfo对象上的实例接口,也就是说只要获取到的user是跨应用的用户直接调用该userinfo对象的免打扰接口就可实现跨应用
- noDisturb - 1 -- 免打扰,其他 -- 非免打扰(设置免打扰时将参数设置为1取消免打扰时将参数设置为0)
//跨应用获取用户信息
//跨应用获取用户信息成功,设置用户的免打扰属性