即时通信 IM SDK API（iOS & Mac） - 客户端 API

注意：

新老版本 API 请勿混合使用。

初始化登录接口

初始化并成功登录，是正常使用腾讯云 IM 服务的前提。

简单消息收发接口

如果您只需要使用文本和信令（即一段自定义buffer）消息，只需要使用这套简单消息收发接口即可。

信令接口

高级消息收发接口

如果您需要收发图片、视频、文件等富媒体消息，并需要撤回消息、标记已读、查询历史消息等高级功能，推荐使用下面这套高级消息接口（简单消息接口和高级消息接口请不要混用）。

群组相关接口

腾讯云 IM SDK 支持四种预设的群组类型，每种类型都有其适用场景：

• 工作群（Work） ：类似普通微信群，创建后不能自由加入，必须由已经在群的用户邀请入群。
• 公开群（Public） ：类似 QQ 群，用户申请加入，但需要群主或管理员审批。
• 会议群（Meeting）：适合跟 TRTC 结合实现视频会议和在线教育等场景，支持随意进出，支持查看进群前的历史消息。
• 直播群（AVChatRoom）：适合直播弹幕聊天室等场景，支持随意进出，人数无上限。

会话列表相关接口

会话列表，即登录微信或 QQ 后首屏看到的列表，包含会话节点、会话名称、群名称、最后一条消息以及未读消息数等元素。

用户资料相关接口

包含查询用户资料、修改个人资料以及屏蔽某人消息（即把某用户加入黑名单中）的相关接口。

离线推送相关接口

如果想要在 App 切后台时依然能够实时收到 IM 消息，可以使用离线推送服务，详细配置请参考 离线推送。

好友管理相关接口

腾讯云 IM 在收发消息时默认不检查是不是好友关系，您可以在 【控制台】 >【功能配置】>【登录与消息】>【好友关系检查】中开启"发送单聊消息检查关系链"开关，并使用如下接口增删好友和管理好友列表。