# 跨频道媒体流转发 (/zh-CN/realtime-media/rtc/build/advanced-channel/media-relay/react-native)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
在实时互动场景下,跨频道媒体流转发功能可实现主播角色的媒体流从源频道同时转发进多个目标频道,其中:
- 所有主播发布并接收彼此的音视频流,进行跨频道实时互动
- 观众可以接收到所有主播的音视频流,同时观看多位主播互动
该功能因其实时性和互动性,能够丰富直播玩法,尤其适用于连麦 PK、在线合唱等直播场景,为观众带来更好的观看体验的同时,也为主播带来更多的流量和收益。
:::info[信息]
跨频道媒体流享受声网[每月一万分钟免费](/zh-CN/reference/faq/account/billing_free)政策。超出免费额度的部分,计费详情请参考[跨频道媒体流转发计费](/zh-CN/realtime-media/rtc/reference/billing-strategy#跨频道媒体流转发)。
:::
## 前提条件 [#前提条件-7]
在开始前,请确保满足以下条件:
- 在你的项目中实现基本的实时音视频功能,详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- [联系技术支持](https://ticket.shengwang.cn/)开通跨频道媒体流转发功能。
## 实现步骤 [#实现步骤-7]
参考如下流程图实现相关代码逻辑:
### 1. 开始跨频道媒体流转发 [#1-开始跨频道媒体流转发-6]
加入频道后,调用 `startOrUpdateChannelMediaRelay` 配置源频道和目标频道信息,开始转发媒体流。示例代码如下:
```typescript
const srcChannelId = "srcChannel";
const destChannelId = "destChannel";
const uid = 0;
const token = "insert-your-token";
// 开始跨频道媒体流转发
rtcEngine.startOrUpdateChannelMediaRelay({
// 配置源频道信息 srcInfo
srcInfo: {
channelName: srcChannelId,
uid: uid,
token: token,
},
// 配置目标频道信息 destInfos
destInfos: [
{
channelName: destChannelId,
token: '', // 能加入目标频道的 token
uid: 0, // SDK 随机分配 uid
},
],
// 目标频道数量
destCount: 1,
});
```
### 2. 更新媒体流转发的频道 [#2-更新媒体流转发的频道-3]
成功调用 `startOrUpdateChannelMediaRelay` 后,如需将流转发到多个目标频道,或退出当前的转发频道,可以再次调用该方法添加或移除转发的目标频道。
:::info[信息]
更新后的配置会**全量替换**掉之前的配置。
:::
### 3. 暂停/恢复转发媒体流 [#3-暂停恢复转发媒体流-6]
开始跨频道转发媒体流后,调用 `pauseAllChannelMediaRelay` 可以暂停向所有目标频道转发媒体流。示例代码如下:
```typescript
rtcEngine.pauseAllChannelMediaRelay();
```
暂停跨频道媒体流转发后,调用 `resumeAllChannelMediaRelay` 即可恢复向所有目标频道转发媒体流。示例代码如下:
```typescript
rtcEngine.resumeAllChannelMediaRelay();
```
### 4. 停止跨频道媒体流转发 [#4-停止跨频道媒体流转发-7]
成功开始跨频道媒体流转发后,可以调用 `stopChannelMediaRelay` 停止转发媒体流,一经停止,主播会退出所有目标频道。示例代码如下:
```typescript
rtcEngine.stopChannelMediaRelay();
```
:::info[信息]
如果该方法调用失败,可以调用 `leaveChannel` 离开频道,跨频道媒体流转发会自动停止。
:::
### 5. 监听跨频道媒体流状态 [#5-监听跨频道媒体流状态-6]
在跨频道媒体流转发过程中,SDK 会通过 `onChannelMediaRelayStateChanged` 回调报告媒体流转发的状态,你可以参考状态码的含义实现相关的业务逻辑。示例代码如下:
```typescript
// 注册事件回调
rtcEngine.registerEventHandler(
onChannelMediaRelayStateChanged: (state: ChannelMediaRelayState, code: ChannelMediaRelayError) => {
console.log(`跨频道媒体流转发状态:${state},错误码:${code}`);
},
);
```
主要的状态码及其对应的媒体流转发状态如下:
| 媒体流转发状态 | 状态码 |
| ---------------- | ---------------- |
| 源频道开始向目标频道传输数据。 | `RelayStateRunning`(2) 和 `RelayOk`(0) |
| 跨频道媒体流转发出现异常。可根据[错误码](/zh-CN/api-reference/rtc/react-native/cloud-media-relay/channel-media-relay#callback_irtcengineeventhandler_onchannelmediarelaystatechanged)进行排查。 | `RelayStateFailure`(3) |
| 已停止媒体流转发。 | `RelayStateIdle`(0) 和 `RelayOk`(0) |
## 参考信息 [#参考信息-7]
### 示例项目 [#示例项目-5]
声网提供了跨频道媒体流转发的示例项目供你参考。你可以前往下载或查看其中的源代码。
ChannelMediaRelay} href="https://gitee.com/agoraio-community/react-native-agora/tree/main/example/src/examples/advanced/ChannelMediaRelay/ChannelMediaRelay.tsx" />
ChannelMediaRelay} href="https://github.com/AgoraIO-Extensions/react-native-agora/blob/main/examples/legacy/src/examples/advanced/ChannelMediaRelay/ChannelMediaRelay.tsx" />
### 开发注意事项 [#开发注意事项-7]
- 在直播场景中,只有角色为主播的用户才能调用 `startOrUpdateChannelMediaRelay` 开始跨频道媒体流转发。
- `startOrUpdateChannelMediaRelay` 必须在成功加入频道后调用,否则会报错。
- 一个频道内可以有多个主播转发媒体流,一个主播最多可以将媒体流转发至 6 个目标频道。
- 该功能不支持 String 型 `uid`,如需使用跨频道连麦功能,则要在普通连麦中也使用 Int 型 `uid`,否则跨频道连麦功能无法正常使用。
### API 参考 [#api-参考-7]
- [`startOrUpdateChannelMediaRelay`](/zh-CN/api-reference/rtc/react-native/cloud-media-relay/channel-media-relay#startorupdatechannelmediarelay)
- [`stopChannelMediaRelay`](/zh-CN/api-reference/rtc/react-native/cloud-media-relay/channel-media-relay#api_irtcengine_stopchannelmediarelay)
- [`pauseAllChannelMediaRelay`](/zh-CN/api-reference/rtc/react-native/cloud-media-relay/channel-media-relay#api_irtcengine_pauseallchannelmediarelay)
- [`resumeAllChannelMediaRelay`](/zh-CN/api-reference/rtc/react-native/cloud-media-relay/channel-media-relay#api_irtcengine_resumeallchannelmediarelay)
- [`onChannelMediaRelayStateChanged`](/zh-CN/api-reference/rtc/react-native/cloud-media-relay/channel-media-relay#callback_irtcengineeventhandler_onchannelmediarelaystatechanged)
- [`ChannelMediaRelayConfiguration`](/zh-CN/api-reference/rtc/react-native/class-channelmediarelayconfiguration)
- [`ChannelMediaInfo`](/zh-CN/api-reference/rtc/react-native/class-channelmediainfo)