com.netease.nimlib.sdk.avchat

接口 AVChatStateObserverLite

所有已知子接口:

AVChatStateObserver

public interface AVChatStateObserverLite

通话过程中的状态变化监听

方法概要

限定符和类型	方法和说明
void	onAudioDeviceChanged(int device, java.util.Set<java.lang.Integer> set, boolean shouldSelect) 音频设备变化
boolean	onAudioFrameFilter(AVChatAudioFrame frame) 语音数据处理接口, 不要改变数据的长度.
void	onCallEstablished() 会话成功建立.
void	onConnectionTypeChanged(int netType) 客户端网络类型发生了变化
void	onDeviceEvent(int code, java.lang.String desc) 语音采集设备和视频采集设备事件通知
void	onDisconnectServer(int code) 从服务器断开连接会收到此通知。
void	onFirstVideoFrameAvailable(java.lang.String account) 用户第一帧视频数据绘制前通知.
void	onFirstVideoFrameRendered(java.lang.String account) 第一帧绘制通知
void	onJoinedChannel(int code, java.lang.String audioFile, java.lang.String videoFile, int elapsed) 服务器连接回调
void	onLeaveChannel() 退出频道.
void	onLiveEvent(int event) 互动直播相关事件通知
void	onNetworkQuality(java.lang.String account, int quality, AVChatNetworkStats stats) 网络状态发生变化
void	onProtocolIncompatible(int status) 双方协议版本不兼容
void	onReportSpeaker(java.util.Map<java.lang.String,java.lang.Integer> speakers, int mixedEnergy) 汇报正在说话的用户。
void	onSessionStats(AVChatSessionStats sessionStats) 实时统计信息
void	onUserJoined(java.lang.String account) 用户加入频道
void	onUserLeave(java.lang.String account, int event) 用户离开频道
void	onVideoFpsReported(java.lang.String account, int fps) 用户视频画面fps更新, 需要设置参数 AVChatParameters.KEY_VIDEO_FPS_REPORTED.
boolean	onVideoFrameFilter(AVChatVideoFrame frame, boolean maybeDualInput) 视频数据外部处理接口, 此接口需要同步执行.
boolean	onVideoFrameFilter(VideoFrame input, VideoFrame[] outputFrames, VideoFilterParameter filterParameter) 视频数据外部处理接口, 此接口需要同步执行.
void	onVideoFrameResolutionChanged(java.lang.String account, int width, int height, int rotate) 用户画面尺寸改变通知

方法详细资料

onJoinedChannel

void onJoinedChannel(int code,
                     java.lang.String audioFile,
                     java.lang.String videoFile,
                     int elapsed)

服务器连接回调

参数:

code - 加入服务器结果 AVChatResCode.JoinChannelCode

audioFile - 如果存在服务器录制,指向语音文件.

videoFile - 如果存在服务器录制,指向视频文件.

elapsed - 从下面三个相关调用处开始计算，到成功加入房间的耗时，单位ms

另请参阅:

AVChatManagerLite.call2(String, AVChatType, AVChatNotifyOption, AVChatCallback), AVChatManagerLite.accept2(long, AVChatCallback), AVChatManagerLite.joinRoom2(String, AVChatType, AVChatCallback)

onUserJoined

void onUserJoined(java.lang.String account)

用户加入频道

参数:

account - 用户账号

另请参阅:

AVChatManagerLite.call2(String, AVChatType, AVChatNotifyOption, AVChatCallback), AVChatManagerLite.accept2(long, AVChatCallback), AVChatManagerLite.joinRoom2(String, AVChatType, AVChatCallback)

onUserLeave

void onUserLeave(java.lang.String account,
                 int event)

用户离开频道

参数:

account - 用户ID

event - AVChatUserQuitType

另请参阅:

AVChatManagerLite.hangUp2(long, AVChatCallback), AVChatManagerLite.leaveRoom2(String, AVChatCallback)

onLeaveChannel

void onLeaveChannel()

退出频道.

另请参阅:

AVChatManagerLite.hangUp2(long, AVChatCallback), AVChatManagerLite.leaveRoom2(String, AVChatCallback)

onProtocolIncompatible

void onProtocolIncompatible(int status)

双方协议版本不兼容

参数:

status - AVChatResCode.ERROR_PROTO_INCOMPATIBLE_LOCAL_LOW 自己版本过低, AVChatResCode.ERROR_PROTO_INCOMPATIBLE_REMOTE_LOW 对方版本过低

另请参阅:

AVChatResCode.ERROR_PROTO_INCOMPATIBLE_REMOTE_LOW, AVChatResCode.ERROR_PROTO_INCOMPATIBLE_LOCAL_LOW

onDisconnectServer

void onDisconnectServer(int code)

从服务器断开连接会收到此通知。

参数:

code - AVChatResCode.ERROR_DISCONNECT_SERVER_TIMEOUT 断网超时离开, AVChatResCode.ERROR_DISCONNECT_SERVER_CHANNEL_CLOSED 房间被关闭

另请参阅:

AVChatResCode.ERROR_DISCONNECT_SERVER_TIMEOUT, AVChatResCode.ERROR_DISCONNECT_SERVER_CHANNEL_CLOSED

onNetworkQuality

void onNetworkQuality(java.lang.String account,
                      int quality,
                      AVChatNetworkStats stats)

网络状态发生变化

参数:

account - 用户账号

quality - 网络状态等级

stats - 网络状态信息

另请参阅:

AVChatNetworkQuality

onCallEstablished

void onCallEstablished()

会话成功建立.

onDeviceEvent

void onDeviceEvent(int code,
                   java.lang.String desc)

语音采集设备和视频采集设备事件通知

参数:

code - 事件ID

desc - 事件描述

另请参阅:

AVChatDeviceEvent

onConnectionTypeChanged

void onConnectionTypeChanged(int netType)

客户端网络类型发生了变化

参数:

netType - 当前的网络类型

另请参阅:

AVChatConnectionType

onFirstVideoFrameAvailable

void onFirstVideoFrameAvailable(java.lang.String account)

用户第一帧视频数据绘制前通知.

参数:

account - 用户账号

onFirstVideoFrameRendered

void onFirstVideoFrameRendered(java.lang.String account)

第一帧绘制通知

参数:

account - 用户账号

onVideoFrameResolutionChanged

void onVideoFrameResolutionChanged(java.lang.String account,
                                   int width,
                                   int height,
                                   int rotate)

用户画面尺寸改变通知

参数:

account - 用户账号

width - 视频宽

height - 视频高

rotate - 视频角度

onVideoFpsReported

void onVideoFpsReported(java.lang.String account,
                        int fps)

用户视频画面fps更新, 需要设置参数 AVChatParameters.KEY_VIDEO_FPS_REPORTED.

参数:

account - 用户账号

fps - 当前绘制帧率

另请参阅:

AVChatParameters.KEY_VIDEO_FPS_REPORTED, AVChatManagerLite.setParameter(AVChatParameters.Key, Object)

onVideoFrameFilter

boolean onVideoFrameFilter(AVChatVideoFrame frame,
                           boolean maybeDualInput)

视频数据外部处理接口, 此接口需要同步执行. 操作运行在视频数据发送线程上,处理速度过慢会导致帧率过低

参数:

frame - 待处理数据

maybeDualInput - 如果为 true 则代表需要外部输入两路数据， AVChatVideoFrame.data 处理后的原始数据，AVChatVideoFrame.dataMirror 处理后的镜像数据。 如果为 false 则代表仅需要外部输入一路数据，仅支持 AVChatVideoFrame.data。 在实际使用过程中，用户需要根据自己需求来决定是否真正需要输入镜像数据，一般在使用到水印等外部处理时才会需要真正输入两路数据，其他情况可以忽略此参数。

返回:

返回true成功

onVideoFrameFilter

boolean onVideoFrameFilter(VideoFrame input,
                           VideoFrame[] outputFrames,
                           VideoFilterParameter filterParameter)

视频数据外部处理接口, 此接口需要同步执行. 操作运行在视频数据发送线程上,处理速度过慢会导致帧率过低

参数:

input - 待处理数据

outputFrames - VideoFrame[0] 处理后的原始数据，VideoFrame[1] 处理后的镜像数据。 如果为 false 则代表仅需要外部输入一路数据，仅支持 VideoFrame[0]。 在实际使用过程中，用户需要根据自己需求来决定是否真正需要输入镜像数据，一般在使用到水印等外部处理时才会需要真正输入两路数据，其他情况可以忽略此参数。

filterParameter - 待处理数据的参数

返回:

返回true成功

onAudioFrameFilter

boolean onAudioFrameFilter(AVChatAudioFrame frame)

语音数据处理接口, 不要改变数据的长度. 需要设置参数 AVChatParameters.KEY_AUDIO_FRAME_FILTER.

参数:

frame - 语音帧

返回:

返回false 失败

另请参阅:

AVChatParameters.KEY_AUDIO_FRAME_FILTER, AVChatManagerLite.setParameter(AVChatParameters.Key, Object)

onAudioDeviceChanged

void onAudioDeviceChanged(int device,
                          java.util.Set<java.lang.Integer> set,
                          boolean shouldSelect)

音频设备变化

参数:

device - 语音设备

set - 可选语音设备

shouldSelect - 如果为true，可以弹框选择蓝牙外放、耳机外放选项

另请参阅:

AVChatAudioDevice

onReportSpeaker

void onReportSpeaker(java.util.Map<java.lang.String,java.lang.Integer> speakers,
                     int mixedEnergy)

汇报正在说话的用户。 需要设置参数 AVChatParameters.KEY_AUDIO_REPORT_SPEAKER.

参数:

speakers - 用户账号和声音强度的键值对

mixedEnergy - 除去自己后，所有用户语音混音后的强度

另请参阅:

AVChatParameters.KEY_AUDIO_REPORT_SPEAKER, AVChatManagerLite.setParameter(AVChatParameters.Key, Object)

onSessionStats

void onSessionStats(AVChatSessionStats sessionStats)

实时统计信息

参数:

sessionStats - 详细的统计信息

onLiveEvent

void onLiveEvent(int event)

互动直播相关事件通知

参数:

event - AVChatResCode.LiveEventCode