IMkit
1. 快速上手
1.1 导入SDK
目前文档是把IMKit和IMLib完全分开了, 但是maven集成中就只写im_kit的依赖了, 是否不妥? 毕竟im_kit还要依赖于im_lib的.
1.2 UI界面
因为我们默认是空会话, 可否把"测试收发消息"章节提前, 这样比较便于测试, 会话列表出现会话后, 更方便测试UI部分.
2. 导入SDK
同1.1 部分, 特意删掉im_lib是否妥当?
3. 连接相关
3.1 连接状态监听
调用示例建议使用RongIM, 让使用IMkit的用户潜意识里调用RongIM的接口.
4. 会话列表界面
4.1 自定义数据处理
描述部分: "SDK 从 5.1.5 版本开始提供了会话列表数据处理器", 这个有误.
5. 会话界面
5.1 事件监听
左边目录 "会话界面"--> "事件监听", 链接会被指向"即时通讯开发指导".
6. 用户信息相关
6.1 功能介绍
是否可以加上一句醒目提示语 "和调用服务端API申请token时传入的name, portrait没有任何关系, 此处的用户信息功能仅限于客户端本地". 因为很多用户会混淆此处.
6.2 刷新用户信息
也可以提示下用户此刷新功能仅限于本地, 不能同步到其他端.
7. 消息功能相关
此处有较多示例代码使用了RongIMClient, 或IMCenter (插入消息处). 可以尽量统一下只暴露RongIM类出去.
7.1 转发消息
可以提示下客户, 在IMkit限制下, 转发消息不支持自定义消息.
7.2 自定义消息
IMkit文档已经完全去除了自定义消息的章节, 只有无UI文档包含, 这样如何使用消息展示器的指南就没有了.
8. 推送相关
8.1
例如小米/ 魅族推送指南中, 第一步要求客户确保集成融云默认推送, 此处链接有问题.
8.2
建议所有推送点击可以走PushMessageReceiver的, 都加上我们默认PushMessageReceiver在manifest的配置指导:
<receiver
android:name="io.rong.push.notification.PushMessageReceiver"
android:exported="true">
<intent-filter>
<action android:name="io.rong.push.intent.MESSAGE_ARRIVED" />
<action android:name="io.rong.push.intent.MESSAGE_CLICKED" />
<action android:name="io.rong.push.intent.THIRD_PARTY_PUSH_STATE" />
</intent-filter>
</receiver>
我们只有在"自定义点击通知"这样的章节中建议用户去继承PushMessageReceiver, 在manifest做配置. 如果用户没有自定义点击需求, 只需要走我们默认点击逻辑, 这样PushMessageReceiver默认是需要他自己来注册的, 没有注册的话就收不到广播了.
网友评论