# 腾讯云 RTC Chat — iOS and macOS

> Chat iOS and macOS 平台文档。

## UIKit

### Getting Started

- [Activate the Service](https://pre.trtc.io/zh/document/74511.md)
- [Run Demo](https://pre.trtc.io/zh/document/45913.md): iOS 平台的 Chat SDK 快速接入指南，帮助开发者快速跑通 IM Demo，体验文字、语音、视频等消息发送功能。文档详细介绍了开通服务、环境准备、获取并配置 Demo、编译运行 Demo 及常见问题解决方案，适用于使用 Xcode 16.0 及以上版本和 iOS 14.0 及以上真机的开发者，助力快速集成即时通信能力。
- [Integration](https://pre.trtc.io/zh/document/60521.md): iOS 平台的 TUIKit 聊天组件快速接入指南，面向开发者提供完整的集成步骤，包括创建腾讯云 Chat 应用、注册用户账号、生成 UserSig 以及登录和跳转聊天界面发送第一条消息，帮助开发者快速实现即时通信功能。
- [UIKit](https://pre.trtc.io/zh/document/50056.md)
- [SwiftUI](https://pre.trtc.io/zh/document/77460.md)

### Build Basic Interfaces

- [Chat](https://pre.trtc.io/zh/document/61215.md)
- [Conversation List](https://pre.trtc.io/zh/document/61217.md)
- [Contact List](https://pre.trtc.io/zh/document/61219.md): iOS UIKit 平台的联系人界面快速接入指南，面向开发者，帮助您在 Xcode 10 及以上、iOS 9.0 及以上环境中，集成 TUIKit 或 TUIContact 组件并调用登录接口，快速构建联系人列表界面。文档包含详细的步骤说明、功能分区介绍及示例代码，支持 Swift 和 Objective-C，助力实现联系人管理功能。
- [Add Contact](https://pre.trtc.io/zh/document/61221.md)
- [Create Group Chat](https://pre.trtc.io/zh/document/61223.md)

### Features

- [Calls Integration](https://pre.trtc.io/zh/document/61225.md)
- [Reactions](https://pre.trtc.io/zh/document/59442.md)
- [Quote Reply](https://pre.trtc.io/zh/document/60771.md)
- [Read Receipt](https://pre.trtc.io/zh/document/59440.md): iOS（UIKit）消息已读回执功能是腾讯云即时通信产品中用于通知发送人接收人已阅读消息的功能。该功能适用于专业版、专业版 Plus 和企业版用户，支持单聊和群聊消息的已读状态展示。通过配置 TUIChatConfig 中的 msgNeedReadReceipt 参数，开发者可以灵活开启或关闭已读回执功能，帮助用户确认消息是否被查看，提升沟通效率。
- [Typing Indicator](https://pre.trtc.io/zh/document/59438.md)
- [User Online Status](https://pre.trtc.io/zh/document/59436.md): TUIKit 聊天组件提供用户在线状态展示功能，适用于 iOS UIKit 平台。该功能支持专业版、专业版 Plus 及企业版套餐用户使用，能够在会话列表和联系人列表的用户头像上显示在线状态标识。本文介绍如何开启该功能，包括在 Chat 控制台打开用户状态开关及在代码中设置 displayOnlineStatusIcon 参数，帮助开发者快速实现用户在线状态的展示效果。
- [Message Search](https://pre.trtc.io/zh/document/50037.md)
- [Message Translation](https://pre.trtc.io/zh/document/60772.md)
- [Customize Messages](https://pre.trtc.io/zh/document/50043.md)
- [Customize Emojis and Stickers](https://pre.trtc.io/zh/document/52396.md)
- [Manufacturer configuration](https://pre.trtc.io/zh/document/67573.md)
- [Quick Integration](https://pre.trtc.io/zh/document/50033.md)
- [Client APIs](https://pre.trtc.io/zh/document/67574.md)

### Customization

- [Global](https://pre.trtc.io/zh/document/65369.md)
- [Chat Theming](https://pre.trtc.io/zh/document/65370.md)
- [Conversation List Theming](https://pre.trtc.io/zh/document/65371.md)
- [Group Theming](https://pre.trtc.io/zh/document/65372.md)
- [Contact Theming](https://pre.trtc.io/zh/document/65373.md)

### Localization

- [Localization](https://pre.trtc.io/zh/document/57431.md)

### Changelog

- [Changelog](https://pre.trtc.io/zh/document/34282.md)

## Core SDK

### Getting Started

- [Activate the Service](https://pre.trtc.io/zh/document/74511.md)
- [iOS](https://pre.trtc.io/zh/document/34307.md): 腾讯云 Chat SDK 是一款面向 iOS 平台的即时通讯 SDK，支持 iOS 8.0 及以上系统版本，适用于需要在 iPhone 或 iPad 上快速集成聊天功能的开发者。本文详细介绍了基于 Xcode 9.0+ 的开发环境要求，提供了通过 CocoaPods 自动加载及手动集成两种集成方式，并包含了 Quic 插件的使用说明。文档还涵盖了常见问题及解决方案，帮助开发者顺利完成 Chat SDK 的集成与使用。
- [macOS](https://pre.trtc.io/zh/document/34308.md)
- [Initialize Chat SDK](https://pre.trtc.io/zh/document/47968.md): 腾讯云即时通信 IM SDK 是一款支持 Android、iOS、Windows 和 Mac 多平台的通信 SDK。本文详细介绍了 SDK 初始化的完整流程，适用于需要集成腾讯云 IM 功能的开发者。初始化步骤包括准备唯一的 SDKAppID、配置 V2TIMSDKConfig 对象以设置日志级别和监听器、添加 SDK 事件监听器以处理连接状态和登录过期等事件，最后调用初始化接口完成 SDK 启动。通过本指南，开发者可以快速完成 SDK 的接入，保障应用的稳定通信能力。
- [Login and Logout](https://pre.trtc.io/zh/document/47971.md)

### Users

- [User Profile](https://pre.trtc.io/zh/document/48162.md)
- [User Online Status](https://pre.trtc.io/zh/document/49562.md): 腾讯云 SDK 提供用户状态管理功能，支持普通状态和自定义状态两种类型。该功能适用于需要展示和管理用户在线、离线及自定义状态信息的应用场景，帮助开发者实现用户状态的实时查询、设置及变更通知。用户状态基于账号维度，支持多平台登录状态同步，部分高级功能需购买专业版及以上套餐并开启控制台配置。
- [Friend Management](https://pre.trtc.io/zh/document/48159.md)
- [Friend List](https://pre.trtc.io/zh/document/48156.md)
- [Block Lists](https://pre.trtc.io/zh/document/48153.md)
- [Follow](https://pre.trtc.io/zh/document/61230.md): 腾讯实时音视频 TRTC 关注与粉丝功能 SDK 支持 Android、iOS、Windows 和 Mac 平台，帮助用户实现关注感兴趣的其他用户并及时获取其动态，同时管理粉丝关系。本文介绍了关注用户和取消关注用户的接口调用步骤及示例代码，适用于需要构建活跃社交网络的应用，需购买专业版及以上版本解锁该功能。

### Group Channels

- [Overview](https://pre.trtc.io/zh/document/48169.md)
- [Group Channel Settings](https://pre.trtc.io/zh/document/48466.md)
- [Group Channel Profile](https://pre.trtc.io/zh/document/48185.md): 本页面介绍了适用于 Android、iOS、Windows 和 Mac 平台的群资料管理接口，属于 IM SDK 的核心功能。开发者可以通过 getGroupsInfo 接口批量获取群组的详细资料，包括群 ID、群类型和自定义字段等信息；通过 setGroupInfo 接口修改群资料，支持不同群类型的成员角色权限控制。文档还涵盖了群资料变更的事件监听机制，帮助开发者实现群组信息的实时同步与管理。
- [Member Management (Mute & Ban)](https://pre.trtc.io/zh/document/48181.md)
- [Member Profile](https://pre.trtc.io/zh/document/48178.md)
- [Group Channel Attributes](https://pre.trtc.io/zh/document/48175.md)
- [Group Channel Counter](https://pre.trtc.io/zh/document/53431.md)

### Community Channels

- [Manage Community](https://pre.trtc.io/zh/document/48172.md)
- [Permission Group](https://pre.trtc.io/zh/document/59829.md)

### Messages

- [Overview](https://pre.trtc.io/zh/document/47989.md)
- [Send a Message](https://pre.trtc.io/zh/document/47994.md)
- [Receive a Message](https://pre.trtc.io/zh/document/47995.md): 腾讯云即时通信IM SDK消息监听器功能介绍，涵盖简单消息监听器和高级消息监听器两种类型，支持Android、iOS、Windows和Mac平台。文档详细说明了如何设置消息监听器以接收文本、自定义及富媒体消息，帮助开发者实现多样化消息接收需求，保障消息及时准确传递。
- [Message History](https://pre.trtc.io/zh/document/47998.md)
- [Forward Message](https://pre.trtc.io/zh/document/48001.md)
- [Edit Message](https://pre.trtc.io/zh/document/48006.md)
- [Insert a Message](https://pre.trtc.io/zh/document/48008.md): 腾讯实时音视频 TRTC 本地消息插入接口支持在 Android、iOS、Windows 和 Mac 平台向单聊和群聊会话中插入提示性本地消息。这些消息仅存储于本地数据库，不会发送至服务端，适用于展示诸如“您已退出该群”或安全提醒等提示信息。文档提供了详细的多语言示例代码，帮助开发者快速集成和调用插入本地消息的相关接口。
- [Delete Messages](https://pre.trtc.io/zh/document/48011.md): 腾讯实时音视频 TRTC 提供的消息删除功能包括删除本地消息和删除云端存储的消息两种方式。开发者可以通过调用相应接口实现本地消息的删除，或在此基础上同步删除云端消息，满足不同场景下的消息管理需求。本文详细介绍了删除本地消息和云端消息的操作步骤、接口调用限制及示例代码，支持 Android、iOS、Windows 和 Mac 多平台，帮助开发者快速集成消息删除功能。
- [Clear History Messages](https://pre.trtc.io/zh/document/48013.md)
- [Recall a Message](https://pre.trtc.io/zh/document/48016.md)
- [Online Message](https://pre.trtc.io/zh/document/48019.md)
- [Read Receipt](https://pre.trtc.io/zh/document/48022.md)
- [Query Messages](https://pre.trtc.io/zh/document/48025.md)
- [Mentions (@)](https://pre.trtc.io/zh/document/48027.md): 腾讯实时音视频 TRTC 群 @ 消息功能 SDK 支持在 Android、iOS、Windows 和 Mac 平台实现。该功能允许发送方监听输入框中的 @ 字符，弹出群成员选择界面，选择成员后以“@成员”形式显示并发送消息。接收方会在群聊列表重点显示“有人@我”或“@所有人”提醒，帮助用户及时响应群内 @ 消息。本文介绍了群 @ 消息的创建与发送步骤，包括调用 createAtSignedGroupMessage 和 sendMessage 接口的示例代码，帮助开发者快速集成该功能。
- [Targeted Message](https://pre.trtc.io/zh/document/48029.md): 腾讯实时音视频 TRTC 群定向消息功能支持在 Android、iOS、Windows 和 Mac 平台上向群内指定成员发送消息，未被指定的成员无法接收。该功能适用于专业版、专业版plus及企业版客户，需使用增强版 SDK 6.0.1975 及以上版本。本文详细介绍了创建定向群消息、指定接收成员及发送消息的步骤，帮助用户快速实现群定向消息功能。
- [Do Not Disturb](https://pre.trtc.io/zh/document/48032.md)
- [Message Extension](https://pre.trtc.io/zh/document/50865.md)
- [Reactions](https://pre.trtc.io/zh/document/56572.md): 腾讯实时音视频 TRTC SDK 提供消息回应功能接口，支持在 Android、iOS、Windows 和 Mac 平台实现对消息的表情互动回应。该功能适用于专业版、专业版Plus及企业版客户，基于增强版 SDK 7.4 及以上版本。接口涵盖添加、删除消息回应，批量拉取消息回应信息及分页获取回应用户列表，帮助开发者实现丰富的互动体验。
- [Message Translation](https://pre.trtc.io/zh/document/53434.md)
- [Pin Messages](https://pre.trtc.io/zh/document/60171.md)

### Conversations

- [Overview](https://pre.trtc.io/zh/document/48329.md): Chat SDK 会话管理功能提供单聊和群聊的会话创建、展示与更新能力，适用于 Android、iOS、Windows 和 Mac 平台开发者。通过 V2TIMConversationManager 和 V2TIMManager(Conversation) 等接口，开发者可实现会话列表管理、未读数更新、置顶会话、草稿设置及消息免打扰等核心功能。文档详细介绍了会话类属性及本地与云端的存储策略，帮助用户合理管理会话数据。
- [Conversation List](https://pre.trtc.io/zh/document/48326.md)
- [Get Conversations](https://pre.trtc.io/zh/document/48323.md)
- [Unread Count](https://pre.trtc.io/zh/document/48320.md): 腾讯实时音视频 TRTC 提供的会话未读消息总数接口，支持 Android、iOS、Windows 和 Mac 平台。该接口适用于好友工作群、陌生人社交群和社群，帮助开发者获取所有会话的未读消息总数，并通过回调实时通知未读数变更。增强版 SDK 5.3.425 及以上版本支持该功能，提升消息提醒的准确性和用户参与度。
- [Pin Conversations](https://pre.trtc.io/zh/document/48317.md): 腾讯实时音视频 TRTC SDK 提供会话置顶功能，支持将单聊或群聊会话固定在会话列表顶部，方便用户快速查找。该功能支持 Android、iOS、Windows 和 Mac 多平台，置顶状态存储在服务器并同步至多终端。文档详细介绍了置顶会话的接口调用方法、置顶会话排序规则及变更通知监听，帮助开发者实现会话置顶及状态同步管理。
- [Delete Conversations](https://pre.trtc.io/zh/document/48314.md)
- [Conversation Draft](https://pre.trtc.io/zh/document/48311.md)
- [Conversation Mark](https://pre.trtc.io/zh/document/48853.md): 腾讯实时音视频 TRTC 会话标记功能接口文档，支持专业版及以上版本客户在 Android、iOS、Windows 和 Mac 平台调用。该接口允许开发者对会话进行标星、折叠、隐藏及标记未读等操作，并支持自定义扩展标记。文档详细说明了标记会话的参数、调用示例及监听会话标记变更通知的用法，帮助开发者实现丰富的会话管理功能。
- [Conversation Group](https://pre.trtc.io/zh/document/48854.md)

### Search

- [Search Messages](https://pre.trtc.io/zh/document/48134.md)
- [Search Friends](https://pre.trtc.io/zh/document/48137.md)
- [Search Channels](https://pre.trtc.io/zh/document/48138.md)
- [Search Channel Members](https://pre.trtc.io/zh/document/48140.md)
- [Cloud Search Messages](https://pre.trtc.io/zh/document/67834.md)
- [Cloud Search Users](https://pre.trtc.io/zh/document/67835.md)
- [Cloud Search Channels](https://pre.trtc.io/zh/document/67836.md): 腾讯云群组云端搜索功能提供通过群 ID 和群名称等关键字搜索云端群组的能力，适用于社交场景中快速查找兴趣群组。该功能支持 Android、iOS、Windows 和 Mac 平台，需专业版 Plus 或企业版授权。文档详细介绍了 searchCloudGroups 接口的参数设置和调用示例，帮助开发者实现高效的云端群组搜索。
- [Cloud Search Channel Members](https://pre.trtc.io/zh/document/67837.md)

### Official Channel

- [Official Channel](https://pre.trtc.io/zh/document/69506.md): 腾讯实时音视频 TRTC 的公众号功能支持在 Android、iOS、Windows 和 Mac 平台快速接入，实现订阅公众号、取消订阅和获取公众号列表等操作。该功能适用于需要与订阅用户进行广播消息发送或单聊的开发者，帮助实现公众号消息的收发和管理。本文提供关键步骤和示例代码，指导用户完成公众号的订阅及相关事件监听。

### Extended Features

- [Cloud Search](https://pre.trtc.io/zh/document/60066.md)
- [Text Message Translation](https://pre.trtc.io/zh/document/65360.md)
- [Poll](https://pre.trtc.io/zh/document/67611.md): TUIPollPlugin 投票插件是基于 TUIChat 的 UI 闭源库，支持在 Android 和 iOS 平台实现群组投票功能。本文介绍了如何在 Android 通过 Gradle 以及 iOS 通过 CocoaPods 快速集成 TUIPollPlugin 插件，帮助开发者轻松实现发起投票、查看投票统计和参与投票的核心功能。集成前需确保 TUIChat 版本不低于 7.1。
- [GroupNote](https://pre.trtc.io/zh/document/67615.md)
- [ConversationMark](https://pre.trtc.io/zh/document/67618.md)
- [ConversationGroup](https://pre.trtc.io/zh/document/67621.md)

### Client APIs

- [Swift](https://pre.trtc.io/zh/document/51450.md)
- [Objective-C](https://pre.trtc.io/zh/document/36170.md)

### Changelog

- [Changelog](https://pre.trtc.io/zh/document/34282.md)