云信小课堂 | 简单快速实现圈组功能

本文主要是介绍云信小课堂 | 简单快速实现圈组功能，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Vol. 11

云信「圈组」作为一款全新设计的产品，没有任何历史包袱的限制（但是却可以充分吸收历史优点），你可以使用它构建一个类 Discord 产品，或者任何你想得到的社交/娱乐/游戏产品。「圈组」产品最大的特点首先是 server/channel 的二级结构；其次是构建在二级结构之上的大规模社群（单个 server 数十万甚至上百万成员），以及使用复杂的身份组系统来管理如此规模的社群组织和成员。

接下同大家一起，用20分钟的时间快速实现一个简单的圈组功能（基于 NIMSDK 新版本9.x）

视频讲解

20分钟视频详解，手把手教你接入

前期准备

开发工具：Xcode
开发语言：Objective-C
使用到的SDK：

#核心库

pod 'NIMSDK_LITE', '9.1.0'

#demo使用到的第三方UI库

pod 'SVProgressHUD'

pod 'Masonry'

pod 'JSQMessagesViewController'

pod 'MJRefresh'

具体步骤

第一步：初始化 NIMSDK

在 appdelegate 的didFinishLaunchingWithOptions 入口方法初始化 NIMSDK。

第二步：登陆

要使用圈组功能，首先需要登录圈组，当前版本圈组功能依赖于 IM 登录，需要先完成 IM 登录，再登录圈组。

IM 的登陆这里不详细介绍，账号和密码可以通过 api 和 sdk 的注册方法获取，圈聊的登陆支持动态 token 登陆和默认 IM 账号登陆，动态 token 登陆需要服务端来获取 token。这里默认以 IM 账号非动态 token 登陆为例，不需要传任何参数直接 login 就可以。区别于 IM 的方法和类名以 NIM 开头，圈组相关的方法和类名以 NIMQ 开头。

第三步：服务器管理

对于圈组，服务器相当于游乐场，可以创建，修改，查询和删除。

创建一个服务器，创建服务器可以设置服务器的名字，图标以及自定义的扩展参数。也可以配置邀请模式和申请模式等。

获取服务器列表，可以设置获取的条数，可以根据时间戳分页获取

第四步：频道管理

对于圈组，频道相当于游乐场的游乐设施，也可以创建，修改，查询和删除。

在刚才的服务器下创建一个频道，创建频道需要传入服务器 id，可以设置频道名字，主题，自定义参数。也可以配置频道类型，查看模式等。查看模式分公共频道和私有频道。

获取频道列表，可以设置获取的条数，可以根据时间戳分页获取，需要传入服务器 id。

第五步：服务器成员

现在服务器和频道都创建好了，可以邀请别人加入。

邀请发出去之后，被邀请人需要监听到这个邀请信息。

在监听方法里面根据 result 参数信息判断收到了邀请，就可以调用接受邀请加入的方法 acceptServerInvite

接收到了邀请，需要主动调用已读，不然下次登陆还会收到邀请的通知信息。

这样就完成了邀请别人加入自己服务器的流程，服务器就有了两个成员，可以在频道里面聊天了。

第六步：消息发送

进入到聊天页面，先获取历史记录，如果有就展示出来。

点击发送按钮就可以发送消息到这个频道了，发送消息需要传入消息对象 NIMQChatMessage 和会话对象 NIMSession，如代码所示，会话是根据服务器 id 和频道 id 生成的。所以发送圈组消息其实就是在某个服务器的某个频道发消息。如果是公共频道，默认在这个服务器的成员就都可以收到消息。

消息接收可以在聊天页面或者 app 全局添加消息NIMQChatMessageManagerDelegate 代理。

至此，圈组的一个简单流程已经完成。

第七步：身份组管理

对于圈组，除了游乐场 service 和游乐设施 channel，还有一套自定义的权限系统可以帮助管理游乐场。这个自定义权限系统主要是通过身份组来实现管理的。身份组主要分为身份组成员和身份组权限两块。

在创建 service 成功之后，服务器都会有一个默认的 everyone 的身份组，这个身份组的成员就是服务器的所有成员。对这个身份组权限的配置会默认应用到整个服务器和服务器的所有 channel。这里修改下 everyone 这个身份组的发消息权限，可以看到服务器的成员就没有权限发消息了。

既然是身份组管理，当然是支持自己创建身份组，自己创建的身份组可以修改，查询和删除

创建一个身份组，身份组可以定义名称，类型，图标，自定义参数等。