客户端旁路推流
旁路推流：将融云实时音视频流转为 rtmp 流媒体协议，推流到 CDN 服务。
旁路推流支持两种控制方式，本文仅介绍方案一：
- 方案一：使用客户端接口进行控制，使用
addPublishStreamUrl接口配置 CDN 地址。 - 方案二：使用服务端 API 的
/rtc/mcu/config接口进行控制。本文不做介绍，具体请参见服务端文档旁路推流。
业务链路
融云直播支持将实时音视频流转推到 CDN 服务，业务链路如下图所示：
配置直播 CDN 推流地址
当主播发布资源成功之后，主播就可设置 CDN 推流地址。
设置要求
- 必须开通音视频服务和直播服务。
- 房间模式必须为直播模式。
- 设置的 CDN 地址不能为空。
- 最多设置 5 个 CDN 地址，超出后接口会抛出
RCRTCCodeCDNCountReachToLimit错误。 - 如果多次设置相同的地址，会直接返回成功。
接口原型
Objective C
- (void)addPublishStreamUrl:(NSString *)url
completion:(nullable void (^)(BOOL isSuccess, RCRTCCode code, NSArray * _Nullable array))completion;
参数说明
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| url | NSString | 是 | 要设置的 CDN 地址 |
| completion | void (^)(BOOL isSuccess, RCRTCCode code, NSArray * _Nullable array) | 否 | 设置 CDN 之后的回调，会返回所有设置过的 CDN 地址 |
代码示例
Objective C
[self.liveInfo addPublishStreamUrl:@"rtmp://push.example.com/live/stream123"
completion:^(BOOL isSuccess, RCRTCCode code, NSArray * _Nullable array) {
}];
移除配置过的直播 CDN 地址
当主播发布资源成功之后，主播可选择移除一个设置过的 CDN 推流地址。
移除要求
- 必须开通音视频服务和直播服务。
- 房间模式必须为直播模式。
- 移除的 CDN 地址不能为空。
- 如果移除的地址，之前没有设置过，会直接返回成功。
接口原型
Objective C
- (void)removePublishStreamUrl:(NSString *)url
completion:(nullable void (^)(BOOL isSuccess, RCRTCCode code, NSArray * _Nullable array))completion;
参数说明
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| url | NSString | 是 | 要移除的 CDN 地址 |
| completion | void (^)(BOOL isSuccess, RCRTCCode code, NSArray * _Nullable array) | 否 | 移除 CDN 之后的回调，会返回所有设置过的 CDN 地址 |
代码示例
Objective C
[self.liveInfo removePublishStreamUrl:@"rtmp://push.example.com/live/stream123"
completion:^(BOOL isSuccess, RCRTCCode code, NSArray * _Nullable array) {
}];
CDN 推流回调
融云在低延迟直播旁路推流到第三方 CDN 时，支持将推流的状态变化实时通知您的服务器。具体请参见音视频服务端文档：