1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
|
/* $Id$ */
/*
* Copyright (C) 2003-2006 Benny Prijono <benny@prijono.org>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#ifndef __PJSUA_H__
#define __PJSUA_H__
/* Include all PJSIP core headers. */
#include <pjsip.h>
/* Include all PJMEDIA headers. */
#include <pjmedia.h>
/* Include all PJSIP-UA headers */
#include <pjsip_ua.h>
/* Include all PJLIB-UTIL headers. */
#include <pjlib-util.h>
/* Include all PJLIB headers. */
#include <pjlib.h>
PJ_BEGIN_DECL
/**
* Structure to be attached to all dialog.
* Given a dialog "dlg", application can retrieve this structure
* by accessing dlg->mod_data[pjsua.mod.id].
*/
struct pjsua_inv_data
{
PJ_DECL_LIST_MEMBER(struct pjsua_inv_data);
pjsip_inv_session *inv;
pjmedia_session *session;
};
/* PJSUA application variables. */
struct pjsua
{
/* Control: */
pj_caching_pool cp; /**< Global pool factory. */
pjsip_endpoint *endpt; /**< Global endpoint. */
pj_pool_t *pool; /**< pjsua's private pool. */
pjsip_module mod; /**< pjsua's PJSIP module. */
/* Media: */
pjmedia_endpt *med_endpt; /**< Media endpoint. */
pj_bool_t null_audio;
pjmedia_sock_info med_skinfo;
/* User info: */
pj_str_t local_uri; /**< Uri in From: header. */
pj_str_t contact_uri; /**< Uri in Contact: header. */
/* Proxy URLs: */
pj_str_t proxy;
pj_str_t outbound_proxy;
pjsip_route_hdr route_set;
/* Registration: */
pj_str_t registrar_uri;
pjsip_regc *regc;
pj_int32_t reg_timeout;
pj_timer_entry regc_timer;
/* Authentication credentials: */
int cred_count;
pjsip_cred_info cred_info[4];
/* Threading: */
int thread_cnt; /**< Thread count. */
pj_thread_t *threads[8]; /**< Thread instances. */
pj_bool_t quit_flag; /**< To signal thread to quit. */
/* Transport (UDP): */
pj_uint16_t sip_port; /**< SIP signaling port. */
pj_sock_t sip_sock; /**< SIP UDP socket. */
pj_sockaddr_in sip_sock_name; /**< Public/STUN UDP socket addr. */
/* STUN: */
pj_str_t stun_srv1;
int stun_port1;
pj_str_t stun_srv2;
int stun_port2;
/* Misc: */
int log_level; /**< Logging verbosity. */
int app_log_level; /**< stdout log verbosity. */
unsigned log_decor; /**< Log decoration. */
char *log_filename; /**< Log filename. */
/* List of invite sessions: */
struct pjsua_inv_data inv_list;
};
/** PJSUA instance. */
extern struct pjsua pjsua;
/*****************************************************************************
* PJSUA API (defined in pjsua_core.c).
*/
/**
* Initialize pjsua settings with default parameters.
*/
void pjsua_default(void);
/**
* Display error message for the specified error code.
*/
void pjsua_perror(const char *title, pj_status_t status);
/**
* Initialize pjsua application. Application can call this before parsing
* application settings.
*
* This will initialize all libraries, create endpoint instance, and register
* pjsip modules. Transport will NOT be created however.
*
* Application may register module after calling this function.
*/
pj_status_t pjsua_init(void);
/**
* Start pjsua stack. Application calls this after pjsua settings has been
* configured.
*
* This will start the transport, worker threads (if any), and registration
* process, if registration is configured.
*/
pj_status_t pjsua_start(void);
/**
* Destroy pjsua.
*/
pj_status_t pjsua_destroy(void);
/*****************************************************************************
* PJSUA Invite session API (defined in pjsua_inv.c).
*/
/**
* Make outgoing call.
*/
pj_status_t pjsua_invite(const char *cstr_dest_uri,
pjsip_inv_session **p_inv);
/**
* Handle incoming invite request.
*/
pj_bool_t pjsua_inv_on_incoming(pjsip_rx_data *rdata);
/**
* Callback to be called by session when invite session's state has changed.
*/
void pjsua_inv_on_state_changed(pjsip_inv_session *inv, pjsip_event *e);
/**
* Callback to be called by session when outgoing dialog has forked.
* This function will create a forked dialog.
*/
void pjsua_inv_on_new_session(pjsip_inv_session *inv, pjsip_event *e);
/**
* Callback to be called when SDP offer/answer negotiation has just completed
* in the session. This function will start/update media if negotiation
* has succeeded.
*/
void pjsua_inv_on_media_update(pjsip_inv_session *inv, pj_status_t status);
/*****************************************************************************
* PJSUA Client Registration API (defined in pjsua_reg.c).
*/
/**
* Initialize client registration session.
*
* @param app_callback Optional callback
*/
pj_status_t pjsua_regc_init(void);
/**
* Update registration or perform unregistration. If renew argument is zero,
* this will start unregistration process.
*/
void pjsua_regc_update(pj_bool_t renew);
/*****************************************************************************
* User Interface API.
*
* The UI API specifies functions that will be called by pjsua upon
* occurence of various events.
*/
/**
* Notify UI when invite state has changed.
*/
void pjsua_ui_inv_on_state_changed(pjsip_inv_session *inv, pjsip_event *e);
PJ_END_DECL
#endif /* __PJSUA_H__ */
|
