# 腾讯云 RTC Call — Flutter

> Call Flutter 平台文档。

## UIKit

### Get Started

- [Run the Demo](https://pre.trtc.io/zh/document/60414.md): Flutter 音视频通话 Demo 快速接入指南，指导开发者在 Android 和 iOS 平台上完成环境准备、服务开通、Demo 下载与配置运行。文档详细介绍了登录注册、发起通话等关键步骤，并提供常见问题解答，帮助用户在 10 分钟内体验完整的音视频通话功能。
- [Integration](https://pre.trtc.io/zh/document/54896.md): TUICallKit 是腾讯云提供的音视频通话组件，支持 Flutter 平台快速集成。本文详细介绍了从环境准备、服务开通、插件导入、工程配置到登录和通话发起的完整接入流程，帮助开发者在 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/66905.md): Chat 聊天 SDK 提供多平台聊天 API 和用户界面组件，支持在 Flutter 应用中快速集成音视频通话功能。本文详细介绍了集成准备、服务开通及 TUICallKit 插件安装和配置步骤，帮助开发者在聊天应用中轻松实现音视频通话，提升用户互动体验。
- [UI Customization](https://pre.trtc.io/zh/document/56562.md)
- [Group Calls](https://pre.trtc.io/zh/document/59837.md): TUICallKit 是一款支持多人通话的 SDK，适用于 Android、iOS 和 Flutter 平台。该指南介绍了如何快速接入多人通话功能，包括发起多人通话和加入已有通话的具体步骤，帮助开发者实现音视频通话的群组管理与交互。
- [Notification](https://pre.trtc.io/zh/document/60457.md): TIMPush 插件是面向 Flutter 开发者的离线推送 SDK，支持快速接入音视频通话离线推送功能。该插件兼容 Android 和 iOS 平台，提供数据统计、链路追踪及全员/标签推送能力，帮助开发者高效实现推送触达与管理。本文详细介绍了在 TUICallKit 组件中集成 TIMPush 插件的步骤，包括配置 OfflinePushInfo 以实现离线推送通话，并提供相关问题排查建议。
- [VoIP (Optional)](https://pre.trtc.io/zh/document/60458.md): 腾讯云 VoIP 通话快速接入指南，涵盖 iOS 和 Android 平台的配置步骤。文档详细介绍了 iOS 端 VoIP 推送的替代方案和 Android 端通过 TIMPush 插件实现 VoIP 通知的集成流程，包括注册推送平台、控制台配置、下载配置文件、插件集成及代码配置。指南还说明了如何结合 TUICallKit 使用离线推送能力，以及解决应用被终止后无法显示来电 UI 的常见问题，帮助开发者快速实现高质量的 VoIP 通话功能。
- [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/59849.md): TUICallKit 是一款支持 Flutter 平台的来电铃声设置 SDK，提供应用铃声和离线推送铃声的替换与配置能力。用户可以通过替换音频文件或调用接口设置应用铃声，并可启用静音模式关闭来电铃声。离线推送铃声方面，iOS 平台通过 APNs 推送参数设置铃声，Android 平台支持华为、小米及 FCM 推送铃声的自定义配置。本文详细介绍了相关设置步骤，帮助开发者快速完成铃声定制。
- [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/63265.md): TUICallKit 是一款支持多语言的音视频通话 SDK，支持简体中文、英文和日文，默认语言为英文。本文指导开发者如何在 Flutter 平台中切换语言及添加新的语言包，步骤包括源码集成、本地依赖配置、新增语言文件、翻译内容及更新语言设置方法，帮助用户实现多语言环境下的音视频通话功能。
- [USB Camera Capture](https://pre.trtc.io/zh/document/64373.md): Android USB 摄像头集成指南，适用于支持 Android 5.0 及以上版本的手机、平板及定制设备。通过与 TUICallKit 组件结合，帮助开发者快速实现外接 USB 摄像头的视频通话功能。文档详细介绍了环境准备、依赖配置及集成步骤，并提供了针对 Android 9 和 Android 10 版本摄像头权限异常的解决方案。
- [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/60479.md): TUICallKit 组件提供虚拟背景功能的 Flutter 快速接入指南，帮助开发者在视频通话中实现模糊背景和图片背景效果。文档详细介绍了功能开启步骤、所需条件、模型文件下载与匹配方法，以及如何在 Flutter 工程中集成和调用相关接口，提升通话隐私保护和趣味性。
- [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，面向需要通话存档、回放及合规审计的用户，提供零代码接入和自动生命周期管理的通话全程自动录制功能。本文介绍了如何通过控制台配置或代码设置两种方式快速开启云端录制，涵盖全局录制和按需录制的关键步骤，帮助开发者高效实现通话录制需求。
- [Beauty Effects](https://pre.trtc.io/zh/document/59406.md): TUICallKit 美颜特效集成指南，面向使用 Flutter 开发的用户，指导如何通过 TRTC 自定义视频渲染在 Native 层完成美颜处理。文档详细说明了开启关闭美颜的 Dart 到 Native 控制接口实现、Native 层美颜处理逻辑以及美颜参数的自定义设置，帮助开发者快速完成第三方及腾讯美颜特效的接入。

### Client APIs

- [API Reference](https://pre.trtc.io/zh/document/54905.md): TUICallKit API 是腾讯云音视频通话组件的含 UI 接口，面向需要快速集成音视频通话功能的开发者。该 API 支持登录、登出、用户信息设置、发起和加入通话，以及静音模式、悬浮窗和来电横幅等核心功能，并定义了通话类型、扩展参数和调用返回值等关键类型，帮助开发者高效构建类微信音视频通话场景。
- [TUICallKit](https://pre.trtc.io/zh/document/54906.md): TUICallKit API 是腾讯实时音视频 TRTC 提供的音视频通话组件 API，包含完整的 UI 接口，适用于需要快速集成类微信音视频通话功能的开发者。该接口支持用户登录登出、设置昵称头像、发起和加入通话、开启静音模式、悬浮窗及来电横幅等核心通话控制能力，帮助开发者高效构建丰富的音视频通话场景。
- [TUICallObserver](https://pre.trtc.io/zh/document/54908.md): TUICallObserver 是腾讯实时音视频 TRTC 旧版 API 中用于监听通话回调事件的接口，适用于 Flutter 插件环境。该接口提供通话错误、邀请、接听、取消、开始、结束、用户加入离开、媒体状态变化等多种事件回调，帮助开发者实时掌握通话状态并做出相应处理。建议新接入开发者使用新版 API 以获得更优性能和更多功能。
- [Type Definitions](https://pre.trtc.io/zh/document/54909.md): 类型定义页面介绍了 CompletionHandler、CallParams 及 CallMediaType 的结构和字段。CompletionHandler 用于表示 API 调用的返回结果，包含错误码和错误信息。CallParams 定义了通话的相关参数，如房间 ID、超时时长、用户自定义数据、群组 ID 及匿名通话设置。CallMediaType 枚举了通话的媒体类型，包括语音通话和视频通话，帮助开发者准确配置和调用相关接口。
- [TUICallEngine](https://pre.trtc.io/zh/document/54907.md): TUICallEngine 是一套旧版音视频通话 SDK，面向需要集成通话功能的开发者。它提供了初始化、通话发起与管理、摄像头和麦克风控制、视频画面渲染与编码参数设置等核心能力。该文档详细描述了各接口的功能和参数，帮助开发者正确调用实现音视频通话业务。

### 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 等多平台。
- [Flutter](https://pre.trtc.io/zh/document/56860.md): 腾讯实时音视频 TRTC Flutter 相关组件集成与升级常见问题解决方案，面向使用 Flutter 开发的音视频应用开发者。文档详细说明如何解决 tencent_calls_uikit 与 tencent_trtc_cloud 或 live_flutter_plugin 同时集成时的符号冲突报错，Flutter Android 平台混淆设置方法，以及从 1.8.0 以下版本升级到 1.8.0 及以上版本后出现的编译错误和页面拉取问题的修复步骤，帮助开发者顺利完成集成与升级。
- [Error Codes](https://pre.trtc.io/zh/document/54901.md): 音视频通话错误码表是腾讯云提供的错误码指南，涵盖TUICallDefine、Chat、TRTC和CallKit服务端的常见错误码。该错误码表帮助开发者和用户快速定位音视频通话过程中出现的问题，明确错误原因，并提供针对性的解决建议，保障音视频通话功能的稳定使用。
- [Upgrading](https://pre.trtc.io/zh/document/58626.md)

## Core SDK

### Get Started

- [Making Your First Call](https://pre.trtc.io/zh/document/78433.md): AtomicXCore SDK 是一款支持多人音视频通话的 Flutter SDK，包含 DeviceStore、CallStore 和 CallCoreView 三大核心模块。本文档面向开发者，详细介绍了服务开通、SDK 集成、初始化登录及拨打电话的完整步骤，帮助快速搭建音视频通话功能。文中涵盖 Android 和 iOS 平台的配置细节，并支持通话界面自定义，满足多样化应用需求。
- [Answering Your First Call](https://pre.trtc.io/zh/document/78434.md): AtomicXCore SDK 是一套用于多人音视频通话的 Flutter SDK，包含 DeviceStore、CallStore 和 CallCoreView 三个核心模块。本文档面向开发者，详细介绍了开通服务、集成 SDK、初始化登录流程及创建通话页面等关键步骤，帮助用户快速实现接听电话功能，支持通话视图渲染、设备控制和通话生命周期管理。
- [Integration Offline Push](https://pre.trtc.io/zh/document/78435.md): 腾讯云 Chat 推送 SDK 提供基于 tencent_cloud_chat_push 插件的离线推送功能，支持 Android 平台的 FCM 和 iOS 平台的 APNs。本文档适用于使用 AtomicXCore 进行无 UI 集成的开发者，详细介绍了开通服务、厂商配置、插件集成和工程配置等关键步骤，并提供推送渠道选择和提升推送触达率的实用建议，帮助开发者快速实现稳定高效的消息离线推送。

### Client APIs

- [CallStore](https://pre.trtc.io/zh/document/77699.md): CallStore 是腾讯云音视频通话功能的核心 SDK，提供丰富的 API 用于管理通话的整个生命周期。开发者可以通过 CallStore 实现发起、接听、拒绝、挂断音视频通话，支持单人和多人通话场景。该 SDK 还支持通话状态的实时订阅、事件监听以及通话记录的查询与删除，帮助用户高效管理通话流程和数据。所有操作均保证在主线程执行，便于 UI 更新和异常处理。
- [CallCoreView](https://pre.trtc.io/zh/document/81729.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 等多平台。
- [Flutter](https://pre.trtc.io/zh/document/56860.md): 腾讯实时音视频 TRTC Flutter 相关组件集成与升级常见问题解决方案，面向使用 Flutter 开发的音视频应用开发者。文档详细说明如何解决 tencent_calls_uikit 与 tencent_trtc_cloud 或 live_flutter_plugin 同时集成时的符号冲突报错，Flutter Android 平台混淆设置方法，以及从 1.8.0 以下版本升级到 1.8.0 及以上版本后出现的编译错误和页面拉取问题的修复步骤，帮助开发者顺利完成集成与升级。
- [ErrorCode](https://pre.trtc.io/zh/document/54901.md): 音视频通话错误码表是腾讯云提供的错误码指南，涵盖TUICallDefine、Chat、TRTC和CallKit服务端的常见错误码。该错误码表帮助开发者和用户快速定位音视频通话过程中出现的问题，明确错误原因，并提供针对性的解决建议，保障音视频通话功能的稳定使用。