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 政策
隐私协议
数据处理和安全协议
词汇表
文档实时音视频视频会议 SDK机器人推流(TUIRoomKit)

机器人推流(TUIRoomKit)

PDF
聚焦模式
字号
最后更新时间: 2026-01-29 17:15:37

功能介绍

TUIRoomKit 支持使用机器人推流,允许用户将本地或在线媒体文件推流至房间内。在某些场景中,会议中可能需要推送预先录制的教学视频或在线视频流到在线课堂中,以便用户观看和学习。TUIRoomKit 可以满足相关需求,实现自动化和高效的视频播放。
使用本功能,需开通 TUIRoomKit 包月套餐。接入的机器人推流会作为房间中的虚拟用户产生正常的通话费用,一条流是一个虚拟用户,详情参见 音视频时长计费说明;同时,接入机器人推流过程中会进行转码操作,从而产生转码费用,详情参见 云端混流转码计费说明




应用场景

一起看、一起听、一起玩、一起学等原来需要线下面对面才能实现的各种体验正被不断搬到线上。相隔千里还能和好友们一起看电影、一起听音乐,然后一起交流吐槽,这样神奇的实时互动体验正受到当下年轻人的喜爱,并成为如今音视频产品的重点玩法和主流方向。
TUIRoomKit 输入媒体流功能能够将外部媒体流共享至房间内,用户可通过这一功能向房间内其他用户分享音乐、电影、讲座、课程等媒体内容并同时与他们进行实时互动。平台可借助 TUIRoomKit 的这一新功能快速实现一起看场景。除了一起看电影、听音乐等场景外,TUIRoomKit 输入媒体流能力还能够在互动课堂、体育赛制、网络会议等场景中,为平台带来更多创新可能。




使用方法:使用 RTMP 推流

TUIRoomKit 支持 RTMP 标准协议推流。您可根据实际情况选择安装 OBS 、FFmpeg 或其他 RTMP 库进行推流。

使用FFmpeg推流

FFmpeg 不同场景下指令配置参数不同,因此需要您具有一定的 FFmpeg 使用经验,以下列出 FFmpeg 常用命令行选项,更多 FFmpeg 选项请参见 FFmpeg 官网

FFmpeg 命令行

ffmpeg [global_options] {[input_file_options] -i input_url} ... {[output_file_options] output_url}

常见的 FFmpeg 选项

选项
说明
-re
以 native 帧率读取输入,通常只用于读取本地文件
其中 output_file_options 可配置选项包括:
选项
说明
-c:v
视频编码,建议用 libx264
-b:v
视频码率,例如 1500k 表示 1500kbps
-r
视频帧率
-profile:v
视频 profile,指定 baseline 将不编码 B 帧,TUIRoomKit 后端不支持 B 帧
-g
GOP 帧数间隔
-c:a
音频编码,建议用 libfdk_aac
-ac
声道数,填2或1
-b:a
音频码率
-f
指定格式,固定填 flv,发送到 TUIRoomKit 使用 FLV 容器封装

使用

下面的例子是 使用 FFmpeg 命令读取文件推到 TUIRoomKit,注意 URL 两边加引号。
ffmpeg -loglevel debug -re -i sample.flv -c:v libx264 -preset ultrafast -profile:v baseline -g 30 -sc_threshold 0 -b:v 1500k -c:a libfdk_aac -ac 2 -b:a 128k -f flv 'rtmp://rtmp.rtc.qq.com/push/yourRoomId?userid=yourUserId&sdkappid=xxxxxxxxx&usersig=xxxxxxxxxx'
对上述命令中相关参数的解释如下:
参数
含义
-i sample.flv
需要推流至 TUIRoomKit 的媒体文件。您可以将 sample.flv 更换为您需要推流的本地或在线媒体文件。
yourRoomId
您需要推流的房间 ID。您需要将 yourRoomId 更换为您实际的 RoomId。
userId
您需要推流的 UserID。您需要将“=”后面的值更改为实际的 userId。
sdkappid
您的 sdkappid,您之前已在 开通服务 中获得。您需要将“=”后面的值更改为实际的 sdkAppID。
usersig
您的 usersig。您已在登录 TUIRoomKit 组件时获得。您需要将“=”后面的值更改为实际的 userSig。
当您需要在代码中实现上述功能时,可以使用您所在平台上的相关 FFmpeg 库或通过命令行调用 FFmpeg 来实现上述命令。

使用OBS推流

准备工作

安装并打开 OBS 工具进行下述操作。

步骤1:选择输入源

查看底部工具栏的来源标签,单击 + ,根据您的业务需要选择输入源。常用来源输入有:
输入源
说明
图像
适用于单张图像直播
图像幻灯片放映
可循环或者顺序多张播放图片
场景
实现各种强大的直播效果。此时,另一个场景是作为来源被添加进当前场景的,可以实现整个场景的插入
媒体源
可上传本地视频,并本地点播视频文件进行直播化处理
文本
实时添加文字在直播窗口中
窗口捕获
可根据您选择的窗口进行实时捕获,直播仅显示您当前窗口内容,其他窗口不会进行直播捕获
视频捕获设备
实时动态捕捉摄像设备,可将摄像后的画面进行直播
音频输入捕获
用于音频直播活动(音频输入设备)
音频输出捕获
用于音频直播活动(音频输出设备)




步骤2:设置推流参数

1. 通过底部工具栏的控件 > 设置按钮进入设置界面。
img


2. 单击推流进入推流设置页签,选择服务类型为自定义
3. 服务器填写:rtmp://rtmp.rtc.qq.com/push/
4. 填写串流密钥格式如下:
房间号?sdkappid=应用&userid=用户名&usersig=签名
其中房间号、应用、用户名、签名需要换成业务的,参考流地址生成章节。例如:
yourRoomId?sdkappid=140*****66&userid=******rtmp2&usersig=eJw1jdE***************ZLgi5UAgOzoMhrayt*cjbmiCJ699T09juc833IMT94Ld7I0iHZqVDzvVAqkZsG-IKlzLiXOnEhswHu1iUyTc9pv*****D8MQwoA496Ke6U1ip4EAH4UMc5H9pSmv6MeTBWLamhwFnWRBZ8qKGRj8Yp-wVbv*mGMVZqS7w-mMDQL




步骤3:设置输出

RTMP 后台不支持传输 B 帧,用户可以通过如下设置调整推流端软件的视频编码参数来去除 B 帧。
1. 设置中单击输出页签进行配置。
2. 输出模式中选择高级关键帧间隔建议填写1或2,CPU 使用预设为 ultrafast,配置选择 baseline,微调选择 zerolatency,x264 选项填写 threads=1,单击确定保存设置。
警告:
推流需要去除 B 帧,否则推流后连接会被断开,下面的配置选择 baseline 可去除 B 帧。




步骤4:设置视频选项

设置中单击视频页签,设置分辨率和帧率。分辨率决定了观众看到的画面清晰程度,分辨率越高画面越清晰。FPS 是视频帧率,它控制观看视频的流畅,普通视频帧率有24帧 - 30帧,低于16帧画面看起来有卡顿感,而游戏对帧率要求比较高,一般小于30帧游戏会显得不连贯。



步骤5:设置高级选项

建议不启用串流延迟以减少端到端延迟。
启动自动重连,建议设置重试延迟时长尽量短,网络抖动时如果连接断开可尽快重连上。



步骤6:单击推流

1. 查看 OBS 底部工具栏的控件,单击开始推流


2. 推流成功后,正常情况在界面底部会展示推流状态,控制台仪表盘 上有该用户进房记录。



帮助和支持

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

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

文档反馈