• UIKit
  • SDK
  • 服务端 API
Chat/
UIKit/
iOS 和 macOS/
构建基础界面/
UIKit
  • 概述
    • 产品概述
    • 功能概览
    • 定价
      • 账单概览
      • Chat 包月套餐
      • Chat 增值计费说明
  • 快速开始
    • 跑通Demo
    • 发送第一条消息
    • 集成组件
      • TUIKit
      • 仅TUIChat
    • UserSig 鉴权
  • 构建基础界面
    • 聊天界面
    • 会话列表
    • 联系人列表
    • 添加联系人
    • 创建群聊
    • 音视频通话
  • 功能
    • 添加表情回应
    • 消息引用
    • 已读回执
    • 用户在线状态
    • 文本消息翻译
    • 搜索消息
    • 接入离线推送
      • 厂商配置
      • 快速接入
      • 客户端 API
  • 自定义
    • 自定义样式
      • 全局
      • 聊天
      • 会话列表
      • 群设置
      • 联系人设置
    • 自定义消息
    • 自定义表情和贴纸
  • 国际化多语言
  • 更新日志
  • 控制台指南
    • 新版控制台说明
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
    • 用量统计
    • 实时监控
    • 开发辅助工具
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 场景化实践
    • 实现直播间搭建
    • 实现游戏内聊天
    • AI 聊天机器人
    • 超大娱乐社群
    • 类Discord社群指南
  • 推送服务(Push)
    • 服务概述
    • 开通服务
    • 快速跑通
    • 厂商通道
      • 厂商配置
        • Android
        • iOS
        • Flutter
        • React-Native
      • 快速接入
        • Android
        • iOS
        • Flutter
        • React-Native
    • 数据统计
    • 排查工具
    • 客户端 API
      • Android
      • iOS
      • Flutter
      • React Native
    • 服务端 API
      • 发起全员/标签推送
      • 单发推送
      • 获取应用属性名称
      • 设置应用属性名称
      • 获取用户属性
      • 设置用户属性
      • 删除用户属性
      • 获取用户标签
      • 添加用户标签
      • 删除用户标签
      • 清空用户标签
      • 推送撤回
    • 推送回调
      • 全员/标签/单发回调
      • 其他推送回调
    • 高级功能
      • 自定义角标
      • 自定义铃音
      • 自定义小图标
      • 自定义点击跳转
      • 推送消息分类
    • 更新日志
      • Android
      • iOS
      • Flutter
      • React Native
    • 常见问题
  • 错误码

添加联系人

本文会引导您在 TUIKit 上添加联系人。

效果展示

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



开发环境要

Xcode 10 及以上
iOS 9.0 及以上

前置条件

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

步骤说明

我们推荐您直接在 TUKit 中操作,手动添加联系人,步骤如下:
1. 按照 构建联系人界面 中的介绍,将联系人界面展示出来。
2. 点击该界面右上角的 + 按钮,在子菜单中选择 Add to Contacts
3. 输入有效的 userID,搜索出用户。您可以去控制台 Account Managerment 页面获取有效的 userID。页面路径:Applications > Your App > Chat > Users > Account Management。
4. 添加用户为联系人。
效果如下图所示:
点击 Add to Contacts
搜索用户
发送添加联系人请求









一般情况下,发送添加请求后,对方会默认同意。但如果对方账号设置过 Friend Request Verification ,可能会有不同表现。该选项路径为:
Applications > Your App > Chat > Users > Account Management > Choose an account > Edit > Friend Request Verification。
Friend Request Verification取值如下:
Friend Request Verification 取值
含义
Accept all friend requests
默认值,接受所有的好友请求
Manually accept or reject friend requests
需被请求方手动操作,同意或拒绝好友请求
Reject all friend requests
拒绝所有好友请求

更多实践

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

联系我们

如果您对本文有疑问,欢迎加入Telegram 技术交流群 ,您将获得可靠的技术支持。



在技术社区提问