Interface IPolyCallListener

com.poly.polyos.call

Interface IPolyCallListener

---

public interface IPolyCallListener

Listener that gets callbacks from PolyOS regarding Call (Experimental API)

Method Summary

Modifier and Type	Method and Description
boolean	canHoldCall(CallSession callSession)
	Callback to ask the app whether it can hold the given call
void	endCall(CallSession callSession)
	Callback to ask the app to end the given CallSession
void	holdCall(CallSession callSession)
	Callback to ask the app to hold the given CallSession
void	onRequestDenied(Call call)
	Callback informing the app that the request for new call made using IPoly CallService.requestNewCall(Call) has been denied
void	onRequestGranted(Call call, CallSession callSession)
	Callback informing the app that the request for a new call made using IPoly CallService.requestNewCall(Call) has been granted
void	resumeCall(CallSession callSession)
	Callback to ask the app to resume a call that is currently on hold
boolean	startMeeting(Meeting meeting)
	Callback to ask the app to start the given Meeting

Method Detail

onRequestGranted

void onRequestGranted(Call call,
                      CallSession callSession)

Callback informing the app that the request for a new call made using IPolyCallService.requestNewCall(Call) has been granted.

The app can now start opening the audio/video resources and initiate the actual call.

The CallSession is now assumed to be in the Call.CallState.ACTIVE state.

From the Call.CallState.ACTIVE state, an App can:

• End the Call and notify PolyOS using CallSession.notifyCallEnded()
• Hold the Call and notify PolyOS using CallSession.notifyCallOnHold(), which would move the CallSession state to Call.CallState.HOLD. The app must release all the audio/video resource opened for this CallSession.

From the Call.CallState.HOLD state, an App can:

• End the Call and notify PolyOS using CallSession.notifyCallEnded()
• Request PolyOS for permission to Resume using CallSession.requestCallResume()

Parameters:
call - The Call that was requested
callSession - The CallSession granted for this call.

onRequestDenied

void onRequestDenied(Call call)
Callback informing the app that the request for new call made using IPolyCallService.requestNewCall(Call) has been denied.
App should not open any video/audio resource.

Parameters:
call - The call that was denied.

endCall

void endCall(CallSession callSession)
Callback to ask the app to end the given CallSession.
All the audio/video resources opened for the CallSession must be released.

Parameters:
callSession - The call session to end

canHoldCall

boolean canHoldCall(CallSession callSession)
Callback to ask the app whether it can hold the given call

Parameters:
callSession - The call session to be put on hold

holdCall

void holdCall(CallSession callSession)
Callback to ask the app to hold the given CallSession.
This is usually called as a result of user action based on another call.
All the audio/video resources opened for the CallSession must be released.

Parameters:
callSession - The call session to be put on hold

resumeCall

void resumeCall(CallSession callSession)
Callback to ask the app to resume a call that is currently on hold.

Parameters:
callSession - The session to resume.

startMeeting

boolean startMeeting(Meeting meeting)
Callback to ask the app to start the Meeting

Parameters:
meeting - The meeting to start

Returns:
Returns true if the app can start the meeting