addPublishStreamUrl method Null safety

Future<void> addPublishStreamUrl(
  1. String url,
  2. bool transcodingEnabled
)

增加旁路推流地址。

调用该方法后，SDK 会在本地触发 RtcEngineEventHandler.rtmpStreamingStateChanged 回调， 报告增加旁路推流地址的状态。

Note

  • 调用该方法前，请确保已开通旁路推流的功能，详见进阶功能《推流到 CDN》中的前提条件。
  • 该方法仅适用直播场景。
  • 请确保在成功加入频道后才能调用该接口。
  • 该方法每次只能增加一路旁路推流地址。如需推送多路流，则需多次调用该方法。
  • Agora 目前仅支持转码时向 CDN 推送 RTMP 或 RTMPS 协议的媒体流。

Parameter url CDN 推流地址，格式为 RTMP。该字符长度不能超过 1024 字节。url 不支持中文等特殊字符。

Parameter transcodingEnabled 是否转码。如果设为 true，则需要在该方法前先调用 RtcEngine.setLiveTranscoding 方法。

  • true：转码。转码是指在旁路推流时对音视频流进行转码处理后，再推送到其他 CDN 服务器。多适用于频道内有多个主播，需要进行混流、合图的场景。
  • false：不转码。

Implementation

@override
Future<void> addPublishStreamUrl(String url, bool transcodingEnabled) {
  return _invokeMethod('addPublishStreamUrl', {
    'url': url,
    'transcodingEnabled': transcodingEnabled,
  });
}