# 集成 CDN 推流

# 简介

将直播流发布到 CDN(Content Delivery Network)的过程称为 CDN 直播推流,用户无需安装 App,可以通过 Web 浏览器观看直播。

推流对网络要求比较高,如果网络不稳定,直播效果就会很差,观众观看直播时就会发生卡顿等现象,观看体验很是糟糕。

要想用于推流还必须把音视频数据使用传输协议进行封装,变成流数据。常用的流传输协议有 RTSP、RTMP、HLS 等,使用 RTMP 传输的延时通常在1–3秒,对于手机直播这种实时性要求非常高的场景,RTMP 也成为手机直播中最常用的流传输协议。最后通过一定的 Qos 算法将音视频流数据推送到网络端,通过 CDN 进行分发。

CDN 推流的原理如下

img

# 适用场景

应用行业 场景说明
音频互动直播 语音直播、游戏语音、线上 KTV、语音聊天室
视频互动直播 娱乐社交、电商直播、新闻媒体、赛事直播
视频会议 大型企业级会议
在线教育 直播课堂、在线大班课

# 前提条件

集成 CDN 推流功能前,请确保您已经集成了基础的多方音视频通话功能。

# 集成步骤

# 设置推流地址

如要开启 CDN 推流,需在 加入频道前 进行 CDN 推流地址的设置。具体为通过 JOIN_PARAM_CDN 关键字进行配置。

// 设置 CDN 推流地址
JCMediaChannel.JoinParam joinParam = new JCMediaChannel.JoinParam();
joinParam.cdn = "推流地址";
// 加入频道
mediaChannel.join("channelId", joinParam);

# 判断 CDN 状态

开启 CDN 推流前需要判断 CDN 的状态,通过 JCMediaChannel 中的 cdnState 属性判断 cdn 状态。

/// <summary>
/// 无法进行CDN推流
/// </summary>
None,
/// <summary>
/// 可以开启CDN推流
/// </summary>
Ready,
/// <summary>
/// CDN推流中
/// </summary>
Running

只有 CDN 当前状态不为 None 时才可以开启 CDN 推流。CDN 状态的变化通过 onMediaChannelPropertyChange 回调上报。

/// <summary>
/// 属性变化回调,目前主要关注屏幕共享和窗口共享状态的更新
/// </summary>
/// <param name="propChangeParam">变化集合</param>
void onMediaChannelPropertyChange(JCMediaChannel.PropChangeParam propChangeParam);

# 开启/关闭 CDN 推流

CDN 状态获取后,即可根据 CDN 的状态开启或关闭 CDN 推流,接口如下

/// <summary>
/// 开关Cdn推流,内部根据当前状态决定是否开启
/// 在收到onMediaChannelPropertyChange回调时检查cdnState
/// </summary>
/// <param name="enable">是否开启cdn推流</param>
/// <param name="keyInterval">推流关键帧间隔(毫秒),当 enable 为 true 时有效,-1表示使用默认值(5000毫秒)</param>
/// <returns>返回true表示调用成功,false表示调用失败</returns>
public bool enableCdn(bool enable, int keyInterval)

开启推流示例代码

public void onMediaChannelPropertyChange(JCMediaChannel.PropChangeParam propChangeParam) {
    if (propChangeParam.cdnState) { // CDN 状态变化
        // 根据CDN推流状态判断是否开启推流
        if (mediaChannel.cdnState == JCMediaChannelCdnState.None) {
            // 无法使用 CDN 推流
        } else if (mediaChannel.cdnState == JCMediaChannelCdnState.Ready) {
            // 可以开启 CDN 推流
            mediaChannel.enableCdn(true);
        } 
    }
}

关闭推流示例代码

if (mediaChannel.cdnState == JCMediaChannelCdnState.Running) {
            // CDN 推流中,可以关闭 CDN 推流
            mediaChannel.enableCdn(false);
        }
最后更新时间: 2021/11/8 15:17:22