动态与公告

产品动态

产品近期公告

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

隐私协议

数据处理和安全协议

词汇表

关键类型

PDF

聚焦模式

字号

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

callParams
在 Tencent RTC 控制台通话扩展参数，例如：房间号、通话邀请超时时间，离线推送自定义内容等。
参数
类型
是否必填
含义
roomId
﻿RoomId﻿
否
房间 ID，详情请参考 RoomId。
timeout
Number
否
通话超时时间，默认：40s，单位：秒。timeout = 0，设置为不超时
userData
String
否
发起通话时自定义扩展字段
offlinePushInfo
﻿OfflinePushInfo﻿
否
自定义离线消息推送参数
chatGroupId
String
否
与 chat 结合使用时， chat 群组的群 ID
RoomId
房间 ID，分为 String 类型和 Number 类型。
参数
类型
是否必填
含义
strRoomId
String
否
房间 ID，String 类型
intRoomId
Number
否
房间 ID，Number 类型
OfflinePushInfo
参数
类型
是否必填
含义
title
String
否
离线推送展示通知栏标题
desc
String
否
离线推送展示通知栏内容
ignoreIOSBadge
boolean
否
离线推送忽略 badge 计数（仅对 iOS 生效）， 如果设置为 true，在 iOS 接收端，这条消息不会使 APP 的应用图标未读计数增加。
iOSSound
String
否
离线推送声音设置（仅对 iOS 生效）。 当 sound = IOS_OFFLINE_PUSH_NO_SOUND，表示接收时不会播放声音。 当 sound = IOS_OFFLINE_PUSH_DEFAULT_SOUND，表示接收时播放系统声音。 如果要自定义 iOSSound，需要先把语音文件链接进 Xcode 工程，然后把语音文件名（带后缀）设置给 iOSSound
androidSound
String
否
离线推送声音设置（仅对 Android 生效, IMSDK 6.1 及以上版本支持）。 只有华为和谷歌手机支持设置声音提示，小米手机设置声音提示，请您参照：小米自定义铃声。 另外，谷歌手机 FCM 推送在 Android 8.0 及以上系统设置声音提示，必须调用 setAndroidFCMChannelID 设置好 channelID，才能生效
androidOPPOChannelID
String
否
离线推送设置 OPPO 手机 8.0 系统及以上的渠道 ID
androidVIVOClassification
Number
否
VIVO 推送消息分类 (待废弃接口，VIVO 推送服务于 2023 年 4 月 3 日优化消息分类规则，推荐使用 setAndroidVIVOCategory 设置消息类别)。0：运营消息 1：系统消息，默认取值为 1
androidXiaoMiChannelID
String
否
小米手机 8.0 系统及以上的渠道 ID
androidFCMChannelID
String
否
FCM 通道手机 8.0 系统及以上的渠道 ID
androidHuaWeiCategory
String
否
华为推送消息分类，详见：华为消息分类标准﻿
isDisablePush
boolean
否
是否关闭推送（默认开启推送）
iOSPushType
﻿IOSOfflinePushType﻿
否
iOS 离线推送类型，默认：APNs
IOSOfflinePushType
iOS离线推送类型
类型
含义
APNs
普通推送
VoIP
VoIP 推送
MediaType
类型
含义
Audio
语音通话
Video
视频通话
Camera
前置/后置 摄像头
类型
含义
Front
前置摄像头
Back
后置摄像头
AudioPlaybackDevice
音频设备
类型
含义
Earpiece
听筒
Speakerphone
扬声器
FillMode
视频画面的渲染参数
类型
含义
Fill
填充模式：即将画面内容居中等比缩放以充满整个显示区域，超出显示区域的部分将会被裁剪掉，此模式下画面可能不完整。
Fit
适应模式：即按画面长边进行缩放以适应显示区域，短边部分会被填充为黑色，此模式下图像完整但可能留有黑边。
Rotation
视频画面旋转方向
类型
含义
Rotation_0
不旋转
Rotation_90
顺时针旋转90度
Rotation_180
顺时针旋转180度
Rotation_270
顺时针旋转270度
Resolution
视频分辨率
类型
含义
Resolution_640_360
宽高比 16:9；分辨率 640x360；建议码率（VideoCall）500kbps
Resolution_640_480
宽高比 4:3；分辨率 640x480；建议码率（VideoCall）600kbps
Resolution_960_540
宽高比 16:9；分辨率 960x540；建议码率（VideoCall）850kbps
Resolution_960_720
宽高比 4:3；分辨率 960x720；建议码率（VideoCall）1000kbps
Resolution_1280_720
宽高比 16:9；分辨率 1280x720；建议码率（VideoCall）1200kbps
Resolution_1920_1080
宽高比 16:9；分辨率 1920x1080；建议码率（VideoCall）2000kbps
ResolutionMode
视频宽高比模式
类型
含义
Landscape
横屏分辨率，例如：Resolution.Resolution_640_360 + ResolutionMode.Landscape = 640 × 360。
Portrait
竖屏分辨率，例如：Resolution.Resolution_640_360 + ResolutionMode.Portrait = 360 × 640。

帮助和支持

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

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

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

文档反馈

tencent cloud

实时音视频

关键类型

callParams

RoomId

OfflinePushInfo

IOSOfflinePushType

MediaType

Camera

AudioPlaybackDevice

FillMode

Rotation

Resolution

ResolutionMode

帮助和支持

参数	类型	是否必填	含义
roomId	RoomId	否	房间 ID，详情请参考 RoomId。
timeout	Number	否	通话超时时间，默认：40s，单位：秒。timeout = 0，设置为不超时
userData	String	否	发起通话时自定义扩展字段
offlinePushInfo	OfflinePushInfo	否	自定义离线消息推送参数
chatGroupId	String	否	与 chat 结合使用时， chat 群组的群 ID

类型	含义
Fill	填充模式：即将画面内容居中等比缩放以充满整个显示区域，超出显示区域的部分将会被裁剪掉，此模式下画面可能不完整。
Fit	适应模式：即按画面长边进行缩放以适应显示区域，短边部分会被填充为黑色，此模式下图像完整但可能留有黑边。

类型	含义
Rotation_0	不旋转
Rotation_90	顺时针旋转90度
Rotation_180	顺时针旋转180度
Rotation_270	顺时针旋转270度

类型	含义
Resolution_640_360	宽高比 16:9；分辨率 640x360；建议码率（VideoCall）500kbps
Resolution_640_480	宽高比 4:3；分辨率 640x480；建议码率（VideoCall）600kbps
Resolution_960_540	宽高比 16:9；分辨率 960x540；建议码率（VideoCall）850kbps
Resolution_960_720	宽高比 4:3；分辨率 960x720；建议码率（VideoCall）1000kbps
Resolution_1280_720	宽高比 16:9；分辨率 1280x720；建议码率（VideoCall）1200kbps
Resolution_1920_1080	宽高比 16:9；分辨率 1920x1080；建议码率（VideoCall）2000kbps

类型	含义
Landscape	横屏分辨率，例如：Resolution.Resolution_640_360 + ResolutionMode.Landscape = 640 × 360。
Portrait	竖屏分辨率，例如：Resolution.Resolution_640_360 + ResolutionMode.Portrait = 360 × 640。