文档中心

实时音视频

开发指南

推送在线媒体流至RTC 房间或 WTN

你可以在服务端将第三方在线媒体流（如 RTMP 直播流、HLS 点播文件等）推送到 RTC 房间或推送到 WTN 进行大规模超低延时分发。

应用场景

典型应用场景如下：

一起看：在语聊房或视频房中，同步播放电影、短剧或体育赛事直播，实现多人实时互动观看。

直播内容共享：将第三方平台的活动直播嵌入到在线会议或互动课堂中。

背景氛围：为在线会议或游戏房间持续播放背景音乐，或模拟 24 小时轮播电台。

内容再分发：将传统的 HTTP-FLV 流通过 WTN 网络进行加速，实现超低延迟大规模分发。

计费说明

使用该功能会产生在线媒体流费用。具体计费说明，请参见输入在线媒体流计费。

使用限制

源流格式：支持 HLS、RTMP、MP4、FLV、DASH、TS、MP3。

如源流为海外地址，为保障最佳体验，建议联系技术支持获取网络优化方案。

快速使用

准备工作

请确保你集成 RTC SDK，实现基本的音视频通话。

开启服务与配置回调。

访问 RTC 控制台_功能配置，选择目标房间所属的 RTC 应用（即 AppId）。

单击在线媒体流页签，启用在线媒体流服务。

（推荐）配置任务回调，获取在线媒体流任务执行结果（如成功、失败、结束）。

单击回调设置页签，单击添加配置，按照界面提示设置回调事件、URL、密钥等。

推送到 RTC 房间

在你的业务后台，调用 StartRelayStream 启动一个在线媒体流输入任务。请求示例如下：

AppId：RTC 应用的 ID。可在 RTC 控制台获取。

UserId：需要你自定义。发起任务后，服务端会用该 ID 作为虚拟用户的身份加入 RTC 房间，客户端也可通过此 ID 订阅该流。

Token：客户端与业务服务端进行通讯时的身份认证凭证。Token 生成方法，请参见使用 Token 完成鉴权。

转封装
视频转码（适配 H.265 ）
纯音频模式

{
"AppId": "661e****543cf",
"RoomId": "room_01",
"UserId": "user_01",
"Token": "rtc_token",
"TaskId": "task_remux_01",
"Control": {
"StreamUrl": "https://example.com/video.mp4",
"StreamMode": 1, // <--- 1 代表转封装，直接透传流数据
"MediaType": 0 // 0 代表音视频
"Volume": 80 // <--- 将音量设置为 80%
}
}

在客户端监听 onUserPublishStream，接收在线媒体流进房、发布等状态。

当回调触发时，可通过检查参数 uid 是否为第 1 步中指定的 userId。如果是，则为服务端输入的在线媒体流。onUserPublishStream 具体说明，请参见平台的回调文档。

推送到 WTN

在服务端调用 StartRelayStream 启动一个在线媒体流输入任务。请求示例如下：

AppId：RTC 应用的 ID。可在 RTC 控制台获取。

WtnStreamId：自定义 WTN 流的 ID，用于标识要推送的流和任务。更新/停止任务，均使用 WtnStreamId 作为标识。

Token：客户端与业务服务端进行通讯时的身份认证凭证。生成 Token 时 RoomId 可填写任意值。Token 具体生成方法，请参见使用 Token 完成鉴权。

进阶配置

定时播放

设置 StartTimeStamp（Unix 时间戳），任务将在指定时间自动开始拉流和推送。

循环播放

针对点播文件（如 MP4），设置 Loop=true 可实现循环轮播。

播放进度同步

设置 DataStreamOptions.Enable=true。RTC 会通过数据通道定期向房间发送当前的播放进度，便于客户端实现进度条同步。

播放音量调节

通过在 StartRelayStream 或 UpdateRelayStream 接口的 Control 参数中设置 Volume 字段，调整在线媒体流播放音量，可用于在语音场景中平衡背景音乐和人声。取值范围 [0, 400]，单位为 %。

0：静音

100（默认值）：原始音量。

400：原始音量的 4 倍。

更新、停止或查询任务

更新在线媒体流输入：调用 UpdateRelayStream 对已设定的媒体流参数进行更新。

停止在线媒体流输入：调用 StopRelayStream 主动终止正在推送的在线媒体流。

查询输入媒体流任务：调用 ListRelayStream 获取特定房间内所有在线媒体流的任务列表。

最近更新时间：2026.09.28 10:19:27

这个页面对您有帮助吗？

有用

无用