tencent cloud

实时音视频

动态与公告
产品动态
产品近期公告
关于 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
聚焦模式
字号
最后更新时间: 2023-09-27 11:28:24

耳返相关问题

K 歌场景大概率会用到耳返,如何开启耳返功能?

mTRTCCloud.getAudioEffectManager().enableVoiceEarMonitor(true)

开启耳返功能后没有效果?

由于蓝牙耳机的硬件延迟非常高,请尽量在用户界面上提示主播佩戴有线耳机。 同时也需要注意,并非所有的手机开启此特效后都能达到优秀的耳返效果,TRTC SDK 已经对部分耳返效果不佳的手机屏蔽了该特效。

耳返延迟过高?

请检查是否使用的是蓝牙耳机,由于蓝牙耳机的硬件延迟非常高,请尽量使用有线耳机。 另外,可以尝试通过实验性接口 setSystemAudioKitEnabled 开启硬件耳返来改善耳返延迟过高的问题。目前,对于华为和 Vivo设备,SDK 默认使用硬件耳返,其他设备默认使用软件耳返。
// 开启硬件耳返
mTRTCCloud.callExperimentalAPI("{\\"api\\":\\"setSystemAudioKitEnabled\\", \\"params\\": {\\"enable\\":1}}");

NTP 校时问题

提醒:“NTP time sync finished, but result maybe inaccurate”?

NTP 校时成功,但偏差可能在30ms以上,反映客户端网络环境差,rtt 持续抖动。

提醒:“Error in AddressResolver: No address associated with hostname”?

NTP 校时失败,可能是当前网络环境下本地运营商 DNS 解析暂时异常,请稍后再试。

NTP 服务重试处理逻辑?





网络测速建议

在线 K 歌场景对用户的网络条件要求较高,特别是实时合唱,优质稳定的网络环境才能保障良好的 K 歌体验。因此,建议在用户进入房间前对该用户进行一次网络测速,对网络条件不符合要求的用户给予 UI 层的提醒,禁止其加入 K 歌房或参与合唱。 TRTC SDK 网络测速的发起:
TRTCCloudDef.TRTCSpeedTestParams speedTestParams = new TRTCCloudDef.TRTCSpeedTestParams();
speedTestParams.sdkAppId = SDK_APP_ID;
speedTestParams.userId = userId;
speedTestParams.userSig = userSig;
// 若实际带宽高于预期值,则测试结果即为预期值;若实际带宽低于预期值,则测试结果为实际带宽值
speedTestParams.expectedDownBandwidth = 3000; // 预期的下行带宽,取值范围 10~5000 kbps
speedTestParams.expectedUpBandwidth = 3000; // 预期的上行带宽,取值范围 10~5000 kbps
mTRTCCloud.startSpeedTest(speedTestParams);
注意:
同一时间只允许一项网速测试任务运行;
请在进入房间前进行网速测试,在房间中网速测试会影响正常的音视频传输效果,而且由于干扰过多,网速测试结果也不准确。
TRTC SDK 网络测速结果的回调:
@Override
public void onSpeedTestResult(TRTCCloudDef.TRTCSpeedTestResult result) {
String tquality = "未定义";
switch (result.quality) {
case 0: tquality = "未定义";
break;
case 1: tquality = "当前网络非常好";
break;
case 2: tquality = "当前网络比较好";
break;
case 3: tquality = "当前网络一般";
break;
case 4: tquality = "当前网络较差";
break;
case 5: tquality = "当前网络很差";
break;
case 6: tquality = "当前网络不满足 TRTC 的最低要求";
break;
}
if (result.success) {
mTextTestResult.append("测速成功!" + "\\n");
mTextTestResult.append("IP 地址:" + result.ip + "\\n");
mTextTestResult.append("上行丢包率:" + result.upLostRate + "\\n");
mTextTestResult.append("下行丢包率:" + result.downLostRate + "\\n");
mTextTestResult.append("网络延迟:" + result.rtt + "ms\\n");
mTextTestResult.append("下行带宽:" + result.availableDownBandwidth + "kbps\\n");
mTextTestResult.append("上行带宽:" + result.availableUpBandwidth + "kbps\\n");
mTextTestResult.append("网络质量:" + tquality + "\\n");
} else {
mTextTestResult.append("测速失败!" + "\\n");
mTextTestResult.append("errMsg:" + result.errMsg + "\\n");
}
}

中途加入合唱

实时合唱方案理论上对合唱者数量没有限制,支持多人同时参与合唱,也支持中途加入合唱。 下面列出中途加入合唱的关键动作:
NTP 校时
开启合唱实验性接口
进入房间并上麦推流
接收合唱信令,获取伴奏资源及合唱约定时间
计算约定时间与当前时间差,预加载 seek 伴奏
开始参与合唱,并实时同步伴奏进度及歌词进度
以上关键动作涉及的具体实现流程及代码实现详见歌曲同步歌词同步人声同步文档。

帮助和支持

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

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

文档反馈