通过 URL 拉流

功能简介

当推流端使用第三方推流工具（例如 OBS 软件、网络摄像头 IPCamera 等）将流推到 CDN 时，或通过 ZEGO SDK 转推 CDN 功能将音视频画面推送到第三方 CDN 上时，可直接传入 URL 地址进行拉流。

前提条件

在实现 URL 拉流功能之前，请确保：

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

• 已联系 ZEGO 技术支持开通 URL 拉流功能。
• 已将音视频流推送到 CDN，并知晓相应的 URL，详情请参考 使用 CDN 直播。

使用步骤

1 配置拉流参数

直接通过 CDN 的 URL 地址拉流，需要使用 ZegoCDNConfig 对象来填入 URL 参数，当从 CDN 拉流时存在拉流鉴权时，还需要通过 authParam 字段填入鉴权参数。

// 设置 CDN 参数 
ZegoCDNConfig cdnConfig;
// URL 为 CDN 拉流地址
cdnConfig.url = "rtmp://xxxxxxxx";
// 如果需要鉴权则要设置鉴权参数，如果不需要鉴权可以不设置（鉴权参数不能带"?"字符）
cdnConfig.authParam = "xxx";

ZegoPlayerConfig config;
config.cdnConfig = &cdnConfig;

2 开始拉流

通过调用 startPlayingStream 接口开始拉流。

拉流时，如果出现错误，请参考 拉流错误码。

// 开始拉流，设置远端拉流渲染视图 canvas，视图模式采用 SDK 默认的模式，等比缩放填充整个 View
ZegoCanvas canvas((void*)view);

// 填写了 url 参数后，sdk 会从 url 拉取音视频流，但此时依然需要传递一个唯一的 streamID 到 SDK，SDK 内部会以该 streamID 标识这条流
engine->startPlayingStream(streamID, &canvas, config);

3 停止拉流

若要停止拉流，调用 stopPlayingStream 接口。

// 停止拉流 
engine->stopPlayingStream(streamID);

4 （可选）监听拉流相关事件通知

// 请注意，请勿在 SDK 回调线程中调用任何 SDK 接口，需要手动切换为其他线程，否则会产生死锁
class MyEventHandler :public IZegoEventHandler
{
    public:
        void onPlayerStateUpdate(const std::string& /*streamID*/, ZegoPlayerState /*state*/, int /*errorCode*/, const std::string& /*extendedData*/) {
        /** 调用拉流接口成功后，当拉流器状态发生变更，如出现网络中断导致推流异常等情况，SDK在重试拉流的同时，会通过该回调通知 */
        /** 未拉流状态，在拉流前处于该状态。如果拉流过程出现稳态的异常，例如 AppID、AppSign、Token 不正确，都会进入未拉流状态 */
        //ZEGO_PLAYER_STATE_NO_PLAY = 0,

        /** 正在请求拉流状态，拉流操作执行成功后会进入正在请求拉流状态，通常通过该状态进行应用界面的展示。如果因为网络质量不佳产生的中断，SDK 会进行内部重试，也会回到正在请求拉流状态 */
        //ZEGO_PLAYER_STATE_PLAY_REQUESTING = 1,

        /** 正在拉流状态，进入该状态表明拉流已经成功，用户可以正常通信 */
        //ZEGO_PLAYER_STATE_PLAYING = 2
        //通过URL拉流时，回调参数中的stream_id即为调用拉流API时的流ID，用于唯一标识当次拉流事件。
    }
};
auto handler=std::make_shared<MyEventHandler>();
engine->setEventHandler(handler);