实时音视频
  • 平台类型
  • 框架 / 引擎
  • iOS
  • Android
  • macOS
  • Windows
  • Linux
  • Web
  • 小程序

直推 CDN

更新时间:2021-04-25 20:25

1 功能简介

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

该功能一般由与第三方 CDN 有音视频分发服务合作的开发者使用。

2 示例源码下载

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

相关源码请查看 “/ZegoExpressExample/CustomCdnPublish” 目录下的文件。

3 前提条件

在实现直推 CDN 功能之前,请确保:

4 使用步骤

4.1 初始化和登录房间

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

4.2 设置 SDK 直推 CDN

直推 CDN 的功能必须在“推流前”设置。

  • 接口原型

    /**
     * 是否不经过 Zego 实时视频云服务器直接推流到 CDN
     *
     * 此接口需要推流前设置。
     * 调用此接口将音视频流直接推往 CDN 之后,调用 [addPublishCdnUrl] 与 [removePublishCdnUrl] 动态转推至 CDN 不再生效,因为这两个接口是从 ZEGO 实时音视频云将音视频流转推或停止转推到 CDN,若直接音视频流直接推往 CDN 将无法通过 ZEGO 实时音视频云将音视频流再动态转推至 CDN。
     * @param enable 是否开启直推 CDN;true 表示开启直推 CDN;false 表示不开启直推 CDN;默认为 false
     * @param config CDN 配置,若为 null 则使用 Zego 的后台配置
     */
    public void enablePublishDirectToCDN(boolean enable, @Nullable ZegoCDNConfig config)
  • 调用示例

    ZegoCDNConfig config = new ZegoCDNConfig();
    // URL 需要开发者根据实际情况填写
    config.url = "rtmp://xxxxxxxx";
    engine.enablePublishDirectToCDN(true, config);
    engine.startPublishingStream("STREAM_ID");

4.3 开始推流

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

4.4 监听推流状态通知

  • 接口原型

    /**
     * 推流状态回调
     *
     * 在推流成功后,可以通过该回调接口获取推流状态变更的通知。
     * 开发者可根据 state 参数是否在 [正在请求推流状态] 来大体判断用户的推流网络情况。
     * @param streamID 推流的流 ID
     * @param state 推流状态
     * @param errorCode 推流状态变更对应的错误码。请参考常见错误码文档 [https://doc-zh.zego.im/zh/4378.html]
     * @param extendedData 扩展信息。若使用 ZEGO 的 CDN 内容分发网络,在推流成功后,该参数的内容的键为 flv_url_list,rtmp_url_list,hls_url_list。这些对应 flv、rtmp、hls协议的拉流url。若是未使用 ZEGO 的 CDN,不需关注该参数。
     */
    public void onPublisherStateUpdate(String streamID, ZegoPublisherState state, int errorCode, JSONObject extendedData)
  • 调用示例

    engine.setEventHandler(new IZegoEventHandler(){
    
        // 重写的其他回调
        ...
    
        @Override
        public void onPublisherStateUpdate(String streamID, ZegoPublisherState state, int errorCode, JSONObject extendedData){
            // 直推 CDN 亦可以使用该回调通知来监听推流的结果
            ...
        }
    
        // 重写的其他回调
        ...
    
    });

4.5 观众拉流

5 API 参考列表

方法 描述
enablePublishDirectToCDN 使能直推 CDN
startPublishingStream 开始推流
stopPublishingStream 停止推流