Interface IPolyCallService

com.poly.polyos.call

Interface IPolyCallService

---

public interface IPolyCallService

Manages calls made in PolyOS. Experimental API

Apps that wish to make a call use this service to requestNewCall(Call). Based on the current state of the system (such as any existing call), PolyOS will interact with user/other apps to decide whether to grant (IPolyCallListener.onRequestGranted(Call, CallSession)) or deny (IPolyCallListener.onRequestDenied(Call)) the request.

An app should wait for CallSession obtained from the callback IPolyCallListener.onRequestGranted(Call, CallSession) before opening the audio/video resource. PolyOS may deny those resources by apps that do not have the granted CallSession.

See Also:
IPolyCallListener, CallSession

Method Summary

Modifier and Type	Method and Description
AudioRoute[]	getAvailableAudioRoutes()
	Returns the available AudioRoute
void	registerCallListener (IPolyCallListener callListener)
	Registers a IPolyCallListener for handling the callbacks from PolyOS
void	requestNewCall(Call call)
	Request for a new Call
void	setMeetings(Meeting[] meetings)
	Notifies PolyOS about an upcoming Meeting of this app
void	unRegisterCallListener (IPolyCallListener callListener)
	Unregisters a listener

Method Detail

getAvailableAudioRoutes

AudioRoute[] getAvailableAudioRoutes()
Returns the available AudioRoute

requestNewCall

void requestNewCall(Call call)
Request for a new Call.
This is the starting point where apps request to start a call.
App should not come to the foreground or show any Call UI until the response to this request is received.
The response for this request will be delivered to the listener registered using registerCallListener(IPolyCallListener).

setMeetings

void setMeetings(Meeting[] meetings)
Notify PolyOS about an upcoming Meeting of this app.
PolyOS may decide to present these upcming meetings from different apps to the user.
Based on the user action, PolyOS will notify the app to start a meeting using the callback IPolyCallListener.startMeeting(Meeting).

Parameters:
meetings - The upcoming meetings. This will replace any previously set meetings.

registerCallListener

void registerCallListener(IPolyCallListener callListener)
Registers a IPolyCallListener for handling the call backs from PolyOS

unRegisterCallListener

void unRegisterCallListener(IPolyCallListener callListener)
Unregisters a listener