实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频实时音视频开发指南推送在线媒体流至RTC 房间或 WTN
复制全文
下载 pdf推送在线媒体流至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 完成鉴权。
- {"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%}}源流是 H.265 编码，将 1080P 源流压缩为 720P。{"AppId": "661e****543cf","RoomId": "room_01","UserId": "virtual_user_02","Token": "your_rtc_token","TaskId": "task_transcode_01","Control": {"StreamUrl": "https://example.com/video_h265.mp4","StreamMode": 0, // <--- 0 代表转码"MediaType": 0, // 0 代表音视频"VideoWidth": 1280, // 必填：转码输出宽度"VideoHeight": 720, // 必填：转码输出高度"FrameRate": 15, // 选填：帧率"Bitrate": 1200 // 选填：码率}}{"AppId": "661e****543cf","RoomId": "room_01","UserId": "virtual_radio_bot","Token": "your_rtc_token","TaskId": "task_audio_01","Control": {"StreamUrl": "https://example.com/music.mp3","StreamMode": 0, // 音频通常建议使用转码模式以保证采样率兼容"MediaType": 1 // <--- 1 代表仅处理音频}}
- 在客户端监听 onUserPublishStream，接收在线媒体流进房、发布等状态。
推送到 WTN
- AppId：RTC 应用的 ID。可在 RTC 控制台获取。
- WtnStreamId：自定义 WTN 流的 ID，用于标识要推送的流和任务。更新/停止任务，均使用 WtnStreamId 作为标识。
- Token：客户端与业务服务端进行通讯时的身份认证凭证。生成 Token 时 RoomId 可填写任意值。Token 具体生成方法，请参见使用 Token 完成鉴权。
{
"AppId": "your_appid",
"WtnStreamId": "wtn_live_stream_01", // 必填：作为 WTN 任务标识
"Token": "your_rtc_token",
"Control": {
"StreamUrl": "http://example.com/live.flv",
"StreamMode": 1
}
}
进阶配置
定时播放
设置 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
这个页面对您有帮助吗？
有用
有用
无用
无用