SDK 文档

服务端 API

快速搭建(iOS)

最近更新时间:2021-10-14 16:51:56

常用的聊天软件都是由聊天窗口、会话列表等几个基本的界面组成。TUIKit 提供一套基本的 UI 实现,简化 IM SDK 的集成过程,只需几行代码即可在项目中使用 IM SDK 提供通信功能。

说明:

更多实操教学视频请参见:极速集成 TUIKit(iOS)

创建会话列表界面

会话列表只需要创建 TUIConversationListController 对象即可。会话列表会从数据库中读取最近联系人,当用户点击联系人时,TUIConversationListController 将该事件回调给上层。

// 创建会话列表
TUIConversationListController *vc = [[TUIConversationListController alloc] init];
conv.delegate = self;
[self.navigationController pushViewController:vc animated:YES];


- (void)conversationListController:(TUIConversationListController *)conversationController didSelectConversation:(TUIConversationCell *)conversation
{
    // 会话列表点击事件,通常是打开聊天界面
}

打开聊天界面

初始化聊天界面时,上层需要传入当前聊天界面对应的会话信息,示例代码如下:

TUIChatConversationModel *data = [[TUIChatConversationModel alloc] init];
data.userID = @"userID";    // 如果是单聊会话,传入对方用户 ID
//data.groupID = @"groupID";  // 如果是群会话,传入对应的群 ID
TUIC2CChatViewController *vc = [[TUIC2CChatViewController alloc] init];  // c2c 会话
//TUIGroupChatViewController *vc = [[TUIGroupChatViewController alloc] init];  // 群组会话
[vc setDelegate:self];
[vc setConversationData:data];
[self.navigationController pushViewController:vc animated:YES];
TUIC2CChatViewController 会自动拉取该用户的历史消息并展示出来。

添加通讯录界面

通讯录界面不需要其它依赖,只需创建对象并显示出来即可。

TUIContactController *vc = [[TUIContactController alloc] init];
[self.navigationController pushViewController:vc animated:YES];

目录