动态与公告

产品动态

产品近期公告

关于 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

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 政策

隐私协议

数据处理和安全协议

词汇表

Android

PDF

聚焦模式

字号

最后更新时间： 2025-10-09 16:25:48

本文将介绍如何定制 TUICallKit 的用户界面，我们提供了两个方案供您选择：界面微调方案和自实现 UI 方案。
方案一：界面微调方案
通过直接修改我们提供的 UI 源代码，对 TUICallKit 的用户界面进行调整，TUICallKit 的界面源代码位于 GitHub 中的 Android/tuicallkit-kt 文件夹下面。
替换图标
您可以直接替换 tuicallkit-kt/src/main/res/drawable-xxhdpi 文件夹下的图标，以确保整个 App 中的图标色调风格保持一致，请在替换时保持图标文件的名字不变。
﻿
﻿
﻿
替换铃声
您可以替换 tuicallkit-kt/src/main/res/raw 文件夹下的三个音频文件来达到替换铃声的目的。
文件名
用途
phone_dialing.mp3
发起呼叫时的声音
phone_hangup.mp3
被挂断的声音
phone_ringing.mp3
接到呼叫时的声音
替换文案
您可以通过修改 tuicallkit-kt/src/main/res/values-**/ 中的 strings.xml 文件来修改视频通话界面中的字符串内容。
方案二：自实现 UI 方案
TUICallKit 的通话功能是基于 TUICallEngine 这个无 UI 组件实现的，您可以删掉 tuicallkit-kt 文件夹，完全基于 TUICallEngine 实现一套自己的 UI 界面。
TUICallEngine
TUICallEngine 是整个通话组件的底层接口，主要提供了1V1音视频通话和群组内通话的发起、接听、拒绝、结束以及设备操作等关键接口。
API
描述
﻿createInstance﻿
创建 TUICallEngine 实例（单例模式）
﻿destroyInstance﻿
销毁 TUICallEngine 实例（单例模式）
﻿init﻿
完成音视频通话基础能力的鉴权
﻿addObserver﻿
增加事件回调
﻿removeObserver﻿
移除回调接口
﻿calls﻿
发起单人或多人通话
﻿accept﻿
接听通话
﻿reject﻿
拒绝通话
﻿hangup﻿
结束通话
﻿ignore﻿
忽略通话
﻿inviteUser﻿
在群组通话中，邀请其他人加入
﻿join﻿
主动加入通话
﻿startRemoteView﻿
开始订阅远端用户视频流
﻿stopRemoteView﻿
停止订阅远端用户视频流
﻿openCamera﻿
开启摄像头
﻿closeCamera﻿
关闭摄像头
﻿switchCamera﻿
切换前后摄像头
﻿openMicrophone﻿
打开麦克风
﻿closeMicrophone﻿
关闭麦克风
﻿selectAudioPlaybackDevice﻿
选择音频播放设备（听筒/扬声器）
﻿setSelfInfo﻿
设置用户的昵称、头像
﻿enableMultiDeviceAbility﻿
开启/关闭 TUICallEngine 的多设备登录模式（群组通话版套餐支持）
﻿setVideoRenderParams﻿
设置用户视频画面的渲染模式
﻿setVideoEncoderParams﻿
设置视频编码的编码参数
﻿getTRTCCloudInstance﻿
高级接口，用于接入第三方美颜等
﻿setBeautyLevel﻿
设置美颜级别，支持关闭默认美颜
TUICallObserver
TUICallObserver 是 TUICallEngine 对应的回调事件类，您可以通过此回调，来监听自己感兴趣的回调事件。
API
描述
﻿onError﻿
通话过程中错误回调
﻿onCallReceived﻿
通话请求的回调
﻿onCallBegin﻿
通话接通的回调
﻿onCallEnd﻿
通话结束的回调
﻿onCallNotConnected﻿
通话未接通的回调
﻿onUserReject﻿
xxxx 用户拒绝通话的回调
﻿onUserNoResponse﻿
xxxx 用户不响应的回调
﻿onUserLineBusy﻿
xxxx 用户忙线的回调
﻿onUserInviting﻿
xxxx 用户被追加邀请加入通话时的回调
﻿onUserJoin﻿
xxxx 用户加入通话的回调
﻿onUserLeave﻿
xxxx 用户离开通话的回调
﻿onUserVideoAvailable﻿
xxx 用户是否有视频流的回调
﻿onUserAudioAvailable﻿
xxx 用户是否有音频流的回调
﻿onUserVoiceVolumeChanged﻿
所有用户音量大小的反馈回调
﻿onUserNetworkQualityChanged﻿
所有用户网络质量的反馈回调
﻿onKickedOffline﻿
当前用户被踢下线
﻿onUserSigExpired﻿
在线时票据过期
关键类型定义
API
描述
﻿TUICallDefine.MediaType﻿
通话的媒体类型，枚举类型：视频通话、语音通话
﻿TUICallDefine.Role﻿
通话的角色，枚举类型：主叫、被叫
﻿TUICallDefine.Status﻿
通话的状态，枚举类型：空闲、待接听、接听中
﻿TUICommonDefine.RoomId﻿
音视频房间 ID，支持数字、字符串两种类型
﻿TUICommonDefine.Camera﻿
摄像头 ID 参数，枚举类型：前摄、后摄
﻿TUICommonDefine.AudioPlaybackDevice﻿
声音的播放设备，枚举类型：扬声器、听筒
﻿TUICommonDefine.NetworkQualityInfo﻿
当前的网络质量信息
﻿

帮助和支持

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

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

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

文档反馈

tencent cloud

实时音视频

Android

方案一：界面微调方案

替换图标

替换铃声

替换文案

方案二：自实现 UI 方案

TUICallEngine

TUICallObserver

关键类型定义

帮助和支持

文件名	用途
phone_dialing.mp3	发起呼叫时的声音
phone_hangup.mp3	被挂断的声音
phone_ringing.mp3	接到呼叫时的声音

API	描述
createInstance	创建 TUICallEngine 实例（单例模式）
destroyInstance	销毁 TUICallEngine 实例（单例模式）
init	完成音视频通话基础能力的鉴权
addObserver	增加事件回调
removeObserver	移除回调接口
calls	发起单人或多人通话
accept	接听通话
reject	拒绝通话
hangup	结束通话
ignore	忽略通话
inviteUser	在群组通话中，邀请其他人加入
join	主动加入通话
startRemoteView	开始订阅远端用户视频流
stopRemoteView	停止订阅远端用户视频流
openCamera	开启摄像头
closeCamera	关闭摄像头
switchCamera	切换前后摄像头
openMicrophone	打开麦克风
closeMicrophone	关闭麦克风
selectAudioPlaybackDevice	选择音频播放设备（听筒/扬声器）
setSelfInfo	设置用户的昵称、头像
enableMultiDeviceAbility	开启/关闭 TUICallEngine 的多设备登录模式（群组通话版套餐支持）
setVideoRenderParams	设置用户视频画面的渲染模式
setVideoEncoderParams	设置视频编码的编码参数
getTRTCCloudInstance	高级接口，用于接入第三方美颜等
setBeautyLevel	设置美颜级别，支持关闭默认美颜

API	描述
onError	通话过程中错误回调
onCallReceived	通话请求的回调
onCallBegin	通话接通的回调
onCallEnd	通话结束的回调
onCallNotConnected	通话未接通的回调
onUserReject	xxxx 用户拒绝通话的回调
onUserNoResponse	xxxx 用户不响应的回调
onUserLineBusy	xxxx 用户忙线的回调
onUserInviting	xxxx 用户被追加邀请加入通话时的回调
onUserJoin	xxxx 用户加入通话的回调
onUserLeave	xxxx 用户离开通话的回调
onUserVideoAvailable	xxx 用户是否有视频流的回调
onUserAudioAvailable	xxx 用户是否有音频流的回调
onUserVoiceVolumeChanged	所有用户音量大小的反馈回调
onUserNetworkQualityChanged	所有用户网络质量的反馈回调
onKickedOffline	当前用户被踢下线
onUserSigExpired	在线时票据过期

API	描述
TUICallDefine.MediaType	通话的媒体类型，枚举类型：视频通话、语音通话
TUICallDefine.Role	通话的角色，枚举类型：主叫、被叫
TUICallDefine.Status	通话的状态，枚举类型：空闲、待接听、接听中
TUICommonDefine.RoomId	音视频房间 ID，支持数字、字符串两种类型
TUICommonDefine.Camera	摄像头 ID 参数，枚举类型：前摄、后摄
TUICommonDefine.AudioPlaybackDevice	声音的播放设备，枚举类型：扬声器、听筒
TUICommonDefine.NetworkQualityInfo	当前的网络质量信息