功能描述
客户端将直播媒体流发布到 CDN (Content Delivery Network) 的过程称为 客户端推流到CDN。用户需要集成 IArStreamingKit
类进行推流。
客户端在推流过程中,当频道中有多个主播时,客户端默认合流音频,视频合流布局需要客户端调用setLiveTranscoding
方法。
前提条件
- 集成 anyRTC RTC SDK。
- 开通第三方CDN服务。
实现方法
你可以参考以下步骤在你的项目中实现客户端推流 CDN:
- 调用 setLiveTranscoding 方法来设置音视频流的直播参数 ,如分辨率、帧率背景颜色等。如果你需要多主播在一起进行转码合图,你可以在 TranscodingUser 类中设置每个主播的参数。
- 调用 pushStream 方法向 CDN 推流直播中增加指定的媒体流。客户端可以创建多个推流地址进行推流。
- 如果你需要更新频道内合流参数,你可以再次调用 setLiveTranscoding 方法。
- 调用 unPushStream 方法停止 CDN 推流。
示例代码
// 设置音视频音频:该步骤是向音视频引擎中获取音视频数据,为下方的合流提供音视频源
streamKit.setRtcEngine(rtcEngine);
// CDN 推流参数设置。
LiveTranscoding config;
config.audioSampleRate = TYPE_44100;
config.audioChannels = 2;
config.audioBitrate = 48;
// 用于旁路推流的输出视频流的总宽度 (px)。360 为默认值。
config.width = 360;
// 用于旁路推流的输出视频流的总高度 (px)。640 为默认值。
config.height = 640;
// 设置推流输出视频的码率 (Kbps),默认值为 400。
cofig.videoBitrate = 400;
// 用于旁路推流的输出视频的帧率 (fps)。默认值为 15。取值范围为 [1,30],anyRTC 服务器会将高于 30 的帧率设置改为 30。
config.videoFramerate = 15;
// 如果 userCount > 1,则需要为每个 transcodingUser 分别设置布局。
config.userCount = 1;
// 推流输出视频的编码规格。可以设置为 Baseline (66)、Main (77) 或 High (100)。如果设置其他值,anyRTC 会统一设为默认值 High (100)。
config.videoCodecProfile = HIGH;
// CDN 推流参数设置。注意:调用这个接口前提是需要推流的视频大小以及音频配置,后续的合流布局也需要调用该方法进行相应的布局
streamKit.setLiveTranscoding(liveTranscoding);
// 设置视频合流推流
streamKit.setMode(PushMode.VidMix);
// 开始推流:向CDN推流
streamKit.pushStream();
// 更新布局
streamKit.setLiveTranscoding(liveTranscoding);
// 停止推流。
streamKit.unPushStream();
合图示例1:两人横向平铺
Canvas:
width: 640
height: 360
backgroundColor: #FFFFFF
User0:
userId: 123
x: 0
y: 0
width: 320
height: 360
zOrder: 1
alpha: 1.0
User1:
userId: 456
x: 320
y: 0
width: 320
height: 360
zOrder: 1
alpha: 1.0
合图示例2:三人纵向平铺
Canvas:
width: 360
height: 640
backgroundColor: #FFFFFF
User0:
userId: 123
x: 0
y: 0
width: 360
height: 640
zOrder: 1
alpha: 1.0
User1:
userId: 456
x: 0
y: 320
width: 180
height: 320
zOrder: 2
alpha: 1.0
User2:
userId: 789
x: 180
y: 320
width: 180
height: 320
zOrder: 2
alpha: 1.0
合图示例3:1 人全屏 + N 人悬浮小窗
Canvas:
width: 360
height: 640
backgroundColor: #FFFFFF
User0:
userId: 123
x: 0
y: 0
width: 360
height: 640
zOrder: 1
alpha: 1.0
User1:
userId: 456
x: 45
y: 390
width: 110
height: 213
zOrder: 2
alpha: 1.0
User2:
userId: 789
x: 185
y: 390
width: 110
height: 213
zOrder: 2
alpha: 1.0
注意事项
- 同一频道内最多支持 50 位主播。
- 客户端推流转码时,anyRTC 不会收取转码费用。
- 如果音频直播无需在调用 setLiveTranscoding 方法。
- 本地音视频的参数为 RTC 中的音视频参数。
- 需要推多个地址的,请初始化多个 StreamingKit 类,进行不同地址推流。