需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

Interface ChannelMediaRelayConfiguration

  • 小程序

更新时间不可用

跨频道媒体流转发的配置。

在调用 startChannelMediaRelay 和 updateChannelMediaRelay 时，通过该接口设置跨频道媒体流转发的具体信息。

Methods

removeDestChannelInfo

removeDestChannelInfo(channelName: string): void

删除目标频道

example

示例代码

JavaScript
configuration.removeDestChannelInfo("cname")
Parameters
参数名描述
channelNamestring
required

想要删除的目标频道名。

表格内容超出当前宽度，可横向滚动查看更多列。
Returns
返回类型描述

void

表格内容超出当前宽度，可横向滚动查看更多列。

setDestChannelInfo

setDestChannelInfo(channelName: string, destInfo: any): void

设置目标频道信息。

如果你想将流转发到多个目标频道，可以多次调用该方法。该方法支持最多设置 4 个目标频道。

example

示例代码

JavaScript
var configuration = new AgoraRTC.ChannelMediaRelayConfiguration();
configuration.setDestChannelInfo("cname", {
 channelName: "destChannel",
 uid: 123,
 token: "yourDestToken",
})
Parameters
参数名描述
channelNamestring
required

目标频道名，该参数必须与 destInfo 参数中的 channelName 一致。

destInfoany
required

目标频道信息，包含以下参数：

  • channelName：String 类型，目标频道名。
  • uid：Number 类型，32 位无符号整数。用于标识目标频道中的转发媒体流的 UID，需确保与目标频道中的其他用户 ID 不同，防止造成互踢，设置范围：0 到 (2³² - 1)，设为 0 服务器会自动分配一个 UID。
  • token：String 类型，用上面设置的频道名和 uid 生成的 token。如果未启用 token 则无需设置。
表格内容超出当前宽度，可横向滚动查看更多列。
Returns
返回类型描述

void

表格内容超出当前宽度，可横向滚动查看更多列。

setSrcChannelInfo

setSrcChannelInfo(srcInfo: any): void

设置源频道信息。

example

示例代码

JavaScript
var configuration = new AgoraRTC.ChannelMediaRelayConfiguration();
configuration.setSrcChannelInfo({
 channelName: "srcChannel",
 uid: 123,
 token: "yourSrcToken",
})
Parameters
参数名描述
srcInfoany
required

源频道信息，包含以下参数：

  • channelName：String 类型，源频道的频道名。
  • uid：Number 类型，32 位无符号整数。用于标识源频道中的转发媒体流的 UID，不可与当前主播的 UID 相同，设置范围：0 到 (2³² - 1)，设为 0 服务器会自动分配一个 UID。
  • token：String 类型，用上面设置的频道名和 uid 生成的 token。如果未启用 token 则无需设置。
表格内容超出当前宽度，可横向滚动查看更多列。
Returns
返回类型描述

void

表格内容超出当前宽度，可横向滚动查看更多列。

这个页面有帮助吗？

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利