com.digium.respokesdk

Class RespokeClient

java.lang.Object

com.digium.respokesdk.RespokeClient

All Implemented Interfaces:

RespokeSignalingChannel.Listener

public class RespokeClient
extends java.lang.Object
implements RespokeSignalingChannel.Listener

This is a top-level interface to the API. It handles authenticating the app to the API server, receiving server-side app-specific information, keeping track of connection status and presence, accepting callbacks and listeners, and interacting with information the library keeps track of, like groups and endpoints. The client also keeps track of default settings for calls and direct connections as well as automatically reconnecting to the service when network activity is lost.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	RespokeClient.ConnectCompletionListener A listener interface to receive a notification that the connect action has failed
static interface	RespokeClient.JoinGroupCompletionListener A listener interface to receive a notification that the task to join the groups has completed
static interface	RespokeClient.Listener A delegate protocol to notify the receiver of events occurring with the client
static interface	RespokeClient.ResolvePresenceListener A listener interface to ask the receiver to resolve a list of presence values for an endpoint

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	baseURL
static java.lang.String	PROPERTY_LAST_VALID_PUSH_TOKEN
static java.lang.String	PROPERTY_LAST_VALID_PUSH_TOKEN_ID

Constructor Summary

Constructors

Constructor and Description
RespokeClient()

Method Summary

Methods

Modifier and Type	Method and Description
void	callCreated(RespokeCall call) Receive a notification from the signaling channel that a call has been created
void	callTerminated(RespokeCall call) Receive a notification from the signaling channel that a call has terminated
RespokeCall	callWithID(java.lang.String sessionID) Find a call with the specified session ID
void	connect(java.lang.String tokenID, java.lang.Object initialPresence, android.content.Context context, RespokeClient.ConnectCompletionListener completionListener)
void	connect(java.lang.String endpointID, java.lang.String appID, boolean shouldReconnect, java.lang.Object initialPresence, android.content.Context context, RespokeClient.ConnectCompletionListener completionListener)
void	directConnectionAvailable(RespokeDirectConnection directConnection, RespokeEndpoint endpoint) This event is fired when the logged-in endpoint is receiving a request to open a direct connection to another endpoint.
void	disconnect()
RespokeConnection	getConnection(java.lang.String connectionID, java.lang.String endpointID, boolean skipCreate)
RespokeEndpoint	getEndpoint(java.lang.String endpointIDToFind, boolean skipCreate)
java.lang.String	getEndpointID()
RespokeGroup	getGroup(java.lang.String groupIDToFind)
java.lang.Object	getPresence()
RespokeClient.ResolvePresenceListener	getResolvePresenceListener()
boolean	isConnected()
void	joinGroups(java.util.ArrayList<java.lang.String> groupIDList, RespokeClient.JoinGroupCompletionListener completionListener)
void	onConnect(RespokeSignalingChannel sender, java.lang.String endpointID, java.lang.String connectionID) Receive a notification from the signaling channel that it has connected to the cloud infrastructure
void	onDisconnect(RespokeSignalingChannel sender) Receive a notification from the signaling channel that it has disconnected to the cloud infrastructure
void	onError(java.lang.String errorMessage, RespokeSignalingChannel sender) Receive a notification from the signaling channel that an error has occurred
void	onGroupMessage(java.lang.String message, java.lang.String groupID, java.lang.String endpointID, RespokeSignalingChannel sender, java.util.Date timestamp) Receive a notification that a group message was received
void	onIncomingCall(org.json.JSONObject sdp, java.lang.String sessionID, java.lang.String connectionID, java.lang.String endpointID, java.util.Date timestamp, RespokeSignalingChannel sender) Receive a notification from the signaling channel that a remote endpoint is attempting to start a call
void	onIncomingDirectConnection(org.json.JSONObject sdp, java.lang.String sessionID, java.lang.String connectionID, java.lang.String endpointID, java.util.Date timestamp, RespokeSignalingChannel sender) Receive a notification from the signaling channel that a remote endpoint is attempting to start a direct connection
void	onJoinGroup(java.lang.String groupID, java.lang.String endpointID, java.lang.String connectionID, RespokeSignalingChannel sender) Receive a notification from the signaling channel that an endpoint has joined this group.
void	onLeaveGroup(java.lang.String groupID, java.lang.String endpointID, java.lang.String connectionID, RespokeSignalingChannel sender) Receive a notification from the signaling channel that an endpoint has left this group.
void	onMessage(java.lang.String message, java.util.Date timestamp, java.lang.String endpointID, RespokeSignalingChannel sender) Receive a notification from the signaling channel that a message has been sent to this group
void	onPresence(java.lang.Object presence, java.lang.String connectionID, java.lang.String endpointID, RespokeSignalingChannel sender) Receive a notification that a presence change message was received
void	registerPushServicesWithToken(java.lang.String token)
void	setListener(RespokeClient.Listener listener)
void	setPresence(java.lang.Object newPresence, Respoke.TaskCompletionListener completionListener)
void	setResolvePresenceListener(RespokeClient.ResolvePresenceListener listener)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PROPERTY_LAST_VALID_PUSH_TOKEN

public static final java.lang.String PROPERTY_LAST_VALID_PUSH_TOKEN

See Also:

Constant Field Values

PROPERTY_LAST_VALID_PUSH_TOKEN_ID

public static final java.lang.String PROPERTY_LAST_VALID_PUSH_TOKEN_ID

See Also:

Constant Field Values

baseURL

public java.lang.String baseURL

Constructor Detail

RespokeClient

public RespokeClient()

Method Detail

setListener

public void setListener(RespokeClient.Listener listener)

setResolvePresenceListener

public void setResolvePresenceListener(RespokeClient.ResolvePresenceListener listener)

getResolvePresenceListener

public RespokeClient.ResolvePresenceListener getResolvePresenceListener()

connect

public void connect(java.lang.String endpointID,
           java.lang.String appID,
           boolean shouldReconnect,
           java.lang.Object initialPresence,
           android.content.Context context,
           RespokeClient.ConnectCompletionListener completionListener)

connect

public void connect(java.lang.String tokenID,
           java.lang.Object initialPresence,
           android.content.Context context,
           RespokeClient.ConnectCompletionListener completionListener)

disconnect

public void disconnect()

isConnected

public boolean isConnected()

joinGroups

public void joinGroups(java.util.ArrayList<java.lang.String> groupIDList,
              RespokeClient.JoinGroupCompletionListener completionListener)

getConnection

public RespokeConnection getConnection(java.lang.String connectionID,
                              java.lang.String endpointID,
                              boolean skipCreate)

getEndpoint

public RespokeEndpoint getEndpoint(java.lang.String endpointIDToFind,
                          boolean skipCreate)

getGroup

public RespokeGroup getGroup(java.lang.String groupIDToFind)

getEndpointID

public java.lang.String getEndpointID()

setPresence

public void setPresence(java.lang.Object newPresence,
               Respoke.TaskCompletionListener completionListener)

getPresence

public java.lang.Object getPresence()

onConnect

public void onConnect(RespokeSignalingChannel sender,
             java.lang.String endpointID,
             java.lang.String connectionID)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that it has connected to the cloud infrastructure

Specified by:

onConnect in interface RespokeSignalingChannel.Listener

Parameters:

sender - The signaling channel that triggered the event

endpointID - The endpointID for this connection, as reported by the server

onDisconnect

public void onDisconnect(RespokeSignalingChannel sender)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that it has disconnected to the cloud infrastructure

Specified by:

onDisconnect in interface RespokeSignalingChannel.Listener

Parameters:

sender - The signaling channel that triggered the event

onIncomingCall

public void onIncomingCall(org.json.JSONObject sdp,
                  java.lang.String sessionID,
                  java.lang.String connectionID,
                  java.lang.String endpointID,
                  java.util.Date timestamp,
                  RespokeSignalingChannel sender)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that a remote endpoint is attempting to start a call

Specified by:

onIncomingCall in interface RespokeSignalingChannel.Listener

Parameters:

sdp - The SDP data for the call

sessionID - The session ID of the call

connectionID - The connectionID that is calling

endpointID - The endpointID that is calling

timestamp - The timestamp when the call was initiated

sender - The signaling channel that triggered the event

onIncomingDirectConnection

public void onIncomingDirectConnection(org.json.JSONObject sdp,
                              java.lang.String sessionID,
                              java.lang.String connectionID,
                              java.lang.String endpointID,
                              java.util.Date timestamp,
                              RespokeSignalingChannel sender)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that a remote endpoint is attempting to start a direct connection

Specified by:

onIncomingDirectConnection in interface RespokeSignalingChannel.Listener

Parameters:

sdp - The SDP data for the directConnection

sessionID - The session ID of the directConnection

connectionID - The connectionID that is calling

endpointID - The endpointID that is calling

timestamp - The timestamp when the call was initiated

sender - The signaling channel that triggered the event

onError

public void onError(java.lang.String errorMessage,
           RespokeSignalingChannel sender)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that an error has occurred

Specified by:

onError in interface RespokeSignalingChannel.Listener

Parameters:

errorMessage - Error message

sender - The signaling channel that triggered the event

onJoinGroup

public void onJoinGroup(java.lang.String groupID,
               java.lang.String endpointID,
               java.lang.String connectionID,
               RespokeSignalingChannel sender)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that an endpoint has joined this group.

Specified by:

onJoinGroup in interface RespokeSignalingChannel.Listener

Parameters:

groupID - The ID of the group triggering the join message

endpointID - The ID of the endpoint that to which the connection belongs

connectionID - The ID of the connection that has joined the group

sender - The signaling channel that triggered the event

onLeaveGroup

public void onLeaveGroup(java.lang.String groupID,
                java.lang.String endpointID,
                java.lang.String connectionID,
                RespokeSignalingChannel sender)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that an endpoint has left this group.

Specified by:

onLeaveGroup in interface RespokeSignalingChannel.Listener

Parameters:

groupID - The ID of the group triggering the leave message

endpointID - The ID of the endpoint that to which the connection belongs

connectionID - The ID of the connection that has left the group

sender - The signaling channel that triggered the event

onMessage

public void onMessage(java.lang.String message,
             java.util.Date timestamp,
             java.lang.String endpointID,
             RespokeSignalingChannel sender)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that a message has been sent to this group

Specified by:

onMessage in interface RespokeSignalingChannel.Listener

Parameters:

message - The body of the message

timestamp - The timestamp of the message

endpointID - The ID of the endpoint sending the message

sender - The signaling channel that triggered the event

onGroupMessage

public void onGroupMessage(java.lang.String message,
                  java.lang.String groupID,
                  java.lang.String endpointID,
                  RespokeSignalingChannel sender,
                  java.util.Date timestamp)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification that a group message was received

Specified by:

onGroupMessage in interface RespokeSignalingChannel.Listener

Parameters:

message - The body of the message

groupID - The ID of the group to which the message was sent

endpointID - The ID of the endpoint that sent the message

sender - The signaling channel that triggered the event

timestamp - The time at which the message was sent

onPresence

public void onPresence(java.lang.Object presence,
              java.lang.String connectionID,
              java.lang.String endpointID,
              RespokeSignalingChannel sender)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification that a presence change message was received

Specified by:

onPresence in interface RespokeSignalingChannel.Listener

Parameters:

presence - The new presence value

connectionID - The connection ID whose presence changed

endpointID - The endpoint ID to which the connection belongs

sender - The signaling channel that triggered the event

callCreated

public void callCreated(RespokeCall call)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that a call has been created

Specified by:

callCreated in interface RespokeSignalingChannel.Listener

Parameters:

call - The RespokeCall instance that was created

callTerminated

public void callTerminated(RespokeCall call)

Description copied from interface: RespokeSignalingChannel.Listener

Receive a notification from the signaling channel that a call has terminated

Specified by:

callTerminated in interface RespokeSignalingChannel.Listener

Parameters:

call - The RespokeCall instance that was terminated

callWithID

public RespokeCall callWithID(java.lang.String sessionID)

Description copied from interface: RespokeSignalingChannel.Listener

Find a call with the specified session ID

Specified by:

callWithID in interface RespokeSignalingChannel.Listener

Parameters:

sessionID - SessionID to find

Returns:

The RespokeCall instance with that sessionID. If not found, will return nil.

directConnectionAvailable

public void directConnectionAvailable(RespokeDirectConnection directConnection,
                             RespokeEndpoint endpoint)

Description copied from interface: RespokeSignalingChannel.Listener

This event is fired when the logged-in endpoint is receiving a request to open a direct connection to another endpoint. If the user wishes to allow the direct connection, calling 'accept' on the direct connection will allow the connection to be set up.

Specified by:

directConnectionAvailable in interface RespokeSignalingChannel.Listener

Parameters:

directConnection - The direct connection object

endpoint - The remote endpoint

registerPushServicesWithToken

public void registerPushServicesWithToken(java.lang.String token)