eXosip2 event API

Data Structures
struct	eXosip_event
	Structure for event description. More...

Typedefs
typedef enum eXosip_event_type	eXosip_event_type_t

Enumerations
enum	eXosip_event_type {   EXOSIP_REGISTRATION_SUCCESS, EXOSIP_REGISTRATION_FAILURE, EXOSIP_CALL_INVITE, EXOSIP_CALL_REINVITE,   EXOSIP_CALL_NOANSWER, EXOSIP_CALL_PROCEEDING, EXOSIP_CALL_RINGING, EXOSIP_CALL_ANSWERED,   EXOSIP_CALL_REDIRECTED, EXOSIP_CALL_REQUESTFAILURE, EXOSIP_CALL_SERVERFAILURE, EXOSIP_CALL_GLOBALFAILURE,   EXOSIP_CALL_ACK, EXOSIP_CALL_CANCELLED, EXOSIP_CALL_MESSAGE_NEW, EXOSIP_CALL_MESSAGE_PROCEEDING,   EXOSIP_CALL_MESSAGE_ANSWERED, EXOSIP_CALL_MESSAGE_REDIRECTED, EXOSIP_CALL_MESSAGE_REQUESTFAILURE, EXOSIP_CALL_MESSAGE_SERVERFAILURE,   EXOSIP_CALL_MESSAGE_GLOBALFAILURE, EXOSIP_CALL_CLOSED, EXOSIP_CALL_RELEASED, EXOSIP_MESSAGE_NEW,   EXOSIP_MESSAGE_PROCEEDING, EXOSIP_MESSAGE_ANSWERED, EXOSIP_MESSAGE_REDIRECTED, EXOSIP_MESSAGE_REQUESTFAILURE,   EXOSIP_MESSAGE_SERVERFAILURE, EXOSIP_MESSAGE_GLOBALFAILURE, EXOSIP_SUBSCRIPTION_NOANSWER, EXOSIP_SUBSCRIPTION_PROCEEDING,   EXOSIP_SUBSCRIPTION_ANSWERED, EXOSIP_SUBSCRIPTION_REDIRECTED, EXOSIP_SUBSCRIPTION_REQUESTFAILURE, EXOSIP_SUBSCRIPTION_SERVERFAILURE,   EXOSIP_SUBSCRIPTION_GLOBALFAILURE, EXOSIP_SUBSCRIPTION_NOTIFY, EXOSIP_IN_SUBSCRIPTION_NEW, EXOSIP_NOTIFICATION_NOANSWER,   EXOSIP_NOTIFICATION_PROCEEDING, EXOSIP_NOTIFICATION_ANSWERED, EXOSIP_NOTIFICATION_REDIRECTED, EXOSIP_NOTIFICATION_REQUESTFAILURE,   EXOSIP_NOTIFICATION_SERVERFAILURE, EXOSIP_NOTIFICATION_GLOBALFAILURE, EXOSIP_EVENT_COUNT }
	Structure for event type description. More...

Functions
void	eXosip_event_free (eXosip_event_t *je)
	Free ressource in an eXosip event. More...
eXosip_event_t *	eXosip_event_wait (struct eXosip_t *excontext, int tv_s, int tv_ms)
	Wait for an eXosip event. More...
eXosip_event_t *	eXosip_event_get (struct eXosip_t *excontext)
	Wait for next eXosip event. More...
int	eXosip_event_geteventsocket (struct eXosip_t *excontext)
	This socket receive some data yhen an event happens internally. More...

Detailed Description

Typedef Documentation

typedef enum eXosip_event_type eXosip_event_type_t

#include <eXosip.h>

Enumeration Type Documentation

enum eXosip_event_type

#include <eXosip.h>

Structure for event type description.

Enumerator
EXOSIP_REGISTRATION_SUCCESS	user is successfully registred.
EXOSIP_REGISTRATION_FAILURE	user is not registred.
EXOSIP_CALL_INVITE	announce a new call
EXOSIP_CALL_REINVITE	announce a new INVITE within call
EXOSIP_CALL_NOANSWER	announce no answer within the timeout
EXOSIP_CALL_PROCEEDING	announce processing by a remote app
EXOSIP_CALL_RINGING	announce ringback
EXOSIP_CALL_ANSWERED	announce start of call
EXOSIP_CALL_REDIRECTED	announce a redirection
EXOSIP_CALL_REQUESTFAILURE	announce a request failure
EXOSIP_CALL_SERVERFAILURE	announce a server failure
EXOSIP_CALL_GLOBALFAILURE	announce a global failure
EXOSIP_CALL_ACK	ACK received for 200ok to INVITE.
EXOSIP_CALL_CANCELLED	announce that call has been cancelled
EXOSIP_CALL_MESSAGE_NEW	announce new incoming request.
EXOSIP_CALL_MESSAGE_PROCEEDING	announce a 1xx for request.
EXOSIP_CALL_MESSAGE_ANSWERED	announce a 200ok
EXOSIP_CALL_MESSAGE_REDIRECTED	announce a failure.
EXOSIP_CALL_MESSAGE_REQUESTFAILURE	announce a failure.
EXOSIP_CALL_MESSAGE_SERVERFAILURE	announce a failure.
EXOSIP_CALL_MESSAGE_GLOBALFAILURE	announce a failure.
EXOSIP_CALL_CLOSED	a BYE was received for this call
EXOSIP_CALL_RELEASED	call context is cleared.
EXOSIP_MESSAGE_NEW	announce new incoming request.
EXOSIP_MESSAGE_PROCEEDING	announce a 1xx for request.
EXOSIP_MESSAGE_ANSWERED	announce a 200ok
EXOSIP_MESSAGE_REDIRECTED	announce a failure.
EXOSIP_MESSAGE_REQUESTFAILURE	announce a failure.
EXOSIP_MESSAGE_SERVERFAILURE	announce a failure.
EXOSIP_MESSAGE_GLOBALFAILURE	announce a failure.
EXOSIP_SUBSCRIPTION_NOANSWER	announce no answer
EXOSIP_SUBSCRIPTION_PROCEEDING	announce a 1xx
EXOSIP_SUBSCRIPTION_ANSWERED	announce a 200ok
EXOSIP_SUBSCRIPTION_REDIRECTED	announce a redirection
EXOSIP_SUBSCRIPTION_REQUESTFAILURE	announce a request failure
EXOSIP_SUBSCRIPTION_SERVERFAILURE	announce a server failure
EXOSIP_SUBSCRIPTION_GLOBALFAILURE	announce a global failure
EXOSIP_SUBSCRIPTION_NOTIFY	announce new NOTIFY request
EXOSIP_IN_SUBSCRIPTION_NEW	announce new incoming SUBSCRIBE.
EXOSIP_NOTIFICATION_NOANSWER	announce no answer
EXOSIP_NOTIFICATION_PROCEEDING	announce a 1xx
EXOSIP_NOTIFICATION_ANSWERED	announce a 200ok
EXOSIP_NOTIFICATION_REDIRECTED	announce a redirection
EXOSIP_NOTIFICATION_REQUESTFAILURE	announce a request failure
EXOSIP_NOTIFICATION_SERVERFAILURE	announce a server failure
EXOSIP_NOTIFICATION_GLOBALFAILURE	announce a global failure
EXOSIP_EVENT_COUNT	MAX number of events.

Definition at line 288 of file eXosip.h.

Function Documentation

void eXosip_event_free

(

eXosip_event_t *

je

)

#include <eXosip.h>

Free ressource in an eXosip event.

Parameters

je	event to work on.

eXosip_event_t* eXosip_event_get

(

struct eXosip_t *

excontext

)

#include <eXosip.h>

Wait for next eXosip event.

DEPRECATED API This API will block // You should use eXosip_event_wait instead which is more convenient. limitation: This method will not process automatic 200ok retransmission for INVITE transaction.

Parameters

excontext

eXosip_t instance.

int eXosip_event_geteventsocket

(

struct eXosip_t *

excontext

)

#include <eXosip.h>

This socket receive some data yhen an event happens internally.

NOTE: you must call eXosip_event_wait until there is no more events in the fifo.

Parameters

excontext

eXosip_t instance.

eXosip_event_t* eXosip_event_wait	(	struct eXosip_t *	excontext,
		int	tv_s,
		int	tv_ms
	)

#include <eXosip.h>

Wait for an eXosip event.

Parameters

excontext	eXosip_t instance.
tv_s	timeout value (seconds).
tv_ms	timeout value (mseconds).