tencent cloud

iOS
下载PDF
最后更新时间：2025-05-29 14:43:18
iOS
最后更新时间： 2025-05-29 14:43:18
下载PDF
本文会引导您构建联系人界面。

效果展示

如果您事先没有添加过联系人，加载出来的联系人界面是空的。添加联系人后，联系人会显示在界面列表中，如下图所示：
联系人列表为空
联系人列表非空



开发环境要求

Xcode 10 及以上
iOS 9.0 及以上

前置条件

在构建界面之前，请确保您已经完成了以下 4 件事：
1. 在控制台创建了一个应用。
2. 在控制台创建了一些用户账号。
3. 集成了 TUIKit 或 TUIContact。
4. 调用 TUILogin 的 login 接口登录组件。
注意：
1. 所有组件都是这个登录接口。每次启动应用，登录一次即可。
2. 请确保登录成功，我们建议您在登录成功的回调里进行下文的操作。
如果您尚未完成以上 4 步，请先参考 快速开始 中的对应步骤完成，否则在实现下文功能时可能遭遇阻碍。
如果您已经完成，请继续阅读下文。

步骤说明

联系人界面只需创建 TUIContactController 对象并显示出来即可。
示例代码如下：
简约版
经典版
Swift
Objective-C
import UIKit

// ContactController is your own ViewController
class ContactController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Create TUIContactController_Minimalist
        let vc = TUIContactController_Minimalist()
        
        // Option 1: push vc.
        navigationController?.pushViewController(vc, animated: true)
        // Option 2: add vc to your own ViewController.
        // addChild(vc)
        // view.addSubview(vc.view)
    }
}
#import "TUIContactController_Minimalist.h"

// ContactController is your own ViewController
@implementation ContactController
- (void)viewDidLoad {    
  // Create TUIContactController_Minimalist
  TUIContactController_Minimalist *vc = [[TUIContactController_Minimalist alloc] init];
  // Option 1: push vc.
  [self.navigationController pushViewController:vc animated:YES];
  // Option 2: add vc to your own ViewController.
  // [self addChildViewController:vc];
  // [self.view addSubview:vc.view];
}
@end
Swift
Objective-C
import UIKit

// ContactController is your own ViewController
class ContactController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Create TUIContactController
        let vc = TUIContactController()
        
        // Option 1: push vc.
        navigationController?.pushViewController(vc, animated: true)
        // Option 2: add vc to your own ViewController.
        // addChild(vc)
        // view.addSubview(vc.view)
    }
}
#import "TUIContactController.h"

// ContactController is your own ViewController
@implementation ContactController
- (void)viewDidLoad {    
  // Create TUIContactController
  TUIContactController *vc = [[TUIContactController alloc] init];
  // Option 1: push vc.
  [self.navigationController pushViewController:vc animated:YES];
  // Option 2: add vc to your own ViewController.
  // [self addChildViewController:vc];
  // [self.view addSubview:vc.view];
}
@end
联系人界面功能分区如下图所示：

TUIContact 对该界面的点击行为做了默认处理，如下：
动作
效果
点击 New Contacts
展示未处理的加好友请求
点击 Group Chats
展示当前登录账号的所有群聊
点击 Blocked List
展示当前登录账号的黑名单
点击联系人头像
进入联系人管理界面
点击右上角界面 + 号
弹出 Add to Contacts，Add Group 菜单
其中，点击联系人头像、点击Add to Contacts、点击 Group Chats的行为，您可以通过实现 TUIContactControllerListener 中的方法自定义：
简约版
经典版
Swift
Objective-C
protocol TUIContactControllerListener_Minimalist: AnyObject {
    func onSelectFriend(_ cell: TUICommonContactCell_Minimalist) -> Bool
    func onAddNewFriend(_ cell: TUICommonTableViewCell) -> Bool
    func onGroupConversation(_ cell: TUICommonTableViewCell) -> Bool
}
@protocol TUIContactControllerListener_Minimalist <NSObject>
@optional
- (void)onSelectFriend:(TUICommonContactCell *)cell;
- (void)onAddNewFriend:(TUICommonTableViewCell *)cell;
- (void)onGroupConversation:(TUICommonTableViewCell *)cell;
@end
Swift
Objective-C
protocol TUIContactControllerListener: NSObjectProtocol {
    func onSelectFriend(_ cell: TUICommonContactCell) -> Bool
    func onAddNewFriend(_ cell: TUICommonTableViewCell) -> Bool
    func onGroupConversation(_ cell: TUICommonTableViewCell) -> Bool
}
@protocol TUIContactControllerListener <NSObject>
@optional
- (void)onSelectFriend:(TUICommonContactCell *)cell;
- (void)onAddNewFriend:(TUICommonTableViewCell *)cell;
- (void)onGroupConversation:(TUICommonTableViewCell *)cell;
@end

更多实践

您可以本地 运行 TUIKitDemo 源码，探索更多的界面实现。

联系我们

如果您对本文有疑问，欢迎加入Telegram 技术交流群 ，您将获得可靠的技术支持。
本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈