com.alivc.live.pusher

Class AlivcLivePusher

java.lang.Object

com.alivc.live.pusher.AlivcLivePusher

All Implemented Interfaces:

ILivePusher

public class AlivcLivePusher
extends java.lang.Object
implements ILivePusher

通过AlivcLivePusher类可以完成音视频的采集推流。

关于AlivcLivePusher的主题有:

1. 状态图
2. 方法调用状态要求
3. 权限
4. 通知监听器
5. 网络监听器
6. 错误监听器
7. 暂停和恢复
8. 同步和异步
9. 异常处理

一、状态图

音视频推流的控制按照状态机进行管理。下面的状态图展示了一个AlivcLivePusher对象在使用过程中的完整的生命周期和状态变化。

二、方法调用的状态要求

方法名	有效状态	无效状态	备注
init	{Idle, Initialized}	{Previewed, Pushed, Paused, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Initialized
destroy	any	{}	调用此方法之后，状态变为{Idle}
startPreview	{Initialized, Previewed}	{Idle, Pushed, Paused, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Previewed
startPreviewAysnc	{Initialized, Previewed}	{Idle, Pushed, Paused, Error,}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Previewed
stopPreview	{Initialized, Previewed}	{Idle, Pushed, Paused, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Initialized
startPush	{Initialized, Previewed, Pushed}	{Idle,Paused, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Pushed
startPushAysnc	{Initialized, Previewed, Pushed}	{Idle, Paused, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Pushed
restartPush	{Pushed, Error}	{Idle, Initialized, Previewed, Paused}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Pushed
restartPushAync	{Pushed, Error}	{Idle, Initialized, Previewed, Paused,}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Pushed
reconnectPushAsync	{Pushed, Paused}	{Idle, Initialized, Previewed, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Initialized
stopPush	{Previewed, Pushed,Error}	{Idle, Initialized, Previewed, Pushed, Paused}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Initialized
pause	{Pushed,Paused,Previewed}	{Idle, Initialized, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Initialized
resume	{Paused,Pushed,Previewed,Initialized}	{Idle, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Initialized
resumeAsync	{Paused,Pushed,Previewed,Initialized}	{Idle, Error}	无效的状态调用此方法，状态不变。在有效的状态下调用此方法，状态变为Initialized

三、权限

这个类需要 {android.permission.CAMERA} {android.permission.RECORD_AUDIO} 权限

七、暂停和恢复

在Activity的onPause和onResume的时候，需要调用pause和resume函数来应对处理处理前后台切换、锁屏、界面跳转及电话等场景。

八、同步和异步

在使用推流SDK的过程中，有以下几个接口由于涉及到硬解和网络，导致接口调用时间消耗可能会较长，因此我们同时也提供了异步接口。此外，我们还提供了一个异步的重连接口方便来处理网络错误。

1. startPreview/startPreviewAsync
2. startPush/startPushAsync
3. restartPush/restartPushAsync
4. resume/resumeAsync
5. reconnectAsync

九、异常

在调用接口的时候，有的接口会抛出 IllegalArgumentException 和 IllegalStateException

1. IllegalArgumentException 表示调用的api的输入参数不合法
2. IllegalStateException 表示调用api时的状态不对

Constructor Summary

Constructors

Constructor and Description
AlivcLivePusher()

Method Summary

Modifier and Type	Method and Description
int	addDynamicsAddons(java.lang.String path, float x, float y, float w, float h) 添加动态贴纸
void	addWaterMark(java.lang.String path, float x, float y, float width) 添加水印，起点位置坐标x[0,width) y[0,height)，宽度(0,width]，最多添加3个 需在startPreview之后调用
void	changeResolution(AlivcResolutionEnum resolutionEnum) change resolution dynamically
void	destroy() 释放推流
void	focusCameraAtAdjustedPoint(float x, float y, boolean autoFocus) 对焦，对焦点的坐标x[0,屏幕宽度],y[0,屏幕宽度]
int	getCurrentExposure() 获取采集曝光
AlivcLivePushStats	getCurrentStatus() 获取当前状态
int	getCurrentZoom() 获取当前缩放值
AlivcLivePushError	getLastError() 获取最近的错误值
AlivcLivePushStatsInfo	getLivePushStatsInfo() 获取推流统计数据
java.lang.String	getLiveTraceId() 获取直播trace id
int	getMaxZoom() 获取摄像头支持的最大缩放值， 0 : 不支持缩放 大于0 : 最大缩放值
java.lang.String	getPushUrl() 获取推流URL
int	getSupportedMaxExposure() 获取采集支持最大曝光
int	getSupportedMinExposure() 获取采集支持最小曝光
void	init(android.content.Context context, AlivcLivePushConfig config) 初始化推流参数
void	inputStreamAudioData(byte[] data, int size, int sampleRate, int channels, long pts) 输入自定义音频数据
void	inputStreamAudioPtr(long dataPtr, int size, int sampleRate, int channels, long pts) 输入自定义音频数据
void	inputStreamVideoData(byte[] data, int width, int height, int stride, int size, long pts, int rotation) 输入自定义视频流
void	inputStreamVideoPtr(long dataptr, int width, int height, int stride, int size, long pts, int rotation) 输入自定义视频流
boolean	isCameraSupportAutoFocus() 获取是否支持自动对焦
boolean	isCameraSupportFlash() 获取是否支持闪光灯
boolean	isNetworkPushing() 获取当前网络推流状态
boolean	isPushing() 是否正在推流
void	pause() 暂停推流
void	pauseBGM() 暂停播放背景音乐
void	pauseScreenCapture() 暂停录屏推流（隐私开）
void	reconnectPushAsync(java.lang.String url) 重新连接进行推流
void	removeDynamicsAddons(int id) 删除动态贴纸
void	restartPush() 重新开始推流
void	restartPushAync() 重新开始推流
void	resume() 恢复推流
void	resumeAsync() 异步恢复推流
void	resumeBGM() 恢复播放背景音乐
void	resumeScreenCapture() 恢复录屏推流（隐私关）
void	sendMessage(java.lang.String info, int repeat, int delay, boolean isKeyFrame) 推流端发送自定义消息
void	setAudioDenoise(boolean on) 设置音频降噪
int	setAudioEffectReverbMode(AlivcLivePushAudioEffectReverbMode mode) 设置混响音效模式 推流前和推流过程中调用都生效
int	setAudioEffectVoiceChangeMode(AlivcLivePushAudioEffectVoiceChangeMode mode) 设置变声音效模式 推流前和推流过程中调用都生效
void	setAutoFocus(boolean autoFocus) 设置自动对焦
void	setBGMEarsBack(boolean isOpen) 设置耳返开关
void	setBGMLoop(boolean isLoop) 设置背景音乐是否循环播放
void	setBGMVolume(int volume) 设置背景音乐混音 人声音量
void	setCaptureVolume(int volume) 设置背景音乐混音 音乐音量
void	setCustomAudioFilter(AlivcLivePushCustomAudioFilter customAudioFilter) 设置用户自定义音频处理回调
void	setCustomDetect(AlivcLivePushCustomDetect customVideoDetect) 设置用户自定义视频人脸识别回调
void	setCustomFilter(AlivcLivePushCustomFilter customVideoFilter) 设置用户自定义视频美颜回调
void	setExposure(int exposure) 设置采集曝光
void	setFlash(boolean flash) 是否打开闪光灯
int	setLiveMixTranscodingConfig(AlivcLiveTranscodingConfig config) 设置云端的混流（转码）参数 一个直播间中可能有不止一位主播，而且每个主播都有自己的画面和声音，但对于 CDN 观众来说，他们只需要一路直播流 所以您需要将多路音视频流混成一路标准的直播流，这就需要混流转码 在连麦场景下，需要将主播和连麦观众音视频流混成一路标准的直播流，供CDN观众观看 在PK场景下，需要将进行PK的多个主播的音视频流混成一路标准的直播流，供CDN观众观看
void	setLivePushBGMListener(AlivcLivePushBGMListener pushBGMListener) 设置背景播放通知事件
void	setLivePusherReference(AlivcLivePusher livePusher) 设置直播推流实例
void	setLivePushErrorListener(AlivcLivePushErrorListener errorListener) 设置推流错误事件
void	setLivePushInfoListener(AlivcLivePushInfoListener infoListener) 设置推流通知事件
void	setLivePushNetworkListener(AlivcLivePushNetworkListener networkListner) 设置网络通知事件
void	setLivePushRenderContextListener(AlivcLivePusherRenderContextListener renderCtxListener) 设置render的context监听
void	setMinVideoBitrate(int minVideoBitrate) 设置最小视频码率[100,5000] （Kbps）
void	setMute(boolean mute) 是否静音
void	setPreviewMirror(boolean mirror) 预览镜像开关
void	setPreviewMode(AlivcPreviewDisplayMode mode) 设置预览显示模式
void	setPreviewOrientation(AlivcPreviewOrientationEnum orientation) 设置推流方向，默认竖屏
void	setPushMirror(boolean mirror) 推流端是否水平镜像
void	setQualityMode(AlivcQualityModeEnum mode) 设置视频质量模式
void	setScreenOrientation(int orientation) 录屏模式下，设置感应的屏幕旋转角度
void	setTargetVideoBitrate(int targetVideoBitrate) 设置目标视频码率[100,5000]（Kbps）
void	setWatermarkVisible(boolean visible) 设置水印可见
void	setZoom(int zoom) 设置缩放[0,getMaxZoom()]
void	snapshot(int count, int interval, AlivcSnapshotListener listener) 视频流截图
void	startBGMAsync(java.lang.String path) 播放背景音
int	startCamera(android.view.SurfaceView surfaceView) 录屏模式下，开启摄像头预览 如果不需要预览，则surfaceview填为null
int	startCameraMix(float x, float y, float w, float h) 录屏模式下，开启摄像头混流
int	startIntelligentDenoise() 开启音频智能降噪 1、使用智能降噪，请关闭普通降噪；两者功能互斥使用 2、智能降噪功能以插件形式提供，调用该接口前，请确保已集成了libpluginAliDenoise.so；插件获取方式请参考官网文档； 3、此接口可以通话过程中控制打开智能降噪功能，通话过程中可以支持开启和关闭智能降噪 4、默认关闭，开启后可能导致功耗增加，智能降噪适合于会议，教育等语音通讯为主的场景，不适合有背景音乐的场景 注意事项！！！
void	startPreview(android.content.Context context, android.widget.FrameLayout frameLayout, boolean isAnchor) 开始预览
void	startPreview(android.view.SurfaceView surfaceView) 开始预览
void	startPreviewAysnc(android.view.SurfaceView surfaceView) 异步开始预览
void	startPush(java.lang.String url) 开始推流
void	startPushAysnc(java.lang.String url) 开始推流
void	stopBGMAsync() 停止播放背景音乐
void	stopCamera() 录屏模式下，关闭摄像头预览
void	stopCameraMix() 录屏模式下，停止摄像头混流
int	stopIntelligentDenoise() 关闭音频智能降噪 此接口可以通话过程中控制关闭智能降噪功能
void	stopPreview() 结束预览
void	stopPush() 结束推流
void	switchCamera() 切换摄像头

Methods inherited from class java.lang.Object

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

Constructor Detail

AlivcLivePusher

public AlivcLivePusher()

Method Detail

init

public void init(android.content.Context context,
                 AlivcLivePushConfig config)
          throws java.lang.IllegalArgumentException,
                 java.lang.IllegalStateException

Description copied from interface: ILivePusher

初始化推流参数

Specified by:

init in interface ILivePusher

Parameters:

context - 上下文

config - 配置

Throws:

java.lang.IllegalArgumentException - 如果 config为空，或者config的值为无效（例如码率的值超过范围）

java.lang.IllegalStateException - 如果状态不对，例如已经初始化，但是还没有销毁

destroy

public void destroy()
             throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

释放推流

Specified by:

destroy in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化

setLivePusherReference

public void setLivePusherReference(AlivcLivePusher livePusher)

Description copied from interface: ILivePusher

设置直播推流实例

Specified by:

setLivePusherReference in interface ILivePusher

Parameters:

livePusher - 推流实例

startPreview

public void startPreview(android.view.SurfaceView surfaceView)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException

Description copied from interface: ILivePusher

开始预览

Specified by:

startPreview in interface ILivePusher

Parameters:

surfaceView - surfaceview

Throws:

java.lang.IllegalArgumentException - 如果surfaceView为空，或者surfaceView的surface未创建/已销毁

java.lang.IllegalStateException - 如果状态不对，例如还未初始化

startPreviewAysnc

public void startPreviewAysnc(android.view.SurfaceView surfaceView)
                       throws java.lang.IllegalArgumentException,
                              java.lang.IllegalStateException

Description copied from interface: ILivePusher

异步开始预览

Specified by:

startPreviewAysnc in interface ILivePusher

Parameters:

surfaceView - surfaceview

Throws:

java.lang.IllegalArgumentException - 如果surfaceView为空，或者surfaceView的surface未创建/已销毁

java.lang.IllegalStateException - 如果状态不对，例如还未初始化

startPreview

public void startPreview(android.content.Context context,
                         android.widget.FrameLayout frameLayout,
                         boolean isAnchor)
                  throws java.lang.IllegalArgumentException,
                         java.lang.IllegalStateException

Description copied from interface: ILivePusher

开始预览

Specified by:

startPreview in interface ILivePusher

Throws:

java.lang.IllegalArgumentException

java.lang.IllegalStateException

stopPreview

public void stopPreview()
                 throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

结束预览

Specified by:

stopPreview in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

startPush

public void startPush(java.lang.String url)
               throws java.lang.IllegalArgumentException,
                      java.lang.IllegalStateException

Description copied from interface: ILivePusher

开始推流

Specified by:

startPush in interface ILivePusher

Parameters:

url - 推流Url

Throws:

java.lang.IllegalArgumentException - 如果url为空，或者不是有效的url格式

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

startPushAysnc

public void startPushAysnc(java.lang.String url)
                    throws java.lang.IllegalArgumentException,
                           java.lang.IllegalStateException

Description copied from interface: ILivePusher

开始推流

Specified by:

startPushAysnc in interface ILivePusher

Parameters:

url - 推流Url

Throws:

java.lang.IllegalArgumentException - 如果url为空，或者不是有效的url格式

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

restartPush

public void restartPush()
                 throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

重新开始推流

Specified by:

restartPush in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush/已经stopPush

restartPushAync

public void restartPushAync()
                     throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

重新开始推流

Specified by:

restartPushAync in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush/已经stopPush

reconnectPushAsync

public void reconnectPushAsync(java.lang.String url)
                        throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

重新连接进行推流

Specified by:

reconnectPushAsync in interface ILivePusher

Throws:

java.lang.IllegalStateException

stopPush

public void stopPush()
              throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

结束推流

Specified by:

stopPush in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush/已经stopPush

pause

public void pause()
           throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

暂停推流

Specified by:

pause in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush/已经pause

resume

public void resume()
            throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

恢复推流

Specified by:

resume in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush/未pause/已resume

resumeAsync

public void resumeAsync()
                 throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

异步恢复推流

Specified by:

resumeAsync in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush/未pause/已resume

switchCamera

public void switchCamera()
                  throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

切换摄像头

Specified by:

switchCamera in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

setAutoFocus

public void setAutoFocus(boolean autoFocus)
                  throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

设置自动对焦

Specified by:

setAutoFocus in interface ILivePusher

Parameters:

autoFocus - 自动聚焦

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

focusCameraAtAdjustedPoint

public void focusCameraAtAdjustedPoint(float x,
                                       float y,
                                       boolean autoFocus)
                                throws java.lang.IllegalArgumentException,
                                       java.lang.IllegalStateException

Description copied from interface: ILivePusher

对焦，对焦点的坐标x[0,屏幕宽度],y[0,屏幕宽度]

Specified by:

focusCameraAtAdjustedPoint in interface ILivePusher

Parameters:

x - 对焦的点x坐标

y - 对焦的点y坐标y

autoFocus - 是否自动聚焦

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

java.lang.IllegalArgumentException

setZoom

public void setZoom(int zoom)
             throws java.lang.IllegalArgumentException,
                    java.lang.IllegalStateException

Description copied from interface: ILivePusher

设置缩放[0,getMaxZoom()]

Specified by:

setZoom in interface ILivePusher

Parameters:

zoom - 0~getMaxZoom()

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

java.lang.IllegalArgumentException

getMaxZoom

public int getMaxZoom()
               throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

获取摄像头支持的最大缩放值， 0 : 不支持缩放 大于0 : 最大缩放值

Specified by:

getMaxZoom in interface ILivePusher

Returns:

最大zoom值

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

getCurrentZoom

public int getCurrentZoom()
                   throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

获取当前缩放值

Specified by:

getCurrentZoom in interface ILivePusher

Returns:

当前缩放值

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

setMute

public void setMute(boolean mute)
             throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

是否静音

Specified by:

setMute in interface ILivePusher

Parameters:

mute - true:静音推流 false:正常推流

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush

setFlash

public void setFlash(boolean flash)
              throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

是否打开闪光灯

Specified by:

setFlash in interface ILivePusher

Parameters:

flash - true:打开闪光灯 false:关闭闪光灯

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

setPushMirror

public void setPushMirror(boolean mirror)
                   throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

推流端是否水平镜像

Specified by:

setPushMirror in interface ILivePusher

Parameters:

mirror - true:打开推流镜像 false:关闭推流镜像

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush

setPreviewMirror

public void setPreviewMirror(boolean mirror)
                      throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

预览镜像开关

Specified by:

setPreviewMirror in interface ILivePusher

Parameters:

mirror - true:打开预览镜像 false:关闭预览镜像

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview

setTargetVideoBitrate

public void setTargetVideoBitrate(int targetVideoBitrate)
                           throws java.lang.IllegalArgumentException,
                                  java.lang.IllegalStateException

Description copied from interface: ILivePusher

设置目标视频码率[100,5000]（Kbps）

Specified by:

setTargetVideoBitrate in interface ILivePusher

Parameters:

targetVideoBitrate - 目标视频编码码率

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush

java.lang.IllegalArgumentException

setMinVideoBitrate

public void setMinVideoBitrate(int minVideoBitrate)
                        throws java.lang.IllegalArgumentException,
                               java.lang.IllegalStateException

Description copied from interface: ILivePusher

设置最小视频码率[100,5000] （Kbps）

Specified by:

setMinVideoBitrate in interface ILivePusher

Parameters:

minVideoBitrate - 最小视频编码码率

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush

java.lang.IllegalArgumentException

isCameraSupportAutoFocus

public boolean isCameraSupportAutoFocus()

Description copied from interface: ILivePusher

获取是否支持自动对焦

Specified by:

isCameraSupportAutoFocus in interface ILivePusher

Returns:

是否支持自动对焦

isCameraSupportFlash

public boolean isCameraSupportFlash()

Description copied from interface: ILivePusher

获取是否支持闪光灯

Specified by:

isCameraSupportFlash in interface ILivePusher

Returns:

是否支持闪光灯

isPushing

public boolean isPushing()
                  throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

是否正在推流

Specified by:

isPushing in interface ILivePusher

Returns:

true:正在推流 false:未推流

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush

isNetworkPushing

public boolean isNetworkPushing()
                         throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

获取当前网络推流状态

Specified by:

isNetworkPushing in interface ILivePusher

Returns:

Throws:

java.lang.IllegalStateException

setCustomDetect

public void setCustomDetect(AlivcLivePushCustomDetect customVideoDetect)

Description copied from interface: ILivePusher

设置用户自定义视频人脸识别回调

Specified by:

setCustomDetect in interface ILivePusher

Parameters:

customVideoDetect - 回调接口

setCustomFilter

public void setCustomFilter(AlivcLivePushCustomFilter customVideoFilter)

Description copied from interface: ILivePusher

设置用户自定义视频美颜回调

Specified by:

setCustomFilter in interface ILivePusher

Parameters:

customVideoFilter - 回调接口

setCustomAudioFilter

public void setCustomAudioFilter(AlivcLivePushCustomAudioFilter customAudioFilter)

Description copied from interface: ILivePusher

设置用户自定义音频处理回调

Specified by:

setCustomAudioFilter in interface ILivePusher

Parameters:

customAudioFilter - 回调接口

getCurrentStatus

public AlivcLivePushStats getCurrentStatus()

Description copied from interface: ILivePusher

获取当前状态

Specified by:

getCurrentStatus in interface ILivePusher

Returns:

setLivePushErrorListener

public void setLivePushErrorListener(AlivcLivePushErrorListener errorListener)

Description copied from interface: ILivePusher

设置推流错误事件

Specified by:

setLivePushErrorListener in interface ILivePusher

Parameters:

errorListener - 错误监听器

setLivePushInfoListener

public void setLivePushInfoListener(AlivcLivePushInfoListener infoListener)

Description copied from interface: ILivePusher

设置推流通知事件

Specified by:

setLivePushInfoListener in interface ILivePusher

Parameters:

infoListener - 通知监听器

setLivePushNetworkListener

public void setLivePushNetworkListener(AlivcLivePushNetworkListener networkListner)

Description copied from interface: ILivePusher

设置网络通知事件

Specified by:

setLivePushNetworkListener in interface ILivePusher

Parameters:

networkListner - 通知监听器

setLivePushBGMListener

public void setLivePushBGMListener(AlivcLivePushBGMListener pushBGMListener)

Description copied from interface: ILivePusher

设置背景播放通知事件

Specified by:

setLivePushBGMListener in interface ILivePusher

Parameters:

pushBGMListener - 通知监听器

setLivePushRenderContextListener

public void setLivePushRenderContextListener(AlivcLivePusherRenderContextListener renderCtxListener)

Description copied from interface: ILivePusher

设置render的context监听

Specified by:

setLivePushRenderContextListener in interface ILivePusher

Parameters:

renderCtxListener - render的context监听

getLivePushStatsInfo

public AlivcLivePushStatsInfo getLivePushStatsInfo()
                                            throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

获取推流统计数据

Specified by:

getLivePushStatsInfo in interface ILivePusher

Returns:

推流统计数据

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化

getPushUrl

public java.lang.String getPushUrl()

Description copied from interface: ILivePusher

获取推流URL

Specified by:

getPushUrl in interface ILivePusher

Returns:

推流URL

setPreviewOrientation

public void setPreviewOrientation(AlivcPreviewOrientationEnum orientation)

Description copied from interface: ILivePusher

设置推流方向，默认竖屏

Specified by:

setPreviewOrientation in interface ILivePusher

Parameters:

orientation - 推流方向

setAudioEffectVoiceChangeMode

public int setAudioEffectVoiceChangeMode(AlivcLivePushAudioEffectVoiceChangeMode mode)

Description copied from interface: ILivePusher

设置变声音效模式

推流前和推流过程中调用都生效

Specified by:

setAudioEffectVoiceChangeMode in interface ILivePusher

Parameters:

mode - 变声音效模式

Returns:

0->成功, 非0->失败

See Also:

变声音效模式枚举

setAudioEffectReverbMode

public int setAudioEffectReverbMode(AlivcLivePushAudioEffectReverbMode mode)

Description copied from interface: ILivePusher

设置混响音效模式

推流前和推流过程中调用都生效

Specified by:

setAudioEffectReverbMode in interface ILivePusher

Parameters:

mode - 混响音效模式

Returns:

0->成功, 非0->失败

See Also:

混响音效模式枚举

startBGMAsync

public void startBGMAsync(java.lang.String path)
                   throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

播放背景音

Specified by:

startBGMAsync in interface ILivePusher

Parameters:

path - 背景音乐路径

Throws:

java.lang.IllegalStateException

stopBGMAsync

public void stopBGMAsync()
                  throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

停止播放背景音乐

Specified by:

stopBGMAsync in interface ILivePusher

Throws:

java.lang.IllegalStateException

pauseBGM

public void pauseBGM()
              throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

暂停播放背景音乐

Specified by:

pauseBGM in interface ILivePusher

Throws:

java.lang.IllegalStateException

resumeBGM

public void resumeBGM()
               throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

恢复播放背景音乐

Specified by:

resumeBGM in interface ILivePusher

Throws:

java.lang.IllegalStateException

setBGMLoop

public void setBGMLoop(boolean isLoop)
                throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

设置背景音乐是否循环播放

Specified by:

setBGMLoop in interface ILivePusher

Parameters:

isLoop - 是否循环 true:循环 false:不循环

Throws:

java.lang.IllegalStateException

setBGMEarsBack

public void setBGMEarsBack(boolean isOpen)
                    throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

设置耳返开关

Specified by:

setBGMEarsBack in interface ILivePusher

Parameters:

isOpen - 是否循环 true:开启耳返 false:关闭耳返

Throws:

java.lang.IllegalStateException

setBGMVolume

public void setBGMVolume(int volume)
                  throws java.lang.IllegalStateException,
                         java.lang.IllegalArgumentException

Description copied from interface: ILivePusher

设置背景音乐混音 人声音量

Specified by:

setBGMVolume in interface ILivePusher

Parameters:

volume - 人声音量大小 范围:[0 ~ 100] 默认:50

Throws:

java.lang.IllegalStateException

java.lang.IllegalArgumentException

setCaptureVolume

public void setCaptureVolume(int volume)
                      throws java.lang.IllegalStateException,
                             java.lang.IllegalArgumentException

Description copied from interface: ILivePusher

设置背景音乐混音 音乐音量

Specified by:

setCaptureVolume in interface ILivePusher

Parameters:

volume - 音乐音量大小 范围:[0 ~ 100] 默认:50

Throws:

java.lang.IllegalStateException

java.lang.IllegalArgumentException

setAudioDenoise

public void setAudioDenoise(boolean on)

Description copied from interface: ILivePusher

设置音频降噪

Specified by:

setAudioDenoise in interface ILivePusher

Parameters:

on - true:开启 false:关闭

startIntelligentDenoise

public int startIntelligentDenoise()

Description copied from interface: ILivePusher

开启音频智能降噪

1、使用智能降噪，请关闭普通降噪；两者功能互斥使用 2、智能降噪功能以插件形式提供，调用该接口前，请确保已集成了libpluginAliDenoise.so；插件获取方式请参考官网文档； 3、此接口可以通话过程中控制打开智能降噪功能，通话过程中可以支持开启和关闭智能降噪 4、默认关闭，开启后可能导致功耗增加，智能降噪适合于会议，教育等语音通讯为主的场景，不适合有背景音乐的场景

注意事项！！！ 如遇libMNN相关的so冲突，请检查当前工程中是否使用到了视频云的其它产品，如美颜SDK/Animoji SDK 美颜SDK/Animoji SDK中，包含libMNN相关的so，因此外部无需再导入一份，只保留libpluginAliDenoise.so， 全局MNN相关的库，统一留一份即可； 具体请查看官网文档或API文档，或者您可以咨询技术同学协助解决问题；

Specified by:

startIntelligentDenoise in interface ILivePusher

Returns:

0->成功, 非0->失败

See Also:

推流SDK（新版）官网文档

stopIntelligentDenoise

public int stopIntelligentDenoise()

Description copied from interface: ILivePusher

关闭音频智能降噪

此接口可以通话过程中控制关闭智能降噪功能

Specified by:

stopIntelligentDenoise in interface ILivePusher

Returns:

0->成功, 非0->失败

setQualityMode

public void setQualityMode(AlivcQualityModeEnum mode)
                    throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

设置视频质量模式

Specified by:

setQualityMode in interface ILivePusher

Throws:

java.lang.IllegalStateException

setPreviewMode

public void setPreviewMode(AlivcPreviewDisplayMode mode)
                    throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

设置预览显示模式

Specified by:

setPreviewMode in interface ILivePusher

Throws:

java.lang.IllegalStateException

pauseScreenCapture

public void pauseScreenCapture()
                        throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

暂停录屏推流（隐私开）

Specified by:

pauseScreenCapture in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush/已经pause

resumeScreenCapture

public void resumeScreenCapture()
                         throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

恢复录屏推流（隐私关）

Specified by:

resumeScreenCapture in interface ILivePusher

Throws:

java.lang.IllegalStateException - 如果状态不对，例如还未初始化/未startPreview/未startPush/未pause/已resume

getLastError

public AlivcLivePushError getLastError()

Description copied from interface: ILivePusher

获取最近的错误值

Specified by:

getLastError in interface ILivePusher

Returns:

changeResolution

public void changeResolution(AlivcResolutionEnum resolutionEnum)

Description copied from interface: ILivePusher

change resolution dynamically

Specified by:

changeResolution in interface ILivePusher

addWaterMark

public void addWaterMark(java.lang.String path,
                         float x,
                         float y,
                         float width)

Description copied from interface: ILivePusher

添加水印，起点位置坐标x[0,width) y[0,height)，宽度(0,width]，最多添加3个 需在startPreview之后调用

Specified by:

addWaterMark in interface ILivePusher

Parameters:

path - 水印图片

x - 水印左上角x轴位置 相对位置 0～1

y - 水印右上角y轴位置 相对位置 0～1

width - 水印显示宽度 相对位置 0～1

setWatermarkVisible

public void setWatermarkVisible(boolean visible)

Description copied from interface: ILivePusher

设置水印可见

Specified by:

setWatermarkVisible in interface ILivePusher

Parameters:

visible - 是否可见

startCamera

public int startCamera(android.view.SurfaceView surfaceView)
                throws java.lang.IllegalStateException

Description copied from interface: ILivePusher

录屏模式下，开启摄像头预览 如果不需要预览，则surfaceview填为null

Specified by:

startCamera in interface ILivePusher

Returns:

Throws:

java.lang.IllegalStateException

stopCamera

public void stopCamera()

Description copied from interface: ILivePusher

录屏模式下，关闭摄像头预览

Specified by:

stopCamera in interface ILivePusher

setScreenOrientation

public void setScreenOrientation(int orientation)

Description copied from interface: ILivePusher

录屏模式下，设置感应的屏幕旋转角度

Specified by:

setScreenOrientation in interface ILivePusher

startCameraMix

public int startCameraMix(float x,
                          float y,
                          float w,
                          float h)

Description copied from interface: ILivePusher

录屏模式下，开启摄像头混流

Specified by:

startCameraMix in interface ILivePusher

Parameters:

x - 混流显示x初始位置(0~1.0f)

y - 混流显示y初始位置(0~1.0f)

w - 混流显示宽度(0~1.0f)

h - 混流显示高度(0~1.0f)

Returns:

stopCameraMix

public void stopCameraMix()

Description copied from interface: ILivePusher

录屏模式下，停止摄像头混流

Specified by:

stopCameraMix in interface ILivePusher

snapshot

public void snapshot(int count,
                     int interval,
                     AlivcSnapshotListener listener)

Description copied from interface: ILivePusher

视频流截图

Specified by:

snapshot in interface ILivePusher

Parameters:

count - 截取图片的个数，该参数仅在普通模式下生效！！！

interval - 每张图片的间隔，该参数仅在普通模式下生效！！！

listener - 截图回调

inputStreamVideoPtr

public void inputStreamVideoPtr(long dataptr,
                                int width,
                                int height,
                                int stride,
                                int size,
                                long pts,
                                int rotation)

Description copied from interface: ILivePusher

输入自定义视频流

Specified by:

inputStreamVideoPtr in interface ILivePusher

Parameters:

dataptr - native内存指针

width - 视频图像宽度

height - 视频图像高度

size - 视频图像size

pts - 视频图像pts（us）

rotation - 视频图像旋转角度

inputStreamVideoData

public void inputStreamVideoData(byte[] data,
                                 int width,
                                 int height,
                                 int stride,
                                 int size,
                                 long pts,
                                 int rotation)

Description copied from interface: ILivePusher

输入自定义视频流

Specified by:

inputStreamVideoData in interface ILivePusher

Parameters:

data - 视频图像byte array

width - 视频图像宽度

height - 视频图像高度

size - 视频图像size

pts - 视频图像pts（us）

rotation - 视频图像旋转角度

inputStreamAudioPtr

public void inputStreamAudioPtr(long dataPtr,
                                int size,
                                int sampleRate,
                                int channels,
                                long pts)

Description copied from interface: ILivePusher

输入自定义音频数据

Specified by:

inputStreamAudioPtr in interface ILivePusher

Parameters:

dataPtr - 音频数据native内存指针

pts - 音频数据pts(US)

inputStreamAudioData

public void inputStreamAudioData(byte[] data,
                                 int size,
                                 int sampleRate,
                                 int channels,
                                 long pts)

Description copied from interface: ILivePusher

输入自定义音频数据

Specified by:

inputStreamAudioData in interface ILivePusher

Parameters:

data - 音频数据 byte array

pts - 音频数据pts(US)

addDynamicsAddons

public int addDynamicsAddons(java.lang.String path,
                             float x,
                             float y,
                             float w,
                             float h)

Description copied from interface: ILivePusher

添加动态贴纸

Specified by:

addDynamicsAddons in interface ILivePusher

Parameters:

path - 贴纸路径，带config.json

x - 显示起始x位置(0~1.0f)

y - 显示起始y位置(0~1.0f)

w - 显示宽度(0~1.0f)

h - 显示高度(0~1.0f)

Returns:

id 贴纸id

removeDynamicsAddons

public void removeDynamicsAddons(int id)

Description copied from interface: ILivePusher

删除动态贴纸

Specified by:

removeDynamicsAddons in interface ILivePusher

Parameters:

id - 贴纸id

setExposure

public void setExposure(int exposure)

Description copied from interface: ILivePusher

设置采集曝光

Specified by:

setExposure in interface ILivePusher

getCurrentExposure

public int getCurrentExposure()

Description copied from interface: ILivePusher

获取采集曝光

Specified by:

getCurrentExposure in interface ILivePusher

getSupportedMinExposure

public int getSupportedMinExposure()

Description copied from interface: ILivePusher

获取采集支持最小曝光

Specified by:

getSupportedMinExposure in interface ILivePusher

getSupportedMaxExposure

public int getSupportedMaxExposure()

Description copied from interface: ILivePusher

获取采集支持最大曝光

Specified by:

getSupportedMaxExposure in interface ILivePusher

sendMessage

public void sendMessage(java.lang.String info,
                        int repeat,
                        int delay,
                        boolean isKeyFrame)

Description copied from interface: ILivePusher

推流端发送自定义消息

Specified by:

sendMessage in interface ILivePusher

Parameters:

info - 需要插入流的SEI消息体，建议是json格式

repeat - 发送的帧数

delay - 延时多少毫秒发送

isKeyFrame - 是否只发送关键帧

setLiveMixTranscodingConfig

public int setLiveMixTranscodingConfig(AlivcLiveTranscodingConfig config)

Description copied from interface: ILivePusher

设置云端的混流（转码）参数 一个直播间中可能有不止一位主播，而且每个主播都有自己的画面和声音，但对于 CDN 观众来说，他们只需要一路直播流 所以您需要将多路音视频流混成一路标准的直播流，这就需要混流转码 在连麦场景下，需要将主播和连麦观众音视频流混成一路标准的直播流，供CDN观众观看 在PK场景下，需要将进行PK的多个主播的音视频流混成一路标准的直播流，供CDN观众观看

Specified by:

setLiveMixTranscodingConfig in interface ILivePusher

Parameters:

config - 参考AlivcLiveDef.h中关于AlivcLiveTranscodingConfig的介绍，如果传入nil，则取消云端混流转码

getLiveTraceId

public java.lang.String getLiveTraceId()

Description copied from interface: ILivePusher

获取直播trace id

Specified by:

getLiveTraceId in interface ILivePusher

Returns:

trace id