RTC Engine
  • 产品概述
  • Web
    • 跑通 Demo
    • SDK 快速启动
    • 基础功能
      • 屏幕分享
      • 直播
      • 媒体设备
      • 音量
      • 设置编码配置文件
      • 检测网络质量
      • 检测能力
    • 高级功能
      • 启用 AI 降噪
      • 启用混音
      • 启用水印
      • Enable Virtual Background
      • 启用美颜和特效
      • 数据消息
      • 自定义采集和渲染
    • 接口列表
    • 发布说明
    • 支持平台
    • Web 常见问题
      • 优化多人视频通话
      • 处理自动播放受限
      • 应对防火墙限制
      • 其他
  • Android
    • Run Sample Code
    • Integration
    • 集成
      • 7. 检测网络质量
      • 8. 开启屏幕共享
      • 9. 设置视频质量
      • 10. 旋转视频
    • Advanced Features
      • 测试网络质量
      • 自定义采集和渲染
      • 自定义音频采集和播放
    • 客户端API
      • 产品概述
      • TRTCCloud
      • TRTCStatistics
      • TRTCCloudListener
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • 类型定义
      • 废弃接口
      • 错误码
    • 解决方案
      • 实时合唱 (TUIKaraoke)
        • 快速集成
        • 实施步骤
        • 歌曲同步
        • 歌词同步
        • 语音同步
        • 混流解决方案
        • TRTCKaraoke 相关接口
        • 常见问题
    • 发布说明
  • iOS
    • Run Sample Code
    • Integration
    • 集成
      • 7. 检测网络质量
      • 8. 开启屏幕共享
      • 9. 设置视频质量
      • 10. 旋转视频
    • Advanced Features
      • 测试网络质量
      • 自定义采集和渲染
      • 自定义音频采集和播放
    • 客户端API
      • 产品概述
      • TRTCCloud
      • TRTCCloudDelegate
      • TRTCStatistics
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • 类型定义
      • 废弃接口
      • ErrorCode
    • 解决方案
      • 快速集成
      • 实施步骤
      • 歌曲同步
      • 歌词同步
      • 语音同步
      • 混流解决方案
      • TRTCKaraoke 相关接口
      • 常见问题
    • 发布说明
  • macOS
    • Run Sample Code
    • Integration
    • 集成
      • 7. 检测网络质量
      • 8. 开启屏幕共享
      • 9. 共享电脑声音
      • 10. 设置视频质量
      • 11. 旋转视频
    • Advanced Features
      • 测试硬件设备
      • 测试网络质量
      • 自定义采集和渲染
      • 自定义音频采集和播放
    • 客户端API
      • 产品概述
      • TRTCCloud
      • TRTCCloudDelegate
      • TRTCStatistics
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • 类型定义
      • 废弃接口
      • ErrorCode
      • 发布说明
    • 发布说明
  • Windows
    • Run Sample Code
    • Integration
    • 集成
      • 7. 检测网络质量
      • 8. 开启屏幕共享
      • 9. 设置视频质量
      • 10. 旋转视频
    • Advanced Features
      • 测试硬件设备
      • 测试网络质量
      • 自定义采集和渲染
      • 自定义音频采集和播放
    • 客户端API
      • 产品概述
      • ITRTCCloud
      • ITRTCStatistics
      • TRTCCloudCallback
      • ITXAudioEffectManager
      • ITXDeviceManager
      • 类型定义
      • 废弃接口
      • 错误码
    • 发布说明
  • Electron
    • 集成
      • 1. 接口示例
      • 2. 导入 SDK
      • 3. 进入房间
      • 4. 订阅音视频流
      • 5. 发布音视频流
      • 6. 退出房间
      • 7. 检测网络质量
      • 8. 开启屏幕共享
      • 9. 共享电脑声音
      • 10. 设置视频质量
      • 11. 旋转视频
    • 客户端API
      • 产品概述
      • 错误码
  • Flutter
    • 集成
      • 1. 接口示例
      • 2. 导入 SDK
      • 3. 进入房间
      • 4. 订阅音视频流
      • 5. 发布音视频流
      • 6. 退出房间
      • 7. 检测网络质量
      • 8. 开启屏幕共享
      • 9. 共享电脑声音
      • 10. 设置视频质量
      • 11. 旋转视频
    • 客户端API
      • 产品概述
      • 错误码
  • Unity
    • 集成
      • 1. 接口示例
      • 2. 导入 SDK
    • 客户端API
      • 产品概述
      • 错误码
  • QT
    • 集成
      • 1. 导入 SDK
  • 产品概述
    • 产品概述
  • 概念
  • 产品特性
  • 性能统计
  • 价格中心
    • 免费时长
    • RTC-Engine 套餐
    • 订阅套餐时长计费说明
    • 现收现付
      • 音视频时长计费说明
      • 云端录制计费说明
      • 混流转码与旁路转推计费说明
  • 常见问题
    • 入门常见问题
    • 迁移指南
      • Twilio Video 到 TRTC 的迁移
      • 计费
      • 产品特性
      • UserSig
      • 防火墙限制
      • 如何缩减安装包
      • TRTCCalling Web 相关
      • 音视频质量
      • 其他
RTC Engine

接口列表

API 介绍

TRTC

注意:
本文适用于 5.x.x 版本的 TRTC Web SDK。
TRTC 对象通过调用 TRTC.create() 方法创建,提供实时音视频的核心能力:
进入一个音视频房间,调用 trtc.enterRoom() 方法。
退出当前音视频房间,调用 trtc.exitRoom() 方法。
预览/发布本地视频,调用 trtc.startLocalVideo() 方法。
采集/发布本地音频,调用 trtc.startLocalAudio() 方法。
取消预览/发布本地视频,调用 trtc.stopLocalVideo() 方法。
取消采集/发布本地音频,调用 trtc.stopLocalAudio() 方法。
观看远端视频,调用 trtc.startRemoteVideo() 方法。
取消观看远端视频,调用 trtc.stopRemoteVideo() 方法。
静默/取消静默远端音频,调用 trtc.muteRemoteAudio() 方法。

静态方法

API
描述
create
创建一个 TRTC 对象,用于实现进房、预览、推流、拉流等功能。
设置日志输出等级建议在开发测试阶段设置为 DEBUG 等级,该日志等级包含详细的提示信息。默认输出 INFO 日志等级,该日志等级包含 SDK 主要功能的日志信息。
检测 TRTC Web SDK 是否支持当前浏览器
返回摄像头设备列表
返回麦克风设备列表
返回扬声器设备列表,出于安全的考虑,在用户未授权摄像头或麦克风访问权限前,label 及 deviceId 字段可能都是空的。因此建议在用户授权访问后再调用该接口获取设备详情。
设置当前音频播放的扬声器

成员方法

创建实例后调用。
API
描述
enterRoom
进入一个音视频通话房间(以下简称"进房")。
exitRoom
退出当前音视频通话房间。
切换用户角色,仅在 TRTC.TYPE.SCENE_LIVE 互动直播模式下生效。
destroy
销毁 TRTC 实例
开启本地麦克风采集,并发布到当前的房间中。
更新本地麦克风配置。
停止本地麦克风的采集及发布。
开启本地摄像头采集,在您指定的 HTMLElement 标签下播放摄像头画面,并将摄像头画面发布到当前所在房间中。
更新本地摄像头配置。
停止本地摄像头的采集、预览及发布。
开启屏幕分享。
更新屏幕分享配置
停止屏幕分享。
播放远端视频
更新远端视频播放配置
用于停止远端视频播放。
静音某个远端用户,并且不再拉取该用户的音频数据。仅对当前用户有效,房间内的其他用户依然可以听到被静音用户的声音。
用于控制远端音频的播放音量。
开启或关闭音量大小回调
on
监听 TRTC 事件详细事件列表请参见:TRTC.EVENT
off
取消事件监听
获取视频截图
获取视频轨道
获取音频轨道
发送 SEI 消息
发送自定义消息
开启插件
更新插件
停止插件

教程

您可以参考如下教程实现各种功能:
功能
Sample Code 指引
基础音视频通话
实现互动直播连麦
切换摄像头和麦克风
设置本地视频属性
开关摄像头、麦克风
屏幕分享
音量大小检测
自定义采集与自定义播放渲染
房间内上行用户个数限制
通话前环境与设备检测
通话前的网络质量检测
设备插拔检测及采集异常处理
开启水印

最佳实践

最佳实践
指引链接
多人视频通话
自动播放处理建议
应对防火墙受限
说明:
常见问题参见 Web 端相关

支持的平台

TRTC Web SDK 基于 WebRTC 实现,目前支持桌面端和移动端的主流浏览器,详细支持度参见下方表格。理论上来说, SDK 支持所有基于 Chromium 56+ 版本的浏览器。
如果您的应用场景不在支持的表格里,可以使用 TRTC.isSupported() 接口 或者打开 TRTC Web SDK 能力检测页面 检测当前环境是否支持 WebRTC 所有能力。
操作系统
浏览器类型
浏览器最低版本要求
接收(播放)
发送(推流)
屏幕分享
Windows
Chrome
56+
支持
支持
Chrome 72+
Firefox
56+
支持
支持
Firefox 66+
Edge
80+
支持
支持
支持
Opera
46+
支持
支持
Opera 60+
MacOS
Chrome
56+
支持
支持
Chrome 72+
Safari
11+
支持
支持
Safari 13+
Edge
80+
支持
支持
支持
Firefox
56+
支持
支持
Firefox 66+
Android
Chrome
69+
支持
支持
不支持
Edge
80+
支持
支持
不支持
Firefox
56+
支持
支持
不支持
Opera
46+
支持
支持
不支持
iOS
Chrome
iOS 11+
支持
iOS 14.3+
不支持
Safari
iOS 11+
支持
支持
不支持
Edge
iOS 11+
支持
iOS 14.3+
不支持
Firefox
iOS 11+
支持
iOS 14.3+
不支持
注意
1. 由于 H.264 版权限制,华为 Chrome 88 以下版本以及部分厂商的 Android 设备,不具备 H264 编码能力(即无法推流)。如果您希望在这些设备的浏览器中,使用 TRTC Web SDK 推流,请 联系我们 开通 VP8 编解码能力。
2. Mac OS 下的
Firefox
屏幕分享效果比较差且暂无解决方案,建议使用 Chrome 或者 Safari 进行屏幕分享。
3. 建议您及时将 TRTC Web SDK 更新至最新版本,以便获得更好的产品稳定性及在线支持。版本升级注意事项请参见:升级指引

URL 域名协议限制

由于浏览器安全策略的限制,使用 WebRTC 能力对页面的访问协议有严格的要求,请参照以下表格进行开发和部署应用。
应用场景
协议
接收(播放)
发送(上麦)
屏幕分享
备注
生产环境
HTTPS 协议
支持
支持
支持
推荐
生产环境
HTTP 协议
支持
不支持
不支持
-
本地开发环境
http://localhost
支持
支持
支持
推荐
本地开发环境
http://127.0.0.1
支持
支持
支持
-
本地开发环境
http://[本机IP]
支持
不支持
不支持
-
本地开发环境
file:///
支持
支持
支持
-

联系我们

telegramgithub 联系我们。