使用 CDN 直播

---

功能简介

ZEGO Express SDK 支持推流到 CDN（Content Delivery Network，内容分发网络），包括转推 CDN 和直推 CDN 两种功能。开发者基于该功能可打通 RTC 产品和 CDN 直播产品，方便用户从网页或第三方播放器直接观看和收听直播内容。为了保证安全，推流到 CDN 时默认开启 CDN 鉴权。

为防止攻击者盗取或伪造您的推流 URL 地址，您可以参考 CDN 推流鉴权，提升您推流使用的安全性。

转推 CDN

转推 CDN 指的是将音视频流从 ZEGO 音视频云推送到 ZEGO 自有 CDN 或第三方 CDN 的过程。

转推 CDN 包括以下三种方式：

直推 CDN

直推 CDN 指的是将音视频流直接从本地客户端推送到 CDN 的过程，用户可直接通过拉流 URL 地址从网页或第三方播放器进行观看。但由于直推 CDN 功能在网络传输过程中不经过 ZEGO 实时音视频云，因此开发者无法使用 ZEGO 的实时音视频服务。

功能对比

两种功能的说明与使用场景如下：

前提条件

在实现通过 CDN 推流、拉流之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/pages/example/advance-stream/stream-cdn.nvue” 目录下的文件。

使用步骤

转推 CDN

1 初始化和登录房间

请参考 快速开始 - 实现流程 的 “创建引擎”、“登录房间”。

2 开始推流

请参考 快速开始 - 实现流程 的 “推流”。

3 开始转推

当推流成功后，调用 addPublishCdnUrl 接口增加动态转推至 CDN 的 URL，即可将已经成功推向 ZEGO 实时云的音视频流动态向第三方 CDN 进行转推。支持的转推地址格式为 “rtmp”。

// 推流成功后，开始转推到 CDN 

// 推流时使用的流 ID
let streamID = "STREAM_ID";
// 需要转推的 CDN 地址，请开发者按照实际 URL 填入，streamID 为推流的流名，可自定义
let URL = "rtmp://推流域名/接入点/streamID";
ZegoExpressEngine.instance().addPublishCdnUrl(streamID, URL).then((result) {
    if(result.errorCode == 0) {
        // 转推成功
    } else {
        // 转推失败，可能由于网络原因转推请求发送失败
    }
});

4 （可选）监听 CDN 转推状态通知

4.1 添加/删除转推 CDN 地址状态回调

开发者可通过注册 publisherRelayCDNStateUpdate 获取添加/删除转推 CDN 地址状态回调。在 ZEGO RTC 服务器将音视频流转推到 CDN 后，如果 CDN 转推状态发生变化，例如出现转推停止或转推重试，将会收到此回调。

ZegoExpressEngine.instance().on("publisherRelayCDNStateUpdate", (streamID, infoList) => {
    console.log(`publisherRelayCDNStateUpdate:streamID:${streamID}, infoList:${JSON.stringify(infoList)}`);
});

4.2 转推 CDN 信息详解

转推 CDN 信息 ZegoStreamRelayCDNInfo 包含了 CDN 推流的 URL、转推状态、转推状态变更的原因、状态发生的时间。ZegoStreamRelayCDNInfo 内所有参数如下：

其中，state 取值如下：

updateReason 取值如下：

5 停止转推

调用 removePublishCdnUrl 接口即可删除动态转推至 CDN 的 URL。调用 removePublishCdnUrl 接口停止转推时，请确保当前流 streamID 是存在的。

// 推流时使用的流 ID
let streamID = "STREAM_ID";
// 需要停止转推的 CDN 地址，请开发者按照实际 URL 填入，streamID 为推流的流名
let URL = "rtmp://推流域名/接入点/streamID";
ZegoExpressEngine.instance().removePublishCdnUrl(streamID, URL).then((result) {
    if(result.errorCode == 0) {
        // 停止转推成功
    } else {
       // 停止转推失败，可能由于网络原因停止转推请求发送失败
    }
});

直推 CDN

1 开始直推 CDN

在推流前调用 enablePublishDirectToCDN 接口将音视频流直接推往 CDN。

ZegoCDNConfig config = new ZegoCDNConfig();
// URL 需要开发者根据实际情况填写，streamID 为推流的流名，可自定义
config.url = "rtmp://推流域名/接入点/streamID";
engine.enablePublishDirectToCDN(true, config);
engine.startPublishingStream("STREAM_ID");

2 停止直推 CDN

若需停止直推 CDN，调用 stopPublishingStream 接口停止推流即可。

停止推流后，若下一次推流无需直推 CDN，则可以调用 enablePublishDirectToCDN 接口并传值为 “false” 关闭直推 CDN 功能。在推流途中调用此接口不会影响此次推流。

engine.stopPublishingStream();
ZegoCDNConfig config = new ZegoCDNConfig();
engine.enablePublishDirectToCDN(false, config);

观众拉流

• 当推流方直推 CDN 时，拉流方可以直接通过 streamID 进行拉流，请参考 快速开始 - 实现流程 的 “拉流”。

• 当音视频流转推 CDN 成功后，开发者希望用户从 CDN 进行拉流时，需要使用传入 URL 的自定义拉流方式进行拉流，而不能通过流 ID 进行拉流。URL 拉流的操作步骤可参考 通过 URL 拉流 中的 “1 配置拉流参数” 和 “2 开始拉流”。