- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
一、视频问题
TRTC 视频画面出现黑边怎么去掉？
设置 TRTCVideoFillMode_Fill（填充）即可解决，TRTC 视频渲染模式分为填充和适应，本地渲染画面可以通过 setLocalViewFillMode() 设置，远端渲染画面可以通过 setRemoteViewFillMode 设置：
- TRTCVideoFillMode_Fill：图像铺满屏幕，超出显示视窗的视频部分将被截掉，所以画面显示可能不完整。
- TRTCVideoFillMode_Fit：图像长边填满屏幕，短边区域会被填充黑色，但画面的内容肯定是完整的。
TRTC 出现卡顿怎么排查？
可以通过对应的 RoomID、UserID 在实时音视频控制台的 监控仪表盘 页面查看通话质量：
- 通过接受端视角查看发送端和接收端用户情况。
- 查看发送端和接收端是否丢包率比较高，如果丢包率过高一般是网络状况不稳定导致卡顿。
- 查看帧率和 CPU 占用率，帧率比较低和 CPU 使用率过高都会导致卡顿现象。
TRTC 出现画质不佳，模糊、马赛克等现象怎么排查？
- 清晰度主要和码率有关，检查 SDK 码率是否配置的比较低，如果高分辨率低码率容易产生马赛克现象。
- TRTC 会通过云端 QOS 流控策略，根据网络状况动态调整码率、分辨率，网络比较差时容易降低码率导致清晰度下降。
- 检查进房时使用的 VideoCall 模式还是 Live 模式，针对通话场景 VideoCall 模式主打低延时和保流畅，所以在弱网情况下会更容易牺牲画质确保流畅，对画质更加看重的场景建议使用 Live 模式。
TRTC 自己的本地画面和远端画面左右相反？
本地默认采集的画面是镜像的。App 端可以通过 setLocalViewMirror 接口设置，该接口只改变本地摄像头预览画面的镜像模式；也可以通过 setVideoEncoderMirror 接口设置编码器输出的画面镜像模式，该接口不改变本地摄像头的预览画面，但会改变另一端用户看到的（以及服务器录制下来的）画面效果。Web 端可以通过 createStream 接口修改 mirror 参数来设置。
TRTC 设置视频编码输出的方向没有效果？
需要设置 setGSensorMode() 为 TRTCGSensorMode_Disable，关闭重力感应，否则调用 setVideoEncoderRotation 后远端用户观看到的画面不会变化。
TRTC 正常上行有数据，为什么旁路拉流失败看不到画面？
请确认是否已在 应用管理>功能配置 中开启自动旁路推流。
预览/播放画面出现旋转？
- 使用 TRTCSDK 摄像头采集：
- 建议更新 SDK 版本到最新版本。
- 如果是特殊设备，可以使用本地预览画面渲染角度接口
setLocalViewRotation，远端视频画面的渲染角度接口setRemoteViewRotation，设置编码器输出的画面渲染角度接口setVideoEncoderRotation进行调整。具体接口使用说明请参见 视频画面旋转。
- 使用自定义视频采集：
- 建议更新 SDK 版本到最新版本。
- 确认下将采集的视频画面的角度是正确。
- 将视频数据填充给 TRTCSDK，检查是否给
TRTCCloudDef.TRTCVideoFrame设置旋转角度 - 如果是特殊设备，可以使用本地预览画面渲染角度接口
setLocalViewRotation，远端视频画面的渲染角度接口setRemoteViewRotation，设置编码器输出的画面渲染角度接口setVideoEncoderRotation进行调整。具体接口使用说明请参见 视频画面旋转。
视频出现镜像问题？
使用前摄像头进行视频通话，会有镜像效果，所以本地预览和远端观众画面是左右颠倒。
如何横屏推流？
开发者可能用设备是电视或者因场景需要横屏推流，具体实现请参见视频画面旋转和缩放
直播中出现播放黑屏是什么原因呢？
- 播放失败或解码失败，参看播放失败的处理办法。
- Metadata 问题，例如 metadata 中只有音频流信息，但实际数据中即有音频也有视频;或者是开始的数据只有音频，但播放一段时间后又加入了视频信息。这种情况一般建议修改源流的 metadata 信息。
- 视频编码数据里没有画面信息，只有类似 SEI 之类的帧时，解码也没有画面，自然就黑屏了，这种一般是定制类的视频数据。
直播中出现播放花屏、绿屏，是什么原因呢？
- 一般是丢失了 I 帧导致，因为 P 帧和 B 帧的解码都依赖于 I 帧，如果 I 帧丢失了，P 帧和 B 帧都会解码失败，于是画面就会花屏、拖影、绿屏等情况，先使用不同 播放器如 ffplay、VLC、Potplayer 同时播放一下同一路流，如果播放器都出现花 屏、绿屏的情况，通常就是音视频源码流就存在问题，需要检查源码流。
- Metadata 发生变化，大多数的播放器一般只会在开始解码之前解析一次 metadata 设置解码参数，当画面发生变化，例如分辨率变化了，但播放器解码参 数没有重新配置，就有可能导致花屏、绿屏，这种情况下，最好的办法是推流端 在直播过程中不改变编码参数，这样就不会引起 metadata 信息的修改。
- 硬件编解码的兼容性问题，这类情况通常出现在 Android 设备上，一些 Android 设备的硬件编解码器实现不好，兼容性不佳。这种情况，最好的办法，换软编软 解对比。
- 推流端和播放端颜色格式不一致导致，例如推流端使用的是 NV12，而播放端支持的是 I420，则解码时就会因为颜色格式不一致而显示为花屏、绿屏等情况。这 种情况下，统一推拉流两端的颜色格式。
二、音频问题
TRTC 的通话同时用了点播播放器 TXVodPlayer 播放，为什么播放声音很小？
通过 setSystemVolumeType 接口设置通话时使用的系统音量类型，设置为媒体音量模式 TRTCSystemVolumeTypeMedia 即可解决。
如何选择媒体音量和通话音量？
通过 setSystemVolumeType 接口，支持自主选择通话音量和媒体音量。
- TRTCAudioVolumeTypeAuto ：默认类型，麦上通话音量、麦下媒体音量。
- TRTCAudioVolumeTypeVOIP ：始终使用通话音量。
- TRTCAudioVolumeTypeMedia ：始终使用媒体音量。
声音小怎么处理？
- 若所有观众听到的声音都小，则是上行因素导致：
- 检查 Windows 和 mac 的 setCurrentDeviceVolume、全平台的 setAudioCaptureVolume 接口的 volume值是否小于50，可以适当调大音量。
- 检查3A处理的 AGC 自动增益是否开启。
- 检查是否是由于蓝牙耳机导致。
- 若部分观众听到声音小，则是下行因素导致：
- 检查 setAudioPlayoutVolume、setCurrentDeviceVolume 接口的 volume 值是否小于50，可以适当调大音量。
- 手机端可以检查是否调用 setAudioRoute API 切换了听筒播放。
声音卡顿断续？
打开 监控仪表盘，在音频选项卡中查看：
- 若接收端和发送端“设备状态”的 CPU 超过90%，建议关闭其他后台程序。
- 若音频上下行存在明显丢包，rtt 值波动较大，表明当前用户网络质量不佳，建议切换稳定网络。
为什么有回声？
通话双方的设备相距太近的时候，属于正常现象，测试时请相互距离远一点；是否误关了 3A 处理的 AEC 回声消除。
声音音质差或者声音忽大忽小？
若您外接了声卡，开了耳返，当连麦时就会引发此问题，建议您在外接声卡时关闭耳返，因为声卡一般自带了耳返功能。
Web 通话过程中出现回声、杂音、噪声、声音小？
通话双方的设备相距太近的时候，属于正常现象，测试时请相互距离远一点。当其他端听到 Web 端的声音存在回声、噪声、杂音等情况时，说明 Web 端的 3A 处理没有生效。 若您使用了浏览器原生 getUserMedia API 进行自定义采集，则需要手动设置 3A 参数：
- echoCancellation：回声消除开关。
- noiseSuppression：噪声抑制开关。
- autoGainControl：自动增益开关。
若您使用 TRTC.createStream 接口进行采集，则无需手动设置 3A 参数，SDK 默认开启 3A。
三、其他问题
TRTC 怎么监测网络状态，实现信号强弱展示功能？
可以使用 onNetworkQuality() 监听当前网络的上行和下行质量，以Android为例，可参考 TRTC-API-Example 实现信号强弱功能。
为什么设备摄像头或麦克风出现被占用等异常现象？
调用 exitRoom() 接口会执行退出房间的相关逻辑，例如释放音视频设备资源和编解码器资源等，硬件设备的释放是异步操作，待资源释放完毕，SDK 会通过 TRTCCloudListener 中的 onExitRoom() 回调通知上层。如果您要再次调用 enterRoom() 或切换到其他的音视频 SDK，请等待 onExitRoom() 回调到来之后再执行相关操作。
如何判断打开摄像头成功？
通过回调方法 onCameraDidReady，当收到该回调时表示摄像头已经准备就绪。
如何判断打开麦克风成功？
通过回调方法 onMicDidReady，当收到该回调时表示麦克风已经准备就绪。
打开摄像头失败？
- 确认摄像头权限是否授予
- 如果设备是电视、盒子等，使用的摄像头是外接的。目前 TRTCSDK 是支持识别外接摄像头的。因此，需要确认摄像头接头和设备是否接触良好。
TRTC 有哪些技术统计指标？
注意：该场景适用于 iOS/Mac、Android 、Windows 平台。
SDK 提供回调方法 onStatistics(TRTCStatistics statics)，每 2 秒回一次技术指标。包括当前 appCpu（App 的 CPU 使用率）、systemCpu（当前系统的 CPU 使用率）、rtt（延迟）、upLoss（上行丢包率）、downLoss（下行丢包率）以及本地成员和远端成员的音视频统计信息，具体参数请参见 TRTCStatistics 类型说明。
是
否
本页内容是否解决了您的问题？