Refer events

Functions
void	com.portsip.OnPortSIPEvent.onReceivedRefer (long sessionId, long referId, String to, String from, String referSipMessage)
void	com.portsip.OnPortSIPEvent.onReferAccepted (long sessionId)
void	com.portsip.OnPortSIPEvent.onReferRejected (long sessionId, String reason, int code)
void	com.portsip.OnPortSIPEvent.onTransferTrying (long sessionId)
void	com.portsip.OnPortSIPEvent.onTransferRinging (long sessionId)
void	com.portsip.OnPortSIPEvent.onACTVTransferSuccess (long sessionId)
void	com.portsip.OnPortSIPEvent.onACTVTransferFailure (long sessionId, String reason, int code)

Detailed Description

Function Documentation

onReceivedRefer()

void com.portsip.OnPortSIPEvent.onReceivedRefer	(	long	sessionId,
		long	referId,
		String	to,
		String	from,
		String	referSipMessage
	)

This event will be triggered once received a REFER message.

Parameters

sessionId	The session ID of the call.
referId	The ID of the REFER message. Pass it to acceptRefer or rejectRefer
to	The refer target.
from	The sender of REFER message.
referSipMessage	The SIP message of "REFER". Pass it to "acceptRefer" function.

onReferAccepted()

void com.portsip.OnPortSIPEvent.onReferAccepted

(

long

sessionId

)

This callback will be triggered once remote side calls "acceptRefer" to accept the REFER

Parameters

sessionId

The session ID of the call.

onReferRejected()

void com.portsip.OnPortSIPEvent.onReferRejected	(	long	sessionId,
		String	reason,
		int	code
	)

This callback will be triggered once remote side calls "rejectRefer" to reject the REFER

Parameters

sessionId	The session ID of the call.
reason	Reject reason.
code	Reject code.

onTransferTrying()

void com.portsip.OnPortSIPEvent.onTransferTrying

(

long

sessionId

)

When the refer call is being processed, this event will be triggered.

Parameters

sessionId

The session ID of the call.

onTransferRinging()

void com.portsip.OnPortSIPEvent.onTransferRinging

(

long

sessionId

)

When the refer call is ringing, this event will be triggered.

Parameters

sessionId

The session ID of the call.

onACTVTransferSuccess()

void com.portsip.OnPortSIPEvent.onACTVTransferSuccess

(

long

sessionId

)

When the refer call succeeds, this event will be triggered. The ACTV means Active. For example, A establishes the call with B, A transfers B to C, C accepts the refer call, and A will receive this event.

Parameters

sessionId

The session ID of the call.

onACTVTransferFailure()

void com.portsip.OnPortSIPEvent.onACTVTransferFailure	(	long	sessionId,
		String	reason,
		int	code
	)

When the refer call fails, this event will be triggered. The ACTV means Active. For example, A establish the call with B, A transfers B to C, C rejects this refer call, and A will receive this event.

Parameters

sessionId	The session ID of the call.
reason	The error reason.
code	The error code.