使用 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，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

使用步骤

转推 CDN

1 初始化、登录房间、开始推流

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

2 开始转推

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

• 调用示例:

  // 推流成功后，开始转推到 CDN 
  
  // 推流时使用的流 ID
  std::string streamID = "STREAM_ID";
  // 需要转推的 CDN 地址，请开发者按照实际 URL 填入，streamID 为推流的流名，可自定义
  std::string URL = "rtmp://推流域名/接入点/streamID";
  
  engine->addPublishCdnUrl(streamID, URL, [](int errorCode) {
      if(errorCode == 0) {
          // 转推成功
      } else {
          // 转推失败，可能由于网络原因转推请求发送失败
      }
  });

3 （可选）监听 CDN 回调的状态通知

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

• 调用示例：

  class MyEventHandler:public IZegoEventHandler{
  public:
      void onPublisherRelayCDNStateUpdate(const std::string& /*streamID*/, const std::vector<ZegoStreamRelayCDNInfo>& /*streamInfoList*/) {
          // 调用动态转推接口成功后，当 CDN 连接状态发生变更，如出现网络中断导致转推异常等情况，SDK 在重试转推的同时，会通过该回调通知 
          // 请注意，请勿在 SDK 回调线程中调用任何 SDK 接口，需要手动切换为其他线程，否则会产生死锁
      }
  };
  auto handler=std::make_shared<MyEventHandler>();
  engine->setEventHandler(handler);

4 停止转推

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

• 调用示例：

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

直推 CDN

1 开始直推 CDN

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

ZegoCDNConfig config;
// 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 cdnConfig;
engine->enablePublishDirectToCDN(false, &cdnConfig);

观众拉流

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

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