JRTCGuestCallback接口 参考

Public 成员函数
void	onGetAllGroups (boolean result, List< JRTCCallCenterGroupItem > groups)
void	onCallStateChanged (@GuestCallStateChangeType int type, @CallIncomingType int incomingType, JRTCInviter inviter, @CallTermReason int reason)
void	onCallQueueCount (int count, int time)
void	onCallQueueCount (int count, int time, boolean agentRinging)
void	onCallPropertyChanged (PropChangeParam propChangeParam)
void	onMemberJoin (JRTCRoomParticipant participant)
void	onMemberLeave (JRTCRoomParticipant participant)
void	onMemberUpdate (JRTCRoomParticipant participant, ChangeParam changeParam)
void	onUrgentResultResponse (boolean agree)
void	onHoldStateChanged (boolean hold)
void	onCallTypeChanged (@CallType int callType)
void	onMessageReceived (String content, String contentType, @MessageType int messageType, String fromUserId)
void	onSignRequest (String fromUserId, String extraInfo)
void	onOnewayVideoChanged (boolean turnOn)
void	onDeliveryAbort (boolean isShutDown, String deliveryUserId, String reason)
void	onCallForwarding ()
void	onNotifyMessageReceived (JRTCNotifyMessage notifyMessage, String fromUserId)

详细描述

访客相关事件回调

成员函数说明

onCallForwarding()

void onCallForwarding

(

)

座席通话转接回调

通话中座席调用 transferCall 接口将通话转接到某个座席或转接到某个业务组后，访客会收到此回调，然后访客需等待新的座席接听该通话。
该过程中，访客通话状态不变，新的座席接听通话后，访客可通过 onMemberJoin 回调得知。

onCallPropertyChanged()

void onCallPropertyChanged

(

PropChangeParam

propChangeParam

)

通话属性改变回调

注解

重点关注屏幕共享，即当screenShare 属性为 true 时，去处理屏幕共享相关事件。
可根据 shareRenderId 和 shareUserId 属性进行屏幕共享画面的渲染和停止渲染。

参数

propChangeParam

通话改变的属性

onCallQueueCount() [1/2]

void onCallQueueCount	(	int	count,
		int	time
	)

当前排队人数上报回调

在呼叫发起尚未接通的时间段每5秒上报一次，通话接通后将停止上报。

参数

count	当前排队人数，不包含已经分配座席但是未接听的访客成员
time	预计等待时长，单位秒

弃用:

该回调接口即将废弃，请使用 onCallQueueCount 替换

onCallQueueCount() [2/2]

void onCallQueueCount	(	int	count,
		int	time,
		boolean	agentRinging
	)

当前排队人数上报回调

在呼叫发起尚未接通的时间段每5秒上报一次，通话接通后将停止上报。

参数

count	当前排队人数，不包含已经分配座席但是未接听的访客成员
time	预计等待时长，单位秒
agentRinging	座席是否振铃

onCallStateChanged()

void onCallStateChanged	(	@GuestCallStateChangeType int	type,
		@CallIncomingType int	incomingType,
		JRTCInviter	inviter,
		@CallTermReason int	reason
	)

通话状态改变回调

参数

type	访客通话状态改变类型，即以下情况会收到此回调： GUEST_CHANGE_TYPE_CALLING 访客呼叫成功 GUEST_CHANGE_TYPE_WAITING 访客呼叫成功后等待座席接听 GUEST_CHANGE_TYPE_INCOMING 作为第三方访客收到通话邀请 GUEST_CHANGE_TYPE_TALKING 通话接通（第三方访客）或被接通（主访客） GUEST_CHANGE_TYPE_TERMED 通话挂断或被挂断
incomingType	来电类型，当 type == GUEST_CHANGE_TYPE_INCOMING 时有效
inviter	邀请成员对象，当 type == GUEST_CHANGE_TYPE_INCOMING 时有效
reason	挂断原因，只在 type 为 GUEST_CHANGE_TYPE_TERMED 时需要关注，详见 JRTCGuest.CallTermReason

onCallTypeChanged()

void onCallTypeChanged

(

@CallType int

callType

)

音视频通话切换回调

通话中的访客和座席可分别调用 turnCallType 和 turnCallType 方法切换音视频通话模式，通话中所有成员都会收到此回调。

参数

callType

通话模式 CALL_TYPE_AUDIO 语音通话模式 CALL_TYPE_VIDEO 视频通话模式

onDeliveryAbort()

void onDeliveryAbort	(	boolean	isShutDown,
		String	deliveryUserId,
		String	reason
	)

录制异常回调

远程录制异常退出时会上报此回调。

参数

isShutDown	录制异常时服务器是否自动结束通话 true: 自动结束通话 false: 不自动结束通话
deliveryUserId	录制异常的用户ID
reason	录制异常的原因

onGetAllGroups()

void onGetAllGroups	(	boolean	result,
		List< JRTCCallCenterGroupItem >	groups
	)

获取业务号列表结果回调

访客调用 queryAllGroups 接口获取业务号列表，会收到此回调。

参数

groups	座席业务实体对象列表，获取失败时为 null
result	获取结果，true 表示获取成功，false 表示获取失败

onHoldStateChanged()

void onHoldStateChanged

(

boolean

hold

)

收到通话保持或取回的回调

通话中座席可调用 setHoldState 接口保持通话或取回通话，通话中所有成员都会收到此回调。

参数

hold	true 表示通话被保持，false 表示通话取回

onMemberJoin()

void onMemberJoin

(

JRTCRoomParticipant

participant

)

通话中有新成员加入回调

当第三方成员加入时，已在通话中的所有成员会收到此回调，而新加入的成员不会收到此回调。

参数

participant

新加入的成员对象

onMemberLeave()

void onMemberLeave

(

JRTCRoomParticipant

participant

)

通话中有成员离开回调

通话中有成员离开通话时，剩余的成员会收到此回调，而离开的成员不会收到此回调。

参数

participant

离开的成员对象

onMemberUpdate()

void onMemberUpdate	(	JRTCRoomParticipant	participant,
		ChangeParam	changeParam
	)

通话中成员属性更新回调

常用的有 音量值、音频上传状态、视频上传状态等。
例如当通话中有成员关闭视频传输，通话中所有成员都会收到此回调。

参数

participant	属性更新的成员对象
changeParam	更新的属性对象

onMessageReceived()

void onMessageReceived	(	String	content,
		String	contentType,
		@MessageType int	messageType,
		String	fromUserId
	)

收到消息回调

通话中的访客和座席可分别调用 JRTCGuest#sendMessage(String, String, String) sendMessage} 和 JRTCAgent#sendMessage(String, String, String) sendMessage} 接口给通话中的指定成员或全体成员发送文本消息，接收消息的成员会收到此回调，由此获取消息具体信息。

参数

content	消息内容
contentType	消息内容类型
messageType	消息归属类型 JRTCCallCenter#TYPE_1TO1 : 一对一消息 JRTCCallCenter#TYPE_GROUP : 群发消息(发送给通话中所有成员)
fromUserId	发送方的用户ID

onNotifyMessageReceived()

void onNotifyMessageReceived	(	JRTCNotifyMessage	notifyMessage,
		String	fromUserId
	)

收到事件通知消息回调

通话中的访客和座席可分别调用 sendNotifyMessage 和 sendNotifyMessage 接口给通话中的指定成员或全体成员发送通知消息，接收消息的成员会收到此回调，由此获取消息具体信息。

参数

notifyMessage	事件通知实体类
fromUserId	发送方的用户ID

onOnewayVideoChanged()

void onOnewayVideoChanged

(

boolean

turnOn

)

收到单向视频状态变化回调

通话中座席调用 requestOnewayVideo 请求单向视频，所有成员都会收到此回调。
收到此回调后，应用需要自行实现单向视频功能，例如用图片遮挡该座席画面，SDK不会对画面进行单向处理。

参数

turnOn

是否单向视频

onSignRequest()

void onSignRequest	(	String	fromUserId,
		String	extraInfo
	)

收到签名请求回调

通话中座席调用 requestSign 接口给访客发送签名请求，访客会收到此回调。

参数

fromUserId	发起签名请求的座席用户ID
extraInfo	随路额外消息

onUrgentResultResponse()

void onUrgentResultResponse

(

boolean

agree

)

座席处理加急的结果回调

访客调用 requestUrgent 接口请求加急后，座席可调用 responseUrgent 接口同意或拒绝加急请求，然后访客会收到此回调获得加急请求应答结果。

参数

agree

加急是否通过，true 表示座席同意了访客的加急请求，false 表示不同意