# 腾讯云 RTC Call — iOS

> Call iOS 平台文档。

## UIKit

### Get Started

- [Run the Demo](https://pre.trtc.io/zh/document/60416.md): iOS 音视频通话 Demo 快速接入指南，帮助开发者在 Xcode 13 及以上环境和两台 iOS 14.0 及以上设备上完成音视频通话功能的快速体验。文档详细介绍了开通服务、下载 Demo、配置 SDKAppID 和 SDKSecretKey、运行 Demo、登录注册以及拨打电话的关键步骤，解决签名错误和套餐购买提示等常见问题，支持开发者快速实现完整音视频通话功能。
- [Integration](https://pre.trtc.io/zh/document/50992.md): TUICallKit 是腾讯云提供的音视频通话组件，支持 iOS 13.0 及以上系统。本文详细介绍了如何在 iOS 平台通过 CocoaPods 导入 TUICallKit 组件，配置麦克风和摄像头权限，开通腾讯云音视频服务，完成登录认证，并设置用户昵称头像。通过本文的步骤，开发者可以在 10 分钟内快速集成完整的音视频通话功能，满足一对一及多人通话需求。

### Basic Features

- [UserSig Authentication](https://pre.trtc.io/zh/document/35166.md): 腾讯实时通信服务的 UserSig 是基于 SDKAppID 和 UserID 计算的安全签名，采用 HMAC SHA256 算法，防止恶意攻击者盗用云服务。本文介绍了 UserSig 的基本概念、调试阶段的客户端和控制台计算方法，以及正式运行阶段推荐的服务端计算方案，帮助开发者安全高效地完成身份认证和服务调用。
- [In-call Chat](https://pre.trtc.io/zh/document/66906.md): Chat 聊天 SDK 提供多平台聊天 API 和用户界面组件，支持 iOS 平台快速集成音视频通话功能。本文介绍了在 iOS 应用中开通音视频服务、集成 TUICallKit 组件的关键步骤，帮助开发者在聊天应用中轻松实现视频通话和语音通话功能，提升用户互动体验。
- [UI Customization](https://pre.trtc.io/zh/document/50996.md)
- [Group Calls](https://pre.trtc.io/zh/document/59837.md): TUICallKit 是一款支持多人通话的 SDK，适用于 Android、iOS 和 Flutter 平台。该指南介绍了如何快速接入多人通话功能，包括发起多人通话和加入已有通话的具体步骤，帮助开发者实现音视频通话的群组管理与交互。
- [APNs](https://pre.trtc.io/zh/document/54923.md): TUICallKit 离线推送集成指南详细介绍了如何通过 TIMPush 插件实现 iOS 端的离线推送功能。文档面向开发者，涵盖从集成组件、开启远程推送、生成并上传推送证书，到完成工程配置和推送参数设置的完整步骤，帮助用户快速实现稳定的推送通知。支持跨平台框架和 VoIP 推送扩展，并提供常见问题解决方案，提升推送体验和通知效果。
- [VoIP (Apple CallKit)](https://pre.trtc.io/zh/document/51000.md): TUICallKit 组件提供 VoIP 推送功能的快速接入方案，适用于 iOS 13.0 及以上系统。通过集成 TUIVoIPExtension/CallKit 推送插件，开发者可以实现高效的离线推送和系统级通话体验。文档详细介绍了开通 TIMPush 服务、申请 VoIP Push 证书、上传证书到 IM 控制台、完成工程配置以及接入组件的完整步骤，帮助开发者快速完成 VoIP 通话功能的集成。
- [VoIP (Apple LiveCommunicationKit)](https://pre.trtc.io/zh/document/72208.md): TUICallKit VoIP 推送组件是腾讯云提供的用于实现 iOS 平台 VoIP 推送功能的 SDK。该组件支持通过接入 TUIVoIPExtension/LiveCommunicationKit 推送插件快速实现高效的 VoIP 通知，适用于需要提升通话触达率和推送效果的开发者。文档详细介绍了开通服务、申请和上传 VoIP Push 证书、工程配置、组件集成及拨打 VoIP 通话的关键步骤，帮助用户快速完成集成。
- [Switch Bluetooth Headset](https://pre.trtc.io/zh/document/72205.md): iOS 平台的蓝牙耳机切换功能属于 TUICallKit 组件的音频路由管理功能，支持在未连接蓝牙耳机时切换扬声器和听筒，连接蓝牙耳机后通过 Apple AVRoutePickerView 组件实现蓝牙耳机、听筒和扬声器之间的切换。本文介绍了如何使用 TUICallKit 组件内的 UI 按钮快速完成音频路由切换，包含未连接和连接蓝牙耳机时的操作步骤。
- [Configuring Nicknames and Avatars](https://pre.trtc.io/zh/document/59834.md): 腾讯实时音视频 TRTC 提供多平台的昵称和头像设置功能，支持 Android、iOS、Flutter、Web&H5 及 uni-app 等主流开发平台。本文详细介绍了调用 TUICallKit 的 setSelfInfo 接口更新用户昵称和头像的步骤，帮助开发者快速完成个性化信息配置。注意非好友通话时，昵称和头像更新可能存在延迟，通话成功后将自动同步。
- [Floating Window](https://pre.trtc.io/zh/document/59841.md): TUICallKit 通话组件支持 Android、iOS 和 Flutter 平台，提供悬浮窗功能，允许用户在语音或视频通话时将通话界面缩小为悬浮窗。本文介绍如何通过调用 enableFloatWindow 方法，在 TUICallKit 组件初始化时启用悬浮窗功能，帮助开发者快速实现通话界面悬浮窗效果。
- [Custom Ringtones](https://pre.trtc.io/zh/document/59846.md): TUICallKit 通话组件提供 iOS 平台的来电铃声替换与静音模式设置功能，支持通过替换默认铃声资源或调用接口设置应用铃声，满足不同场景需求。文档详细介绍了如何设置应用铃声、启用静音模式以及配置离线推送铃音，帮助开发者实现个性化通话体验。
- [Call State Monitoring](https://pre.trtc.io/zh/document/59851.md): TUICallKit 组件提供通话状态与通话成员动态回调的 API，支持 Android、iOS 和 Flutter 平台。开发者可通过注册 TUICallObserver 监听通话生命周期中的关键事件，包括通话开始、结束及成员的加入和离开，便于实现实时 UI 更新和业务逻辑处理。文档详细介绍了回调接口的使用方法和注意事项，帮助开发者高效集成通话回调功能。
- [Localization](https://pre.trtc.io/zh/document/63263.md): TUICallKit iOS SDK 支持简体中文、英文、日文和阿拉伯语，默认语言随手机系统自动匹配。本文指导开发者如何通过 TUIGlobalization.setPreferredLanguage 方法切换语言，并详细介绍新增语言包的两步流程，包括源码集成和语言文件新增与翻译，帮助开发者快速实现多语言支持。
- [Server-initiated Calls](https://pre.trtc.io/zh/document/71845.md): 腾讯实时音视频 TRTC 服务端发起通话快速接入指南介绍了如何通过服务端调用REST API完成发起音视频通话，支持1V1及群组通话场景。文档详细说明了请求参数配置、调用示例及应答解析，帮助开发者实现服务端输入上行音视频媒体流，满足多样化通话需求。
- [Multi-device Login](https://pre.trtc.io/zh/document/78558.md): 音视频通话能力 TUICallKit 提供多设备登录功能，支持同一 UserID 在多台设备（如 iPhone、iPad、Windows PC）同时登录并接收来电。该功能适用于办公、医疗等需要多设备无缝切换的场景。通过调用 enableMultiDeviceAbility API，开发者可快速开启此功能，实现多设备同时响铃并保证通话唯一性。本文详细介绍了功能简介、接入步骤及关键逻辑，帮助开发者高效集成多设备登录。

### Advanced Features

- [Virtual Background](https://pre.trtc.io/zh/document/60491.md): TUICallKit 组件提供虚拟背景功能，支持在 iOS 平台的视频通话中设置模糊背景或本地图片背景，帮助用户隐藏真实环境保护隐私。本文详细介绍了虚拟背景功能的集成准备条件、开启模糊背景的接口调用及图片背景设置方法，适用于已购买音视频通话 Group Call 套餐的开发者，确保模型文件与 TRTC SDK 版本匹配以保证功能正常使用。
- [AI Noise Suppression](https://pre.trtc.io/zh/document/60481.md): AI 降噪是腾讯天籁实验室研发的语音降噪技术，集成于 TUICallKit SDK 中。该技术面向需要高质量语音通话体验的用户，能够智能识别并去除传播信号中的噪声干扰，显著提升语音清晰度和用户听感。用户可在办公室、网吧、商场及户外等多种环境中享受稳定清晰的声音效果，且 TUICallKit 默认开启该功能，无需额外配置。同时，用户可通过 Tencent RTC Demo 在线体验 AI 降噪带来的优质音质。
- [Cloud Recording](https://pre.trtc.io/zh/document/51001.md): TUICallKit通话录制是基于TRTC云端录制能力的SDK，面向需要通话存档、回放及合规审计的用户，提供零代码接入和自动生命周期管理的通话全程自动录制功能。本文介绍了如何通过控制台配置或代码设置两种方式快速开启云端录制，涵盖全局录制和按需录制的关键步骤，帮助开发者高效实现通话录制需求。

### Client APIs

- [API Reference](https://pre.trtc.io/zh/document/51010.md): TUICallKit 与 TUICallEngine 是腾讯云提供的音视频通话组件 API，分别支持含 UI 和无 UI 两种接入方式。开发者可通过这些 API 快速实现类微信的音视频通话场景，或根据业务需求自定义封装。页面详细介绍了各接口方法及关键类型定义，帮助开发者理解和使用音视频通话核心能力。
- [TUICallKit](https://pre.trtc.io/zh/document/51011.md): TUICallKit API 是腾讯云提供的音视频通话组件接口，含 UI 功能，适用于移动端快速集成类微信的音视频通话场景。该接口支持创建单例实例、设置用户昵称和头像、发起单人或多人通话、主动加入通话，以及自定义来电铃声、开启静音模式、悬浮窗功能、虚拟背景和来电横幅显示，同时支持屏幕方向设置。通过这些接口，开发者可以灵活控制通话行为和界面表现，满足多样化的实时通信需求。
- [TUICallObserver](https://pre.trtc.io/zh/document/51013.md): TUICallObserver 是腾讯实时音视频 TRTC 中 TUICallEngine 的回调事件类，提供丰富的通话状态和用户行为回调接口。开发者可以通过监听这些回调事件，实时获取通话错误、通话请求、通话开始与结束、用户加入离开等信息，方便实现通话界面展示、录制控制及异常处理等功能，支持视频通话和语音通话的多种场景。
- [Type Definitions](https://pre.trtc.io/zh/document/54902.md): 腾讯实时音视频 TRTC 类型定义文档，详细介绍了通话参数、离线推送配置、扩展信息、音视频房间ID、网络质量、视频渲染及编码参数等结构体和枚举类型。该文档面向开发者，帮助理解各参数字段及取值，支持多平台音视频通话功能的开发与集成。
- [TUICallEngine](https://pre.trtc.io/zh/document/51012.md): TUICallEngine API 是腾讯实时音视频 TRTC 提供的无 UI 音视频通话组件接口，适用于需要自定义交互的开发者。该接口支持创建和销毁实例、初始化鉴权、发起和管理单人及多人通话、控制摄像头和麦克风、视频渲染设置等功能，帮助开发者灵活集成音视频通话能力。

### Solutions

- [WhatsApp Clone](https://pre.trtc.io/zh/document/64301.md): WhatsApp Clone 是一个基于腾讯技术的即时通讯项目，支持多平台使用，包括 iOS、Android、Web 和 Flutter。该项目为用户提供强大的单人及群组聊天功能，以及高质量、低延迟的音视频通话体验。通过集成 ChatUIkit 和 CallKit，支持虚拟背景、AI 降噪和弱网优化，确保通话清晰流畅。同时，项目提供完善的软件管理工具，如仪表盘、统计分析和云端录制，方便用户管理数据和服务。WhatsApp Clone 注重数据安全，符合 GDPR 标准，面向全球用户，致力于打造便捷、高效且安全的即时通讯解决方案。

### FAQ

- [General](https://pre.trtc.io/zh/document/53565.md): TUICallKit 常见问题解答页面，针对拨打语音或视频通话时遇到的错误码如[-100035]、-3301，用户ID无效，邀请ID无效，版本兼容等问题提供解决方案。适用于使用 TUICallKit 进行音视频通话的开发者，帮助快速定位问题并获取各平台日志文件路径，支持 iOS、Android、Windows 等多平台。
- [iOS](https://pre.trtc.io/zh/document/51023.md): TUICallKit 是腾讯云提供的音视频通话组件，面向 iOS 开发者，解决集成过程中遇到的能力包过期、源码修改、Xcode 15 编译错误、音视频库冲突、后台运行支持及 TRTC 日志查看等问题。本文详细说明了错误提示原因及对应处理方法，源码修改步骤，编译错误解决方案，冲突处理建议，后台运行配置，以及日志解密查看方法，帮助开发者高效排查和解决集成难题。
- [Error Codes](https://pre.trtc.io/zh/document/54901.md): 音视频通话错误码表是腾讯云提供的错误码指南，涵盖TUICallDefine、Chat、TRTC和CallKit服务端的常见错误码。该错误码表帮助开发者和用户快速定位音视频通话过程中出现的问题，明确错误原因，并提供针对性的解决建议，保障音视频通话功能的稳定使用。

## Core SDK

### Get Started

- [Making Your First Call](https://pre.trtc.io/zh/document/78013.md): AtomicXCore SDK 是一套面向 iOS 平台的音视频通话功能 SDK，包含 DeviceStore、CallStore 和 CallCoreView 三大核心模块。该文档面向开发者，指导如何通过集成 SDK、初始化登录、创建通话界面及添加通话控制按钮，快速实现拨打电话功能。文档详细介绍了设备控制、通话生命周期管理及通话视图渲染的关键步骤，帮助用户高效搭建多人音视频通话场景。
- [Answering Your First Call](https://pre.trtc.io/zh/document/78012.md): AtomicXCore SDK 是一款面向 iOS 平台的多人音视频通话开发工具包，帮助开发者快速实现接听电话功能。文档详细介绍了服务开通、SDK 集成、初始化登录流程及通话页面创建步骤，涵盖通话视图绑定、接听拒接按钮添加、权限申请和来电提示等关键操作，支持丰富的 UI 定制能力，助力开发者高效搭建稳定的音视频通话体验。
- [Integration Offline Push](https://pre.trtc.io/zh/document/78014.md): TIMPush 推送服务提供的 VoIP 推送功能，支持在 iOS 17.4 及以上系统中实现无 UI 集成的原生通话能力。本文档适用于开发者，详细介绍了从申请 VoIP Push 证书、上传证书到 Chat 控制台，到初始化 PushKit、获取和上报 VoIP Token 以及接收和展示来电通知的完整接入步骤，帮助您快速实现进程关闭或锁屏状态下的通话唤醒和通知展示。

### Client APIS

- [CallStore](https://pre.trtc.io/zh/document/78020.md): CallStore 是腾讯云提供的音视频通话管理 SDK，支持单人及多人实时音视频互动。该 SDK 适用于需要集成通话功能的应用，提供发起、接听、拒绝、挂断、群组管理及通话记录查询等核心能力。开发者可通过 CallStore 的丰富 API 实现通话生命周期管理，并通过事件订阅实时获取通话状态和参与者信息，确保通话体验的稳定与流畅。
- [CallCoreView](https://pre.trtc.io/zh/document/81727.md): CallCoreView 是腾讯云提供的通话界面主要容器组件，支持多布局切换、呼叫等待动画自定义、音量和网络质量状态图标自定义以及参与者头像映射。该组件适用于需要灵活展示通话画面的应用场景，需配合 CallStore 使用以实现通话画面和状态的正确展示。文档详细介绍了 CallCoreView 的核心能力、API 方法及参数说明，帮助开发者高效集成和定制通话界面。

### FAQs

- [All Platform](https://pre.trtc.io/zh/document/53565.md): TUICallKit 常见问题解答页面，针对拨打语音或视频通话时遇到的错误码如[-100035]、-3301，用户ID无效，邀请ID无效，版本兼容等问题提供解决方案。适用于使用 TUICallKit 进行音视频通话的开发者，帮助快速定位问题并获取各平台日志文件路径，支持 iOS、Android、Windows 等多平台。
- [iOS](https://pre.trtc.io/zh/document/51023.md): TUICallKit 是腾讯云提供的音视频通话组件，面向 iOS 开发者，解决集成过程中遇到的能力包过期、源码修改、Xcode 15 编译错误、音视频库冲突、后台运行支持及 TRTC 日志查看等问题。本文详细说明了错误提示原因及对应处理方法，源码修改步骤，编译错误解决方案，冲突处理建议，后台运行配置，以及日志解密查看方法，帮助开发者高效排查和解决集成难题。
- [ErrorCode](https://pre.trtc.io/zh/document/54901.md): 音视频通话错误码表是腾讯云提供的错误码指南，涵盖TUICallDefine、Chat、TRTC和CallKit服务端的常见错误码。该错误码表帮助开发者和用户快速定位音视频通话过程中出现的问题，明确错误原因，并提供针对性的解决建议，保障音视频通话功能的稳定使用。
- [Android&iOS](https://pre.trtc.io/zh/document/51020.md): 腾讯实时音视频 TRTC Android&iOS 版本更新日志详细记录了各版本的功能优化、新特性及缺陷修复，帮助开发者了解接口变更和平台兼容性改进。内容涵盖单人及多人通话支持、通话稳定性提升、界面和推送优化、多语言支持等，适用于使用 TRTC 进行音视频通话开发的技术人员。