实时音视频 新手常见问题 - 快速入门

什么是 UserSig？

UserSig 是腾讯云设计的一种安全保护签名，目的是为了阻止恶意攻击者盗用您的云服务使用权。
目前，腾讯云的实时音视频（TRTC）、即时通信（IM）以及移动直播（MLVB）等服务都采用了该套安全保护机制。要使用这些服务，您都需要在相应 SDK 的初始化或登录函数中提供 SDKAppID，UserID 和 UserSig 三个关键信息。
其中 SDKAppID 用于标识您的应用，UserID 用于标识您的用户，而 UserSig 则是基于前两者计算出的安全签名，它由 HMAC SHA256 加密算法计算得出。只要攻击者不能伪造 UserSig，就无法盗用您的云服务流量。
UserSig 的计算原理如下图所示，其本质就是对 SDKAppID、UserID、ExpireTime 等关键信息进行了一次哈希加密：

//UserSig 计算公式，其中 secretkey 为计算 usersig 用的加密密钥
usersig = hmacsha256(secretkey, (userid + sdkappid + currtime + expire + 
                                base64(userid + sdkappid + currtime + expire)))

实时音视频最多可以同时创建多少个房间？

支持同时并发存在4294967294个房间，累计房间数量无限制。

实时音视频延时大约多少？

全球端到端平均延时小于300ms。

实时音视频接入 PC 端是否支持屏幕分享功能？

支持，您可以参考如下文档：

• 屏幕分享（Windows）
• 屏幕分享（Mac）
• 屏幕分享（桌面浏览器）

屏幕分享接口详情请参见 Windows（C++）API 或 Windows（C#）API。另外，您也可以使用 Electron 接口。

TRTC 支持哪些平台？

支持的平台包括 iOS、Android、Windows(C++)、Windows(C#)、Mac、桌面浏览器、Electron、微信小程序，更多详情请参见 平台支持。

实时音视频最多可以支持多少个人同时通话？

• 通话模式下，单个房间最多支持300人同时在线，最多支持50人同时开启摄像头或麦克风。
• 直播模式下，单个房间支持10万人以观众身份在线观看，最多支持50人以主播身份开启摄像头或麦克风。

TRTC 怎么实现直播场景类应用？

TRTC 专门针对在线直播场景推出了10万人低延时互动直播解决方案，能保证主播与连麦主播的最低延时到200ms，普通观众的延时在1s以内，并且超强的抗弱网能力适应移动端复杂的网络环境。
具体操作指引请参考 跑通直播模式。

TRTC 直播支持什么角色？有什么区别？

直播场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom）支持 TRTCRoleAnchor（主播）和 TRTCRoleAudience（观众）两种角色，区别是主播角色可以同时上行、下行音视频数据，观众角色只支持下行播放其他人的数据。您可以通过调用 switchRole() 进行角色切换。

TRTC 房间支不支持踢人、禁止发言、静音？

支持。

• 如果是简单的信令操作，可以使用 TRTC 的自定义信令接口 sendCustomCmdMsg，开发者自己定义相应的控制信令，收到控制信令的通话方执行对应操作即可。例如，踢人就是定义一个踢人的信令，收到此信令的用户就自行退出房间。
• 如果是需要实现更完善的操作逻辑，建议开发者通过 即时通信 IM 来实现相关逻辑，将 TRTC 的房间与 IM 群组进行映射，在 IM 群组中收发自定义消息来实现相应的操作。

TRTC 音视频流是否支持通过 CDN 拉流观看？

支持，详情请参见 实现 CDN 直播观看。

在 iOS 端是否支持 Swift 集成？

支持，直接按照支持集成三方库的流程集成 SDK 即可，还可以参考 跑通Demo(iOS&Mac)。

桌面浏览器端 SDK 的支持哪些浏览器？

目前主要在桌面版 Chrome 浏览器、桌面版 Safari 浏览器以及移动版的 Safari 浏览器上有较为完整的支持，其他平台（例如 Android 平台的浏览器）支持情况均比较差，具体详情请参见 支持的平台。
您可以在浏览器打开 WEBRTC 能力测试 测试是否完整的支持 WebRTC 的功能。

桌面浏览器端 SDK 日志中报错 NotFoundError、NotAllowedError、NotReadableError、OverConstrainedError 以及 AbortError 分别是什么意思？

更多详情请参考 initialize。

怎么确认桌面浏览器端 SDK 是否能正常获取到设备（摄像头/麦克风）列表？

1. 检查浏览器是否能够正常使用设备：
   直接在页面打开控制台，输入 navigator.mediaDevices.enumerateDevices() 确认能否获取到设备列表。
   • 如果正常获取到设备会返回一个 Promise，里面会有 MediaDeviceInfo 对象数组，数组里的每个对象对应一个可用的媒体设备。
   • 如果枚举失败，Promise 将返回 rejected，说明浏览器都没有识别到设备，需检查浏览器或设备。
2. 如果能获取设备列表，则输入 navigator.mediaDevices.getUserMedia({ audio: true, video: true }) 确认能否正常返回 MediaStream 对象，不能正常返回说明浏览器没有获取到数据，需检查浏览器的配置。

小程序端集成实时音视频 SDK 前需要做哪些准备工作？

1. 创建腾讯云实时音视频应用，购买相应的套餐，并获取到 SDKAppID 和密钥信息。
2. 小程序服务器域名配置。
3. 开通小程序类目与推拉流标签权限。
   出于政策和合规的考虑，微信暂未放开所有小程序对实时音视频功能（即 <live-pusher> 和 <live-player> 标签）的支持：
   • 小程序推拉流标签不支持个人小程序，只支持企业类小程序。
   • 小程序推拉流标签使用权限暂时只开放给有限 类目。
   • 符合类目要求的小程序，需要在【微信公众平台】>【开发】>【接口设置】中自助开通该组件权限，如下图所示：
     

更多详情请参见 跑通Demo(小程序) 和 快速集成(小程序)。

小程序端运行出错，该如何排查？

1. 请检查开通的小程序类目是否正确，<live-pusher> 和 <live-player> 标签是否已开启。
2. 请确认已将 小程序域名白名单 添加到小程序 request 合法域名，或已开启调试模式。
3. 请重新解压小程序端 Demo 直接运行，若运行正常，建议参考 快速集成(小程序) 重新集成 SDK。
4. 若问题依然存在，可以登录 微信小程序开发者社区 查找相关资料，也可以 提交工单 或致电 4009100100 联系我们。

直播、互动直播、实时音视频以及旁路直播有什么区别和关系？

• 直播（关键词：一对多，RTMP/HLS/HTTP-FLV，CDN）
  直播分为推流端、播放端以及直播云服务，云服务使用 CDN 进行直播流的分发。推流使用的是通用标准的协议 RTMP，经过 CDN 分发后，播放时一般可以选择 RTMP、HTTP-FLV 或 HLS（H5 支持）等方式进行观看。
• 互动直播（关键词：连麦、PK）
  互动直播是一种业务形式，指主播与观众之间进行互动连麦，主播与主播之间进行互动PK的一种直播类型。
• 实时音视频（关键词：多人互动，UDP 私有协议，低延时）
  实时音视频（Real-Time Communication, RTC）主要应用场景是音视频互动和低延时直播，使用基于 UDP 的私有协议，其延迟可低至100ms，典型的场景就是 QQ 电话、腾讯会议、大班课等。 腾讯云实时音视频（TRTC）覆盖全平台，除了 iOS/Android/Windows 之外，还支持小程序以及 WebRTC 互通，并且支持通过云端混流的方式将画面旁路直播到 CDN。
• 旁路直播（关键词：云端混流，RTC 旁路转推，CDN）
  旁路直播是一种技术，指的是将低延时连麦房间里的多路推流画面复制出来，在云端将画面混合成一路，并将混流后的画面推流给直播 CDN 进行分发播放。

TRTC 如何查看通话时长和使用量？

可在实时音视频控制台的【用量统计】页面查看。

TRTC 出现卡顿怎么排查？

可以通过对应的 RoomID、UserID 在实时音视频控制台的【监控仪表盘】页面查看通话质量：

• 通过接受端视角查看发送端和接收端用户情况。
• 查看发送端和接收端是否丢包率比较高，如果丢包率过高一般是网络状况不稳定导致卡顿。
• 查看帧率和 CPU 占用率，帧率比较低和 CPU 使用率过高都会导致卡顿现象。

TRTC 出现画质不佳，模糊、马赛克等现象怎么排查？

• 清晰度主要和码率有关，检查 SDK 码率是否配置的比较低，如果高分辨率低码率容易产生马赛克现象。
• TRTC 会通过云端 QOS 流控策略，根据网络状况动态调整码率、分辨率，网络比较差时容易降低码率导致清晰度下降。
• 检查进房时使用的 VideoCall 模式还是 Live 模式，针对通话场景 VideoCall 模式主打低延时和保流畅，所以在弱网情况下会更容易牺牲画质确保流畅，对画质更加看重的场景建议使用 Live 模式。

如何查询 SDK 最新版本号？

• 若您使用自动加载的方法，latest.release 为匹配最新版并进行自动加载，不需要对版本号进行修改。具体集成方法请参见 一分钟集成 SDK。
• 当前 SDK 最新版本号可通过发布日志查看，具体请参见：
  • iOS & Android 端，请参见 发布日志（App）。
  • 桌面浏览器端，请参见 发布日志（桌面浏览器）。
  • Electron 端，请参见 发布日志（Electron）。