addPublishCdnUrl method

Future<ZegoPublisherUpdateCdnUrlResult> addPublishCdnUrl(
  1. String streamID,
  2. String targetURL,
  3. {int? timeout}
)

增加转推至 CDN 的 URL。

支持版本：1.1.0 及以上。 详情描述：将 ZEGO RTC 服务器的音视频流转推至自定义的 CDN 内容分发网络，延迟高但是支持高并发拉流。 业务场景：1. 常用于对延迟没有特别高要求的大规模直播场景。2. 由于 ZEGO RTC 服务器本身可配置支持 CDN 内容分发网络，此函数主要为自身拥有 CDN 内容分发服务的开发者使用。3. 此函数支持动态转推至多个 CDN 内容分发网络，因此开发者可以使用此函数来作为 CDN 内容分发服务的一个容灾方案。 调用时机：在调用 createEngine 函数创建引擎后。 使用限制：当调用 enablePublishDirectToCDN 函数设置为 true 将流直推到 CDN 时，再调用本函数将无效。 注意事项：删除转推至 CDN 的 URL 需要调用 removePublishCdnUrl，调用 stopPublishingStream 不会删除转推至 CDN 的 URL。 相关接口：删除转推至 CDN 的 URL removePublishCdnUrl，结果回调函数 onPublisherRelayCDNStateUpdate。

  • streamID 流 ID。
  • targetURL CDN 转推地址，支持的转推地址格式有 rtmp, rtmps.
  • timeout 超时时间。如果在时间内没有开始转推就回调通知。默认为0，表示不超时，有效范围5,600，单位秒。小于0会被重置为0，1到4会被重置为5，大于600会被重置为600。
  • Returns 更新 CDN 转推结果通知。

Implementation

Future<ZegoPublisherUpdateCdnUrlResult> addPublishCdnUrl(
    String streamID, String targetURL,
    {int? timeout}) async {
  return await ZegoExpressImpl.instance
      .addPublishCdnUrl(streamID, targetURL, timeout: timeout);
}