ZegoStreamMixer Class Reference

Inherits from NSObject
Declared in zego-api-mix-stream-oc.h

Overview

混流类

– setDelegate:

设置接收混流配置更新结果的回调，对应于 ZegoStreamMixer mixStream:seq: 接口的回调监听。

- (void)setDelegate:(id<ZegoMixStreamDelegate>)delegate

Parameters

delegate

实现了 ZegoMixStreamDelegate 代理的方法，用于混流时接收混流请求结果及配置更新信息。

Discussion

  • 注意：
  • 1.Deprecated 此方法不建议使用，建议使用 ZegoStreamMixer setMixStreamExDelegate: 和 ZegoStreamMixer mixStreamEx:mixStreamID:
  • 2.若不再需要接收混流配置更新信息，调用 setDelegate:nil 去除回调监听。

See Also

Declared In

zego-api-mix-stream-oc.h

– setSoundLevelInMixedStreamDelegate:

设置拉取混流时对混流中音量的回调监听

- (void)setSoundLevelInMixedStreamDelegate:(id<ZegoLiveSoundLevelInMixedStreamDelegate>)delegate

Parameters

delegate

实现了 ZegoLiveSoundLevelInMixedStreamDelegate 代理的方法，用于拉取混流时接收混流中各单流的音量信息，可以根据此回调实现音浪。

Discussion

  • 注意：
  • 1.此方法由拉取混流方调用。
  • 2.若不再需要接收混流中各单流的音量信息，调用 setSoundLevelInMixedStreamDelegate:nil 去除回调监听。

Declared In

zego-api-mix-stream-oc.h

– mixStream:seq:

混流接口，只支持输出一路混流。

- (bool)mixStream:(ZegoCompleteMixStreamConfig *)completeMixConfig seq:(int)seq

Parameters

completeMixConfig

混流配置，详细配置信息请查看 ZegoCompleteMixStreamConfig
seq

开始混流的请求序号，回调会带回此 seq

Return Value

true-同步调用成功，等待回调；false-同步调用失败，收不到回调。

Discussion

  • 1.此 API 既是开始混流接口，也是停止混流接口；需要停止混流时，将 ZegoCompleteMixStreamConfig 参数中的 inputStreamList 置为空列表，即清空输入流列表，且开始、停止混流两次调用的 seq 参数保持一致。
  • 2.当混流信息变更（例如：混流的输入流列表发生增减、调整混流视频的输出码率等）时，需要调用此接口更新 ZEGO 混流服务器上的混流配置信息，且注意每次调用时此 API 的 seq 参数需保证一致。
  • 3.如果需要启动多个不同的混流，可以通过传入不同的 seq 来区分接收的 -onMixStreamConfigUpdate:mixStream:streamInfo: 回调。
  • 4.调用推流 API -startPublishing:title:flag: 或者 -startPublishing:title:flag:extraInfo: 时，需指定 flag 参数为 ZEGO_MIX_STREAM。

Note: Deprecated 建议使用 ZegoStreamMixer setMixStreamExDelegate: 和 ZegoStreamMixer mixStreamEx:mixStreamID: 接口实现混流。

Declared In

zego-api-mix-stream-oc.h

– setMixStreamExDelegate:

设置接收混流配置更新结果的回调监听，对应于 ZegoStreamMixer mixStreamEx:mixStreamID: 接口的回调监听。

- (void)setMixStreamExDelegate:(id<ZegoMixStreamExDelegate>)delegate

Parameters

delegate

实现了 ZegoMixStreamExDelegate 代理的方法，用于混流时接收混流请求结果及配置更新信息。

Discussion

  • 注意：若不再需要接收混流配置更新信息，调用 setMixStreamExDelegate:nil 去除回调监听。

See Also

Declared In

zego-api-mix-stream-oc.h

– mixStreamEx:mixStreamID:

混流接口，支持输出单路或者多路混流。

- (int)mixStreamEx:(ZegoMixStreamConfig *)config mixStreamID:(NSString *)mixStreamID

Parameters

config

混流配置信息
mixStreamID

混流任务ID

Return Value

大于 0 表示调用成功，且返回值为调用序号（seq），用以区分 -onMixStreamExConfigUpdate:mixStream:streamInfo: 回调；小于等于 0 表示调用失败。

Discussion

  • 1.混流任务ID，表示混流任务的唯一ID，调用方应该保证 mixStreamID 的唯一性。如果 mixStreamID 相同，服务端就认为是更新同一个混流。
  • 2.此 API 既是开始混流、更新混流接口，也是停止混流接口。
  • 3.需要停止混流时，将 ZegoMixStreamConfig 参数中的 inputStreamList 置为空列表（即清空输入流列表），将 mixStreamID 参数设置为和开始或更新混流的一致。
  • 4.当混流信息变更（例如：混流的输入流列表发生增减、调整混流视频的输出码率等）时，需要调用此接口更新 ZEGO 混流服务器上的混流配置信息，且注意每次调用时此 API 的 mixStreamID 参数需保证一致。
  • 5.如果需要启动多个不同的混流，可以传入不同的 mixStreamID，通过返回的 seq 来区分接收的 -onMixStreamExConfigUpdate:mixStream:streamInfo:回调。
  • 6.调用推流 API -startPublishing:title:flag: 或者 -startPublishing:title:flag:extraInfo: 时，需指定 flag 参数为 ZEGO_MIX_STREAM。

Declared In

zego-api-mix-stream-oc.h