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

Declared In

zego-api-mix-stream-oc.h