Tencent Cloud

Recent Pages

iOS

Last updated: 2024-06-24 16:49:24

This article will guide you through building a chat interface.
Display Effect
The effect of sending messages in the chat interface is as follows:
One-to-one Chat Interface
Group Chat Interface
﻿
﻿
Environment Requirements
Xcode 10 or later
iOS 9.0 or later
Preconditions
Before building the interface, please ensure that you have completed the following 4 things:
1. Created an application in the console.
2. Created some user accounts in the console.
3. Integrated TUIKit or TUIChat.
4. Called the login API in TUILogin to log in to the component.
Note:
1. All components use this API to log in. You can log in once every time you start the application.
2. Please make sure that the login is successful, and we recommend that you do the following in the callback of successful login.
If you haven't completed the above 4 steps, please refer to the corresponding steps in Getting Started first, otherwise you may encounter obstacles when implementing the following features.
If you have already completed them, please continue reading below.
Step Instructions
If you wish to jump to the One-to-one Chat Message Interface, you can directly refer to Getting Started, which we won't repeat in this article.
To navigate to the Group Chat Interface, you need to enter a valid groupID. This presupposes that you have an existing groupID of a valid group. There are two convenient ways to obtain it:
1. Go to Console to create a group, the operation path is: Applications > Your App > Chat > Groups > Group Management > Add Group. After successful creation, you can directly see the groupID on the current page.
2. Follow the guide below on Create Group Chat, manually create a group in TUIKit, where the groupID will be displayed on the group details page.
Sample code:
Minimalist version
Classic version
#import "TUIBaseChatViewController_Minimalist.h"
#import "TUIC2CChatViewController_Minimalist.h"
#import "TUIGroupChatViewController_Minimalist.h"
﻿
// ChatViewController is your own ViewController
@implementation ChatViewController
- (void)viewDidLoad { 
  // Create conversation data.
  TUIChatConversationModel *conversationData = [[TUIChatConversationModel alloc] init];
  // Pass userID for 1v1 chat, while groupID for group chat.
  conversationData.userID = @"userID";    
  conversationData.groupID = @"groupID";
  
  // Create chatVC by groupID or userID.
  TUIBaseChatViewController_Minimalist *chatVC = nil;
  if (conversationData.groupID.length > 0) {
      chatVC = [[TUIGroupChatViewController_Minimalist alloc] init];
  } else if (conversationData.userID.length > 0) {
      chatVC = [[TUIC2CChatViewController_Minimalist alloc] init];
  }
  [chatVC setConversationData:conversationData];
  
  // Option 1: push chatVC.
  [self.navigationController pushViewController:chatVC animated:YES];
  // Option 2: add chatVC to your own ViewController.
  // [self addChildViewController:vc];
  // [self.view addSubview:vc.view];
}
@end
#import "TUIBaseChatViewController.h"
#import "TUIC2CChatViewController.h"
#import "TUIGroupChatViewController.h"
﻿
// ChatViewController is your own ViewController
@implementation ChatViewController
- (void)viewDidLoad {
  // Create conversation data.
  TUIChatConversationModel *conversationData = [[TUIChatConversationModel alloc] init];
  // Pass userID for 1v1 chat, while groupID for group chat.
  conversationData.userID = @"userID";    
  conversationData.groupID = @"groupID";
  
  // Create chatVC by groupID or userID.
  TUIBaseChatViewController *chatVC = nil;
  if (conversationData.groupID.length > 0) {
      chatVC = [[TUIGroupChatViewController alloc] init];
  } else if (conversationData.userID.length > 0) {
      chatVC = [[TUIC2CChatViewController alloc] init];
  }
  [chatVC setConversationData:conversationData];
  
  // Option 1: push chatVC.
  [self.navigationController pushViewController:chatVC animated:YES];
  // Option 2: add chatVC to your own ViewController.
  // [self addChildViewController:chatVC];
  // [self.view addSubview:chatVC.view];
}
@end
More practices
You can locally run the TUIKitDemo source code to explore more interface implementations.
Contact Us
If you have any questions about this article, feel free to join the Telegram Technical Group, where you will receive reliable technical support.