public abstract class NERtcEx extends NERtc
构造器和说明 |
---|
NERtcEx() |
限定符和类型 | 方法和说明 |
---|---|
abstract int |
addLiveStreamTask(NERtcLiveStreamTaskInfo taskInfo,
AddLiveTaskCallback addLiveTaskCallback)
添加房间推流任务,成功添加后当前用户可以收到该直播流的状态通知。
|
abstract int |
adjustPlaybackSignalVolume(int volume)
调节播放音量
|
abstract int |
adjustRecordingSignalVolume(int volume)
调节采集音量
|
abstract int |
enableAudioVolumeIndication(boolean enable,
int interval)
启用说话者音量提示。
|
abstract int |
enableDualStreamMode(boolean enable)
是否开启双流模式
|
abstract int |
enableEarback(boolean enabled,
int volume)
开启或关闭耳返
|
abstract long |
getAudioMixingCurrentPosition()
获取混音任务当前进度
|
abstract long |
getAudioMixingDuration()
获取混音文件时长
|
abstract int |
getAudioMixingPlaybackVolume()
获取混音播放音量
|
abstract int |
getAudioMixingSendVolume()
获取混音发送音量
|
abstract int |
getCameraCurrentZoom()
获取当前缩放比例
|
abstract int |
getCameraMaxZoom()
获取摄像头支持的最大视频缩放比例
|
abstract int |
getConnectionState()
获取当前网络状态
|
abstract int |
getEffectPlaybackVolume(int effectId)
获取音效文件播放音量
|
abstract int |
getEffectSendVolume(int effectId)
获取音效文件发送音量
|
static NERtcEx |
getInstance()
获取NERtc实例
|
abstract boolean |
isCameraExposurePositionSupported()
相机是否支持手动曝光
|
abstract boolean |
isCameraFocusSupported()
相机是否支持手动对焦
|
abstract boolean |
isCameraTorchSupported()
相机是否支持闪光灯
|
abstract boolean |
isCameraZoomSupported()
相机是否支持缩放
|
abstract boolean |
isPlayoutDeviceMute()
获取当前音频播放设备是否静音
|
abstract boolean |
isRecordDeviceMute()
获取音频采集设备是否静音
|
abstract boolean |
isSpeakerphoneOn()
获取扬声器是否开启
|
abstract int |
muteLocalAudioStream(boolean mute)
开关本地音频发送。
|
abstract int |
muteLocalVideoStream(boolean mute)
开关本地视频发送
|
abstract int |
pauseAllEffects()
暂停所有音效文件播放
|
abstract int |
pauseAudioMixing()
暂停混音
|
abstract int |
pauseEffect(int effectId)
暂停音效文件播放
|
abstract int |
playEffect(int effectId,
NERtcCreateAudioEffectOption option)
播放指定音效文件
|
abstract void |
postOnGLThread(java.lang.Runnable runnable)
将操作设置到具有GLContext的线程中(第三方滤镜时需要用到)
如销毁第三方滤镜资源 |
abstract int |
pullExternalAudioFrame(java.nio.ByteBuffer buffer,
int len)
获取外部音频渲染数据
|
abstract boolean |
pushExternalAudioFrame(NERtcAudioExternalFrame frame)
推送外部音频数据输入
该方法将音频数据帧设置给内部引擎,该方法在外部音频输入工作
|
abstract boolean |
pushExternalVideoFrame(NERtcVideoFrame frame)
推送外部视频帧
该方法主动将视频帧数据用 NERtcVideoFrame 类封装后传递给 SDK。 |
abstract int |
removeLiveStreamTask(java.lang.String taskId,
DeleteLiveTaskCallback deleteLiveTaskCallback)
删除房间推流任务。
|
abstract int |
resumeAllEffects()
恢复播放所有音效文件
|
abstract int |
resumeAudioMixing()
恢复混音
|
abstract int |
resumeEffect(int effectId)
恢复播放指定音效文件
|
abstract int |
sendSEIMsg(java.lang.String seiMsg)
使用主流通道发送SEI 信息
|
abstract int |
sendSEIMsg(java.lang.String seiMsg,
NERtcVideoStreamType streamType)
发送SEI 信息
|
abstract int |
setAudioFocusMode(int focusMode)
设置音频焦点模式
|
abstract int |
setAudioFrameObserver(NERtcAudioFrameObserver observer)
设置音频采集/播放PCM回调,用于声音处理等操作
|
abstract int |
setAudioMixingPlaybackVolume(int volume)
设置混音播放音量
|
abstract int |
setAudioMixingPosition(long position)
定位到具体混音时间点
|
abstract int |
setAudioMixingSendVolume(int volume)
设置混音发送音量
|
abstract int |
setAudioProcessObserver(NERtcAudioProcessObserver audioProcessObserver)
设置音频处理回调
|
abstract int |
setCameraExposurePosition(float x,
float y)
设置手动曝光位置
|
abstract int |
setCameraFocusPosition(float x,
float y)
设置对焦区域
|
abstract int |
setCameraTorchOn(boolean on)
开启或关闭闪光灯
|
abstract void |
setCameraZoomFactor(int zoomValue)
设置缩放
|
abstract int |
setChannelProfile(int channelProfile)
设置channel profile , 必须在joinChannel 之前调用有效
|
abstract int |
setClientRole(int role)
设置用户角色, 主播/观众
|
abstract int |
setEarbackVolume(int volume)
设置耳返音量
|
abstract int |
setEffectPlaybackVolume(int effectId,
int volume)
设置音效文件播放音量
|
abstract int |
setEffectSendVolume(int effectId,
int volume)
设置音效文件发送音量
|
abstract int |
setExternalAudioRender(boolean enable,
int sampleRate,
int channels)
开启或关闭外部音频渲染
|
abstract int |
setExternalAudioSource(boolean enabled,
int sample_rate,
int channels)
开启或关闭外部音频源数据输入
该方法启用外部音频数据输入功能,只允许通话前调用。
|
abstract void |
setExternalVideoSource(boolean enable)
是否使用外部视频源(请在调用 enableVideo 或 startPreview 之前调用此 API)
|
abstract int |
setLocalVoiceChangerPreset(NERtcVoiceChangerType type)
设置预设的本地语音变声(通话结束后重置为默认关闭)
|
abstract int |
setLocalVoiceEqualizationPreset(NERtcVoiceEqualizationType type)
设置预设的本地语音音效均衡(通话结束后重置为默认关闭)
|
abstract int |
setLocalVoiceEqualizations(int[] bandGain)
设置本地语音音效均衡(通话结束后重置为默认关闭)
|
abstract int |
setLocalVoiceReverbPreset(NERtcVoiceReverbType type)
设置预设的本地语音混响效果(通话结束后重置为默认关闭)
|
abstract int |
setMixedAudioFrameParameters(NERtcAudioFrameRequestFormat format)
设置录制与播放声音混音后的数据格式。
|
abstract int |
setPlaybackAudioFrameParameters(NERtcAudioFrameRequestFormat format)
设置录制的声音格式。
|
abstract int |
setPlayoutDeviceMute(boolean enable)
设置是否音频播放静音
|
abstract int |
setRecordDeviceMute(boolean enable)
设置是否音频采集静音
|
abstract int |
setRecordingAudioFrameParameters(NERtcAudioFrameRequestFormat format)
设置录制的声音格式。
|
abstract int |
setSpeakerphoneOn(boolean enable)
设置扬声器是否开启
|
abstract void |
setStatsObserver(NERtcStatsObserver statsObserver)
设置统计信息回调
|
abstract int |
setupLocalSubStreamVideoCanvas(com.netease.lava.api.IVideoRender render)
设置本地辅流画布,同一个画布只能设置给一个用户
|
abstract int |
setupRemoteSubStreamVideoCanvas(com.netease.lava.api.IVideoRender render,
long uid)
设置远端用户辅流画布
|
abstract void |
setVideoCallback(NERtcVideoCallback videoCallback,
boolean textureWithI420)
设置视频采集数据回调,用于美颜等操作
|
abstract int |
startAudioDump()
开始音频dump
|
abstract int |
startAudioMixing(NERtcCreateAudioMixingOption option)
开始混音
|
abstract int |
startScreenCapture(NERtcScreenConfig screenConfig,
android.content.Intent mediaProjectionPermissionResultData,
android.media.projection.MediaProjection.Callback mediaProjectionCallback)
开启屏幕共享
|
abstract int |
stopAllEffects()
停止播放所有音效文件
|
abstract int |
stopAudioDump()
结束音频dump
|
abstract int |
stopAudioMixing()
结束混音
|
abstract int |
stopEffect(int effectId)
停止播放指定音效文件
|
abstract void |
stopScreenCapture()
停止屏幕共享
|
abstract int |
subscribeRemoteSubStreamVideo(long uid,
boolean subscribe)
订阅 / 取消订阅指定远端用户的辅流
|
abstract int |
switchCamera()
切换摄像头
|
abstract int |
updateLiveStreamTask(NERtcLiveStreamTaskInfo taskInfo,
UpdateLiveTaskCallback updateLiveTaskCallback)
更新修改房间推流任务。
|
abstract void |
uploadSdkInfo()
上传SDK信息
|
checkPermission, enableLocalAudio, enableLocalVideo, init, joinChannel, leaveChannel, release, setAudioProfile, setLocalVideoConfig, setParameters, setupLocalVideoCanvas, setupRemoteVideoCanvas, startVideoPreview, stopVideoPreview, subscribeAllRemoteAudioStreams, subscribeRemoteAudioStream, subscribeRemoteVideoStream, version
public static NERtcEx getInstance()
public abstract int muteLocalAudioStream(boolean mute)
mute
- true: 静音本地音频
false: 取消静音本地音频0
方法调用成功,其他失败public abstract int muteLocalVideoStream(boolean mute)
mute
- true: 不发送本地视频流, false: 重新发送本地视频流0
方法调用成功,其他调用失败public abstract int sendSEIMsg(java.lang.String seiMsg, NERtcVideoStreamType streamType)
seiMsg
- sei 信息 , 最大长度不能超过4kstreamType
- 指定使用那个视频通道(主流/辅流)发送SEIstartScreenCapture(com.netease.lava.nertc.sdk.video.NERtcScreenConfig, android.content.Intent, android.media.projection.MediaProjection.Callback)
0
方法调用成功,其他失败NERtcCallbackEx.onRecvSEIMsg(long, String)
public abstract int sendSEIMsg(java.lang.String seiMsg)
seiMsg
- sei 信息 , 最大长度不能超过4k0
方法调用成功,其他失败NERtcCallbackEx.onRecvSEIMsg(long, String)
,
sendSEIMsg(String, NERtcVideoStreamType)
public abstract int switchCamera()
0
方法调用成功,其他调用失败public abstract boolean isCameraZoomSupported()
public abstract void setCameraZoomFactor(int zoomValue)
zoomValue
- 缩放参数public abstract int getCameraCurrentZoom()
public abstract int getCameraMaxZoom()
public abstract boolean isCameraTorchSupported()
public abstract int setCameraTorchOn(boolean on)
on
- true:开启 false:关闭public abstract boolean isCameraExposurePositionSupported()
public abstract int setCameraExposurePosition(float x, float y)
x
- 曝光区域x 坐标y
- 曝光区域y 坐标public abstract boolean isCameraFocusSupported()
public abstract int setCameraFocusPosition(float x, float y)
x
- 对焦区域x坐标y
- 对焦区域y坐标public abstract boolean isSpeakerphoneOn()
public abstract int setSpeakerphoneOn(boolean enable)
enable
- 扬声器是否打开0
方法调用成功,其他失败public abstract int setAudioFocusMode(int focusMode)
0
方法调用成功,其他失败public abstract int startAudioDump()
0
方法调用成功,其他失败public abstract int stopAudioDump()
0
方法调用成功,其他失败public abstract int setLocalVoiceChangerPreset(NERtcVoiceChangerType type)
type
- NERtcVoiceChangerType
语音变声类型0
方法调用成功,其他失败public abstract int setLocalVoiceReverbPreset(NERtcVoiceReverbType type)
type
- NERtcVoiceReverbType
混响效果类型0
方法调用成功,其他失败public abstract int setLocalVoiceEqualizations(int[] bandGain)
bandGain
- 每个 band 的增益,数组大小为10,[0-9]分别代表 10 个频带,对应的中心频率是 [31,63,125,250,500,1k,2k,4k,8k,16k] Hz
单位是 dB,每一个值的范围是 [-15,15],默认值为 00
方法调用成功,其他失败public abstract int setLocalVoiceEqualizationPreset(NERtcVoiceEqualizationType type)
type
- NERtcVoiceEqualizationType
语音音效均衡类型0
方法调用成功,其他失败public abstract int setupLocalSubStreamVideoCanvas(com.netease.lava.api.IVideoRender render)
render
- 视频绘制画布0
方法调用成功,其他调用失败NERtcVideoView
public abstract int setupRemoteSubStreamVideoCanvas(com.netease.lava.api.IVideoRender render, long uid)
render
- 视频绘制画布uid
- 用户ID0
方法调用成功,其他调用失败NERtcVideoView
public abstract int startScreenCapture(NERtcScreenConfig screenConfig, android.content.Intent mediaProjectionPermissionResultData, android.media.projection.MediaProjection.Callback mediaProjectionCallback)
screenConfig
- NERtcScreenConfig
mediaProjectionPermissionResultData
- 录屏权限请求返回的IntentmediaProjectionCallback
- 录屏停止回调监听RTCResult
public abstract void stopScreenCapture()
public abstract int subscribeRemoteSubStreamVideo(long uid, boolean subscribe)
uid
- 指定用户的用户 IDsubscribe
- true: 订阅指定辅流 false: 取消订阅指定辅流0
方法调用成功,其他调用失败public abstract void setExternalVideoSource(boolean enable)
enable
- true:使用外部视频源 false:不使用外部视频源(默认)public abstract boolean pushExternalVideoFrame(NERtcVideoFrame frame)
frame
- 视频帧的数据信息 NERtcVideoFrame
public abstract int setExternalAudioSource(boolean enabled, int sample_rate, int channels)
enabled
- - true:使用外部视频源
- false:不使用外部视频源(默认);sample_rate
- 数据采样率,后续数据传入需要按该格式传入。channels
- 数据声道数,后续数据传入需要按该格式传入。public abstract boolean pushExternalAudioFrame(NERtcAudioExternalFrame frame)
frame
- 音频帧数据;public abstract int setExternalAudioRender(boolean enable, int sampleRate, int channels)
enable
- true:开 false: 关sampleRate
- 采样率channels
- 声道数0
方法调用成功,其他调用失败public abstract int pullExternalAudioFrame(java.nio.ByteBuffer buffer, int len)
buffer
- 需要填充的buffer数组(需要调用方创建,必须使用ByteBuffer.allocateDirect创建)len
- 待拉取音频数据的字节数,单位为 byte。 建议音频数据的时长至少为 10 毫秒。计算公式为:
len = sampleRate/1000 × 2 × channels × 音频数据时长(毫秒)0
方法调用成功,其他调用失败public abstract void setVideoCallback(NERtcVideoCallback videoCallback, boolean textureWithI420)
videoCallback
- NERtcVideoCallback
textureWithI420
- 是否需要同时返回YUVI420和Texture的数据(该操作会有一定耗时,只有在第三方滤镜库要求一定要yuv数据时才需要打开)public abstract int setAudioFrameObserver(NERtcAudioFrameObserver observer)
observer
- NERtcAudioFrameObserver
RTCResult
public abstract int setAudioProcessObserver(NERtcAudioProcessObserver audioProcessObserver)
audioProcessObserver
- NERtcAudioProcessObserver
RTCResult
public abstract int setRecordingAudioFrameParameters(NERtcAudioFrameRequestFormat format)
setAudioFrameObserver(com.netease.lava.nertc.sdk.audio.NERtcAudioFrameObserver)
回调的录制声音格式。
joinChannel 前/后都允许更改设置。leaveChannel 后重置为空。format
- 指定 NERtcAudioFrameObserver.onRecordFrame(com.netease.lava.nertc.sdk.audio.NERtcAudioFrame)
中返回数据的采样率和数据的通道数。允许传入 NULL,默认为 NULL。public abstract int setPlaybackAudioFrameParameters(NERtcAudioFrameRequestFormat format)
setAudioFrameObserver(com.netease.lava.nertc.sdk.audio.NERtcAudioFrameObserver)
回调的播放声音格式。
joinChannel 前/后都允许更改设置。leaveChannel 后重置为空。format
- 指定 NERtcAudioFrameObserver.onRecordFrame(com.netease.lava.nertc.sdk.audio.NERtcAudioFrame)
中返回数据的采样率和数据的通道数。允许传入 NULL,默认为 NULL。public abstract int setMixedAudioFrameParameters(NERtcAudioFrameRequestFormat format)
setAudioFrameObserver(com.netease.lava.nertc.sdk.audio.NERtcAudioFrameObserver)
回调的声音格式。
joinChannel 前/后都允许更改设置。leaveChannel 后重置为空。format
- 指定 NERtcAudioFrameObserver.onMixedAudioFrame(NERtcAudioFrame)
(com.netease.lava.nertc.sdk.audio.NERtcAudioFrame)}
中返回数据的采样率和数据的通道数。允许传入 NULL,默认为 NULL。public abstract void postOnGLThread(java.lang.Runnable runnable)
runnable
- 具体操作任务public abstract void setStatsObserver(NERtcStatsObserver statsObserver)
statsObserver
- NERtcStatsObserver
public abstract int enableAudioVolumeIndication(boolean enable, int interval)
NERtcCallbackEx.onRemoteAudioVolumeIndication
enable
- 是否启用说话者音量提示interval
- 指定音量提示的时间间隔,单位为毫秒。必须设置为 100 毫秒的整数倍值0
方法调用成功,其他失败public abstract int adjustRecordingSignalVolume(int volume)
volume
- [0-400]0
方法调用成功,其他失败public abstract int adjustPlaybackSignalVolume(int volume)
volume
- [0-400]0
方法调用成功,其他失败public abstract int startAudioMixing(NERtcCreateAudioMixingOption option)
option
- 构造参数 NERtcCreateAudioMixingOption
0
方法调用成功,其他失败public abstract int stopAudioMixing()
0
方法调用成功,其他失败public abstract int pauseAudioMixing()
0
方法调用成功,其他失败public abstract int resumeAudioMixing()
0
方法调用成功,其他失败public abstract int setAudioMixingSendVolume(int volume)
volume
- 音量[0 -100]0
方法调用成功,其他失败public abstract int getAudioMixingSendVolume()
public abstract int setAudioMixingPlaybackVolume(int volume)
volume
- 音量[0 -100]0
方法调用成功,其他失败public abstract int getAudioMixingPlaybackVolume()
public abstract long getAudioMixingDuration()
public abstract long getAudioMixingCurrentPosition()
public abstract int setAudioMixingPosition(long position)
position
- 定位时间点0
方法调用成功,其他失败public abstract int playEffect(int effectId, NERtcCreateAudioEffectOption option)
effectId
- 指定音效的 ID。每个音效均有唯一的 IDoption
- 音效设置参数,多次连续stopEffect(int)
play 同一个effectId的音效,后续均按首次设置的option参数来,后续的option 无效。0
方法调用成功,其他失败public abstract int stopEffect(int effectId)
effectId
- 指定音效的 ID。每个音效均有唯一的 ID0
方法调用成功,其他失败public abstract int stopAllEffects()
0
方法调用成功,其他失败public abstract int pauseEffect(int effectId)
effectId
- 指定音效的 ID。每个音效均有唯一的 ID0
方法调用成功,其他失败public abstract int resumeEffect(int effectId)
effectId
- 指定音效的 ID。每个音效均有唯一的 ID0
方法调用成功,其他失败public abstract int pauseAllEffects()
0
方法调用成功,其他失败public abstract int resumeAllEffects()
0
方法调用成功,其他失败public abstract int setEffectSendVolume(int effectId, int volume)
effectId
- 指定音效的 ID。每个音效均有唯一的 IDvolume
- 发送音量[0 - 100](默认 100)0
方法调用成功,其他失败public abstract int getEffectSendVolume(int effectId)
effectId
- 指定音效的 ID。每个音效均有唯一的 IDpublic abstract int setEffectPlaybackVolume(int effectId, int volume)
effectId
- 指定音效的 ID。每个音效均有唯一的 IDvolume
- 播放音量[0 - 100](默认 100)0
方法调用成功,其他失败public abstract int getEffectPlaybackVolume(int effectId)
effectId
- 指定音效的 ID。每个音效均有唯一的 ID0
方法调用成功,其他失败public abstract int enableEarback(boolean enabled, int volume)
enabled
- true:开启,false:关闭volume
- 耳返音量 [0 - 100](默认 100)0
方法调用成功,其他失败public abstract int setEarbackVolume(int volume)
volume
- 耳返音量 [0 - 100](默认 100)0
方法调用成功,其他失败public abstract int setPlayoutDeviceMute(boolean enable)
enable
- true/false0
方法调用成功,其他失败public abstract boolean isPlayoutDeviceMute()
public abstract int setRecordDeviceMute(boolean enable)
enable
- true/false0
方法调用成功,其他失败public abstract boolean isRecordDeviceMute()
public abstract void uploadSdkInfo()
public abstract int addLiveStreamTask(NERtcLiveStreamTaskInfo taskInfo, AddLiveTaskCallback addLiveTaskCallback)
taskInfo
- 直播任务信息addLiveTaskCallback
- 操作结果回调,方法调用成功才有回调0
方法调用成功 , 其他失败。public abstract int updateLiveStreamTask(NERtcLiveStreamTaskInfo taskInfo, UpdateLiveTaskCallback updateLiveTaskCallback)
taskInfo
- 直播任务信息updateLiveTaskCallback
- 操作结果回调,方法调用成功才有回调0
方法调用成功 ,其他失败 。public abstract int removeLiveStreamTask(java.lang.String taskId, DeleteLiveTaskCallback deleteLiveTaskCallback)
taskId
- 直播任务iddeleteLiveTaskCallback
- 操作结果回调,方法调用成功才有回调0
方法调用成功 ,其他失败。public abstract int setChannelProfile(int channelProfile)
channelProfile
- NERtcConstants.RTCChannelProfile
0
方法调用成功,其他调用失败public abstract int enableDualStreamMode(boolean enable)
enable
- true:开启小流(默认),false: 关闭小流0
方法调用成功,其他调用失败public abstract int getConnectionState()
NERtcConstants.ConnectionState
public abstract int setClientRole(int role)
role
- NERtcConstants.UserRole
0
方法调用成功,其他调用失败