Package com.zego.zegoavkit2.mixstream

Class ZegoStreamMixer

java.lang.Object

com.zego.zegoavkit2.mixstream.ZegoStreamMixer

public class ZegoStreamMixer
extends java.lang.Object

混流类

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	NON_EXIST_STREAM_ID_KEY	混流不存在的流名键值，值为 String[]
static java.lang.String	SEQ_KEY	混流请求 seq 键值，值为 @(int)

Constructor Summary

Constructors

Constructor	Description
ZegoStreamMixer()

Method Summary

Modifier and Type	Method	Description
boolean	mixStream(ZegoCompleteMixStreamInfo config, int seq)	Deprecated. 建议使用 setMixStreamExCallback(IZegoMixStreamExCallback) 和 mixStreamEx(ZegoMixStreamConfig,java.lang.String) 接口实现混流。
int	mixStreamEx(ZegoMixStreamConfig config, java.lang.String mixStreamID)	混流接口，支持输出单路或者多路混流。
void	setCallback(IZegoMixStreamCallback callback)	Deprecated. 此方法不建议使用，建议使用 setMixStreamExCallback(IZegoMixStreamExCallback) 和 mixStreamEx(ZegoMixStreamConfig,java.lang.String)
void	setMixStreamExCallback(IZegoMixStreamExCallback callback)	设置接收混流配置更新结果的回调监听，对应于 mixStreamEx(ZegoMixStreamConfig, String) 接口的回调监听。
void	setRelayCDNStateCallback(IZegoMixStreamRelayCDNCallback callback)	设置混流转推CDN状态回调的监听
void	setSoundLevelInMixStreamCallback(IZegoSoundLevelInMixStreamCallback callback)	设置拉取混流时对混流中音量的回调监听

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NON_EXIST_STREAM_ID_KEY

public static final java.lang.String NON_EXIST_STREAM_ID_KEY

混流不存在的流名键值，值为 String[]

See Also:

Constant Field Values

SEQ_KEY

public static final java.lang.String SEQ_KEY

混流请求 seq 键值，值为 @(int)

See Also:

Constant Field Values

Constructor Detail

ZegoStreamMixer

public ZegoStreamMixer()

Method Detail

setCallback

public void setCallback(IZegoMixStreamCallback callback)

Deprecated.

此方法不建议使用，建议使用 setMixStreamExCallback(IZegoMixStreamExCallback) 和 mixStreamEx(ZegoMixStreamConfig,java.lang.String)

设置接收混流配置更新结果的回调监听，对应于 mixStream(ZegoCompleteMixStreamInfo, int) 接口的回调监听。

若不再需要接收混流配置更新信息，调用 setCallback(null) 去除回调监听。

Parameters:

callback - 实现了 IZegoMixStreamCallback 接口的对象实例，用于混流时接收混流请求结果及配置更新信息。

See Also:

mixStream(ZegoCompleteMixStreamInfo, int)

setMixStreamExCallback

public void setMixStreamExCallback(IZegoMixStreamExCallback callback)

设置接收混流配置更新结果的回调监听，对应于 mixStreamEx(ZegoMixStreamConfig, String) 接口的回调监听。

若不再需要接收混流配置更新信息，调用 setMixStreamExCallback(null) 去除回调监听。

Parameters:

callback - 实现了 IZegoMixStreamExCallback 接口的对象实例，用于混流时接收混流请求结果及配置更新信息。

See Also:

mixStreamEx(ZegoMixStreamConfig, String)

setSoundLevelInMixStreamCallback

public void setSoundLevelInMixStreamCallback(IZegoSoundLevelInMixStreamCallback callback)

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

Parameters:

callback - 实现了 IZegoSoundLevelInMixStreamCallback 接口的对象实例，用于拉取混流时接收混流中各单流的音量信息。

此方法由拉取混流方调用。

若不再需要接收混流中各单流的音量信息，调用 setSoundLevelInMixStreamCallback(null) 去除回调监听。

setRelayCDNStateCallback

public void setRelayCDNStateCallback(IZegoMixStreamRelayCDNCallback callback)

设置混流转推CDN状态回调的监听

Parameters:

callback - 实现了 IZegoMixStreamRelayCDNCallback 接口的对象实例，用于拉取混流转推CDN时接收转推的状态。

mixStream

public boolean mixStream(ZegoCompleteMixStreamInfo config,
                         int seq)

Deprecated.

建议使用 setMixStreamExCallback(IZegoMixStreamExCallback) 和 mixStreamEx(ZegoMixStreamConfig,java.lang.String) 接口实现混流。

注意： 1. 此 API 既是开始混流接口，也是停止混流接口；需要停止混流时，将 ZegoCompleteMixStreamInfo 参数中的 inputStreamList 置为空列表，即清空输入流列表，且开始、停止混流两次调用的 seq 参数保持一致。
2. 当混流信息变更（例如：混流的输入流列表发生增减、调整混流视频的输出码率等）时，需要调用此接口更新 ZEGO 混流服务器上的混流配置信息，且注意每次调用时此 API 的 seq 参数需保证一致。
3. 如果需要启动多个不同的混流，可以通过传入不同的 seq 来区分接收的 IZegoMixStreamCallback.onMixStreamConfigUpdate(int, String, HashMap) 回调。

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

Parameters:

config - 混流配置，详细配置信息请查看 ZegoCompleteMixStreamInfo

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

Returns:

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

mixStreamEx

public int mixStreamEx(ZegoMixStreamConfig config,
                       java.lang.String mixStreamID)

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

Parameters:

config - 混流配置，详细配置信息请查看 ZegoMixStreamConfig

mixStreamID - 混流任务ID

Returns:

大于 0 表示成功，且其值为调用序号（seq），用以区分 IZegoMixStreamExCallback.onMixStreamExConfigUpdate(int,java.lang.String,ZegoMixStreamResultEx) 回调；小于等于 0 表示调用失败。

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