动态与公告

产品动态

产品近期公告

关于 TRTC Live 正式上线的公告

关于TRTC Conference 正式版上线的公告

Conference 商业化版本即将推出

关于多人音视频 Conference 开启内测公告

关于音视频通话 Call 正式版上线的公告

关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告

关于 TRTC 应用订阅套餐服务上线的相关说明

产品简介

产品概述

基本概念

产品功能

产品优势

应用场景

性能数据

购买指南

计费概述

免费时长说明

月订阅

现收现付

TRTC 逾期与暂停政策

常见问题解答

退款说明

新手指引

Demo 体验

视频通话 SDK

组件介绍

开通服务

跑通 Demo

快速接入

离线唤醒

会话聊天

云端录制

AI 降噪

界面定制

Chat 集成通话能力

更多特性

无 UI 集成

服务端 API

客户端 API

解决方案

错误码表

发布日志

常见问题

视频会议 SDK

组件介绍（TUIRoomKit）

开通服务（TUIRoomKit）

跑通 Demo（TUIRoomKit）

快速接入（TUIRoomKit）

屏幕共享（TUIRoomKit）

预定会议（TUIRoomKit）

会中呼叫（TUIRoomKit）

界面定制（TUIRoomKit）

虚拟背景（TUIRoomKit）

会议控制（TUIRoomKit）

云端录制（TUIRoomKit）

AI 降噪（TUIRoomKit）

会中聊天（TUIRoomKit）

机器人推流（TUIRoomKit）

更多特性（TUIRoomKit）

客户端 API（TUIRoomKit）

服务端 API（TUIRoomKit）

常见问题（TUIRoomKit）

错误码 (TUIRoomKit)

SDK更新日志（TUIRoomKit）

直播与语聊 SDK

Live 视频直播计费说明

组件介绍

开通服务（TUILiveKit）

跑通 Demo

无 UI 集成

UI 自定义

直播监播

视频直播

语聊房

高级功能

客户端 API

服务端 API

错误码

发布日志

常见问题

RTC Engine

开通服务

SDK 下载

API-Example

接入指引

API-参考手册

高级功能

AI 集成

概述

MCP 配置

Skills 配置

集成指南

常见问题

RTC RESTFUL API

History

Introduction

API Category

Room Management APIs

Stream mixing and relay APIs

On-cloud recording APIs

Data Monitoring APIs

Pull stream Relay Related interface

Web Record APIs

AI Service APIs

Cloud Slicing APIs

Cloud Moderation APIs

Companion Transcription APIs

Making API Requests

Call Quality Monitoring APIs

Usage Statistics APIs

Data Types

Appendix

Error Codes

控制台指南

应用管理

套餐包管理

用量统计

监控仪表盘

开发辅助

解决方案

实时合唱

常见问题

迁移指南

计费相关

功能相关

UserSig 相关

应对防火墙限制相关

缩减安装包体积相关

Andriod 与 iOS 相关

Web 端相关

Flutter 相关

Electron 相关

TRTCCalling Web 相关

音视频质量相关

其他问题

旧版文档

RTC RoomEngine SDK（旧）

集成 TUIRoom (Web)

集成 TUIRoom (Android)

集成 TUIRoom (iOS)

集成 TUIRoom (Flutter)

集成 TUIRoom (Electron)

TUIRoom API 查询

实现云端录制与回放（旧）

监控仪表盘计费（旧）

协议与策略

安全合规认证

安全白皮书

信息安全说明

服务等级协议

苹果隐私策略：PrivacyInfo.xcprivacy

TRTC 政策

隐私协议

数据处理和安全协议

词汇表

API 概览

PDF

聚焦模式

字号

最后更新时间： 2025-02-26 14:17:50

TUICallKit (含 UI 接口)
TUICallKit API 是音视频通话组件的含 UI 接口，使用TUICallKit API，您可以通过简单接口快速实现一个类微信的音视频通话场景。
API
含义
﻿login﻿
登录。
﻿logout﻿
退出登录。
﻿calls﻿
发起单人或多人通话
﻿call﻿
进行一对一通话，支持自定义房间ID、通话超时、离线推送内容等。
﻿groupCall﻿
进行群组通话，支持自定义房间ID、通话超时、离线推送内容等。
﻿joinInGroupCall﻿
加入群组通话。
﻿setCallingBell﻿
自定义用户的铃声。
﻿enableMuteMode﻿
打开/关闭铃声。
﻿enableVirtualBackground﻿
开启/关闭模糊背景功能。
﻿setScreenOrientation﻿
设置屏幕方向。
﻿on﻿
监听 TUICallKit 事件。
﻿off﻿
取消监听 TUICallKit 事件。
TUICallEvent
TUICallEvent 是 TUICallKit 对应的回调事件类，您可以通过此回调，来监听自己感兴趣的回调事件。
Event
含义
﻿TUICallEvent.onError﻿
通话过程中错误回调。
﻿TUICallEvent.onCallReceived﻿
通话请求的回调。
﻿TUICallEvent.onCallCancelled﻿
通话取消的回调。
﻿TUICallEvent.onCallBegin﻿
通话接通的回调。
﻿TUICallEvent.onCallEnd﻿
通话结束的回调。
﻿TUICallEvent.onUserReject﻿
xxxx 用户拒绝通话的回调。
﻿TUICallEvent.onUserNoResponse﻿
xxxx 用户不响应的回调。
﻿TUICallEvent.onUserLineBusy﻿
xxxx 用户忙线的回调。
﻿TUICallEvent.onUserJoin﻿
xxxx 用户加入通话的回调。
﻿TUICallEvent.onUserLeave﻿
xxxx 用户离开通话的回调。
﻿TUICallEvent.onCallMediaTypeChanged﻿
通话的媒体类型发生改变的回调。
﻿TUICallEvent.onKickedOffline﻿
当前用户被踢下线。
﻿TUICallEvent.onUserSigExpired﻿
在线时票据过期。
﻿TUICallEvent.onUserVideoAvailable﻿
xxx 用户是否有视频流的回调。
﻿TUICallEvent.onUserAudioAvailable﻿
xxx 用户是否有音频流的回调。
﻿TUICallEvent.onUserVoiceVolumeChanged﻿
所有用户音量大小的反馈回调。
﻿TUICallEvent.onUserNetworkQualityChanged﻿
所有用户网络质量的反馈回调。
TUICallEngine (无 UI 接口)
TUICallEngine API 是音视频通话组件的无 UI 接口，如果 TUICallKit 的交互并不满足您的需求，您可以使用这套 API 根据您的业务需求自定义封装。
API
含义
﻿createInstance﻿
创建 TUICallEngine 实例（单例模式）。
﻿destroyInstance﻿
销毁 TUICallEngine 实例（单例模式）。
﻿login﻿
完成音视频通话基础能力的鉴权。
﻿on﻿
增加事件回调。
﻿off﻿
移除回调接口。
﻿call﻿
发起 1v1 通话。
﻿accept﻿
接听通话。
﻿reject﻿
拒绝通话。
﻿ignore﻿
忽略通话。
﻿hangup﻿
结束通话。
﻿switchCallMediaType﻿
切换通话媒体类型，比如视频通话切音频通话。
﻿startRemoteView﻿
开始订阅远端用户视频流。
﻿stopRemoteView﻿
停止订阅远端用户视频流。
﻿openCamera﻿
开启摄像头。
﻿switchCamera﻿
切换前后摄像头。
﻿closeCamera﻿
关闭摄像头。
﻿openMicrophone﻿
打开麦克风。
﻿closeMicrophone﻿
关闭麦克风。
﻿selectAudioPlaybackDevice﻿
选择音频播放设备（听筒/扬声器）。
﻿setVideoRenderParams﻿
设置用户视频画面的渲染模式。
﻿setVideoEncoderParams﻿
设置视频编码的编码参数。
﻿setBeautyLevel﻿
设置美颜级别，支持关闭默认美颜。
﻿setSelfInfo﻿
设置用户的昵称、头像。
﻿enableMultiDeviceAbility﻿
开启/关闭 TUICallEngine 的多设备登录模式 （群组通话版套餐 支持）。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

实时音视频

API 概览

TUICallKit (含 UI 接口)

TUICallEvent

TUICallEngine (无 UI 接口)

帮助和支持

API	含义
login	登录。
logout	退出登录。
calls	发起单人或多人通话
call	进行一对一通话，支持自定义房间ID、通话超时、离线推送内容等。
groupCall	进行群组通话，支持自定义房间ID、通话超时、离线推送内容等。
joinInGroupCall	加入群组通话。
setCallingBell	自定义用户的铃声。
enableMuteMode	打开/关闭铃声。
enableVirtualBackground	开启/关闭模糊背景功能。
setScreenOrientation	设置屏幕方向。
on	监听 TUICallKit 事件。
off	取消监听 TUICallKit 事件。

Event	含义
TUICallEvent.onError	通话过程中错误回调。
TUICallEvent.onCallReceived	通话请求的回调。
TUICallEvent.onCallCancelled	通话取消的回调。
TUICallEvent.onCallBegin	通话接通的回调。
TUICallEvent.onCallEnd	通话结束的回调。
TUICallEvent.onUserReject	xxxx 用户拒绝通话的回调。
TUICallEvent.onUserNoResponse	xxxx 用户不响应的回调。
TUICallEvent.onUserLineBusy	xxxx 用户忙线的回调。
TUICallEvent.onUserJoin	xxxx 用户加入通话的回调。
TUICallEvent.onUserLeave	xxxx 用户离开通话的回调。
TUICallEvent.onCallMediaTypeChanged	通话的媒体类型发生改变的回调。
TUICallEvent.onKickedOffline	当前用户被踢下线。
TUICallEvent.onUserSigExpired	在线时票据过期。
TUICallEvent.onUserVideoAvailable	xxx 用户是否有视频流的回调。
TUICallEvent.onUserAudioAvailable	xxx 用户是否有音频流的回调。
TUICallEvent.onUserVoiceVolumeChanged	所有用户音量大小的反馈回调。
TUICallEvent.onUserNetworkQualityChanged	所有用户网络质量的反馈回调。

API	含义
createInstance	创建 TUICallEngine 实例（单例模式）。
destroyInstance	销毁 TUICallEngine 实例（单例模式）。
login	完成音视频通话基础能力的鉴权。
on	增加事件回调。
off	移除回调接口。
call	发起 1v1 通话。
accept	接听通话。
reject	拒绝通话。
ignore	忽略通话。
hangup	结束通话。
switchCallMediaType	切换通话媒体类型，比如视频通话切音频通话。
startRemoteView	开始订阅远端用户视频流。
stopRemoteView	停止订阅远端用户视频流。
openCamera	开启摄像头。
switchCamera	切换前后摄像头。
closeCamera	关闭摄像头。
openMicrophone	打开麦克风。
closeMicrophone	关闭麦克风。
selectAudioPlaybackDevice	选择音频播放设备（听筒/扬声器）。
setVideoRenderParams	设置用户视频画面的渲染模式。
setVideoEncoderParams	设置视频编码的编码参数。
setBeautyLevel	设置美颜级别，支持关闭默认美颜。
setSelfInfo	设置用户的昵称、头像。
enableMultiDeviceAbility	开启/关闭 TUICallEngine 的多设备登录模式（群组通话版套餐支持）。