关于IM

Lincy.Lin

仅支持打包版本，在打包时，需要提供融云的KEY信息
IM插件类引用下载：
   

一、在融云 http://www.rongcloud.cn/ 注册，并创建APP，获取APP的APPKEY和APPSECRET

注：开发环境和生产环境，IOS需要注册应用名和证书信息，Android可不输入
  



二、Token初始化
对IM插件进行初始化是指，使用当前登陆用户（即当前使用用户）从服务端获取Token，并将使用获取的Token初始化客户端。请注意，客户端会缓存最后一次的Token
a、初始化指定用户Token：InitialToken(string userId,string userName,string portraitUri)
b、根据当前Token重新初始化客户端：InitialToken()

注：如若Token失效，请去融云查看http://www.rongcloud.cn/，如下：



三、用户管理
a、添加用户：CreateUser(string userId,string userName,string portraitUri)
b、用户用户信息：RefreshUser(string userId,string userName,string portraitUri)在demo中进入“联系人”-“新增用户”-“添加联系人”，如下：


注：添加用户，刷新用户信息必须在初始化Token后
  
四、群组管理
a、创建群组：CreateGroup(String[] userId, String groupId, String groupName)
b、加入群组：JoinGroup(String[] userId, String groupId, String groupName)
c、退出群组：QuitGroup(String[] userId, String groupId)
d、解散群组：DismissGroup(String userId, String groupId)
在demo中进入“联系人”-“新增群组”-“添加群组”，如下


注：创建群组，加入群组，退出群组，解散群组必须在初始化Token后

五、界面显示
a.开始单用户聊天：StartPrivateChat(string userid, string title)
在demo中登录后点击“联系人”-“我的联系人”，点击联系人列表，即可与用户聊天，如下：



  
b.开始群组聊天：StartGroupChat(string groupid, string title)
在demo中登录后点击“联系人”-“我的群组”，点击群组列表，即可进行群组聊天


c.打开会话列表：StartConversationList()
在demo中登录后点击底部的“消息”按钮，便可查看聊天列表，如下：


注：用户聊天，群组聊天，打开会话列表必须在初始化Token后

六、委托回调
由于在IM中，获取用户信息，群组信息等是异步加载的，所以需要提供回调的实现。
1、LoadUserInfoHandler 获取用户信息，返回IMUserEntry对象
2、LoadGroupInfoHandler 获取群组信息，返回IMGroupEntry对象
3、LoadGroupMembersHandler 获取群组成员信息，返回string数组
4、TokenExpiredHandler Token过期后，重新初始化Token，返回string（token）
一般来说，token是永久不会过期的，但是不排除不过期的可能。token过期后，需要重置当前im的token。详见示例https://github.com/comsmobiler/demo-coms.git