Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 1 | /* $Id$ */ |
| 2 | /* |
Benny Prijono | a771a51 | 2007-02-19 01:13:53 +0000 | [diff] [blame] | 3 | * Copyright (C) 2003-2007 Benny Prijono <benny@prijono.org> |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 4 | * |
| 5 | * This program is free software; you can redistribute it and/or modify |
| 6 | * it under the terms of the GNU General Public License as published by |
| 7 | * the Free Software Foundation; either version 2 of the License, or |
| 8 | * (at your option) any later version. |
| 9 | * |
| 10 | * This program is distributed in the hope that it will be useful, |
| 11 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 12 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 13 | * GNU General Public License for more details. |
| 14 | * |
| 15 | * You should have received a copy of the GNU General Public License |
| 16 | * along with this program; if not, write to the Free Software |
| 17 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 18 | */ |
| 19 | #ifndef __PJSUA_INTERNAL_H__ |
| 20 | #define __PJSUA_INTERNAL_H__ |
| 21 | |
| 22 | /** |
| 23 | * This is the private header used by pjsua library implementation. |
| 24 | * Applications should not include this file. |
| 25 | */ |
| 26 | |
| 27 | PJ_BEGIN_DECL |
| 28 | |
| 29 | /** |
| 30 | * Structure to be attached to invite dialog. |
| 31 | * Given a dialog "dlg", application can retrieve this structure |
| 32 | * by accessing dlg->mod_data[pjsua.mod.id]. |
| 33 | */ |
| 34 | typedef struct pjsua_call |
| 35 | { |
| 36 | unsigned index; /**< Index in pjsua array. */ |
| 37 | pjsip_inv_session *inv; /**< The invite session. */ |
| 38 | void *user_data; /**< User/application data. */ |
| 39 | pjsip_status_code last_code; /**< Last status code seen. */ |
| 40 | pj_str_t last_text; /**< Last status text seen. */ |
| 41 | pj_time_val start_time;/**< First INVITE sent/received. */ |
| 42 | pj_time_val res_time; /**< First response sent/received. */ |
| 43 | pj_time_val conn_time; /**< Connected/confirmed time. */ |
| 44 | pj_time_val dis_time; /**< Disconnect time. */ |
| 45 | pjsua_acc_id acc_id; /**< Account index being used. */ |
| 46 | pjsua_call_media_status media_st;/**< Media state. */ |
| 47 | pjmedia_dir media_dir; /**< Media direction. */ |
| 48 | pjmedia_session *session; /**< The media session. */ |
| 49 | int conf_slot; /**< Slot # in conference bridge. */ |
| 50 | pjsip_evsub *xfer_sub; /**< Xfer server subscription, if this |
| 51 | call was triggered by xfer. */ |
| 52 | pjmedia_sock_info skinfo; /**< Preallocated media sockets. */ |
| 53 | pjmedia_transport *med_tp; /**< Media transport. */ |
| 54 | pj_timer_entry refresh_tm;/**< Timer to send re-INVITE. */ |
| 55 | pj_timer_entry hangup_tm; /**< Timer to hangup call. */ |
| 56 | |
| 57 | char last_text_buf_[128]; /**< Buffer for last_text. */ |
| 58 | |
| 59 | } pjsua_call; |
| 60 | |
| 61 | |
| 62 | /** |
| 63 | * Server presence subscription list head. |
| 64 | */ |
| 65 | typedef struct pjsua_srv_pres |
| 66 | { |
| 67 | PJ_DECL_LIST_MEMBER(struct pjsua_srv_pres); |
| 68 | pjsip_evsub *sub; |
| 69 | char *remote; |
| 70 | } pjsua_srv_pres; |
| 71 | |
| 72 | |
| 73 | /** |
| 74 | * Account |
| 75 | */ |
| 76 | typedef struct pjsua_acc |
| 77 | { |
| 78 | pjsua_acc_config cfg; /**< Account configuration. */ |
| 79 | pj_bool_t valid; /**< Is this account valid? */ |
| 80 | |
| 81 | int index; /**< Index in accounts array. */ |
Benny Prijono | c570f2d | 2006-07-18 00:33:02 +0000 | [diff] [blame] | 82 | pj_str_t display; /**< Display name, if any. */ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 83 | pj_str_t user_part; /**< User part of local URI. */ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 84 | |
Benny Prijono | b4a17c9 | 2006-07-10 14:40:21 +0000 | [diff] [blame] | 85 | pj_str_t srv_domain; /**< Host part of reg server. */ |
| 86 | int srv_port; /**< Port number of reg server. */ |
| 87 | |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 88 | pjsip_regc *regc; /**< Client registration session. */ |
| 89 | pj_timer_entry reg_timer; /**< Registration timer. */ |
| 90 | pj_status_t reg_last_err; /**< Last registration error. */ |
| 91 | int reg_last_code; /**< Last status last register. */ |
| 92 | |
| 93 | pjsip_route_hdr route_set; /**< Complete route set inc. outbnd.*/ |
| 94 | |
| 95 | unsigned cred_cnt; /**< Number of credentials. */ |
| 96 | pjsip_cred_info cred[PJSUA_ACC_MAX_PROXIES]; /**< Complete creds. */ |
| 97 | |
| 98 | pj_bool_t online_status; /**< Our online status. */ |
| 99 | pjsua_srv_pres pres_srv_list; /**< Server subscription list. */ |
Benny Prijono | 3a5e1ab | 2006-08-15 20:26:34 +0000 | [diff] [blame] | 100 | pjsip_publishc *publish_sess; /**< Client publication session. */ |
| 101 | pj_bool_t publish_state; /**< Last published online status */ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 102 | |
| 103 | } pjsua_acc; |
| 104 | |
| 105 | |
| 106 | /** |
| 107 | *Transport. |
| 108 | */ |
Benny Prijono | 62c5c5b | 2007-01-13 23:22:40 +0000 | [diff] [blame] | 109 | typedef struct pjsua_transport_data |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 110 | { |
Benny Prijono | e93e287 | 2006-06-28 16:46:49 +0000 | [diff] [blame] | 111 | int index; |
| 112 | pjsip_transport_type_e type; |
| 113 | pjsip_host_port local_name; |
| 114 | |
| 115 | union { |
| 116 | pjsip_transport *tp; |
| 117 | pjsip_tpfactory *factory; |
| 118 | void *ptr; |
| 119 | } data; |
| 120 | |
Benny Prijono | 62c5c5b | 2007-01-13 23:22:40 +0000 | [diff] [blame] | 121 | } pjsua_transport_data; |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 122 | |
| 123 | |
| 124 | /** |
| 125 | * Buddy data. |
| 126 | */ |
| 127 | typedef struct pjsua_buddy |
| 128 | { |
| 129 | unsigned index; /**< Buddy index. */ |
| 130 | pj_str_t uri; /**< Buddy URI. */ |
| 131 | pj_str_t contact; /**< Contact learned from subscrp. */ |
| 132 | pj_str_t name; /**< Buddy name. */ |
| 133 | pj_str_t display; /**< Buddy display name. */ |
| 134 | pj_str_t host; /**< Buddy host. */ |
| 135 | unsigned port; /**< Buddy port. */ |
| 136 | pj_bool_t monitor; /**< Should we monitor? */ |
| 137 | pjsip_evsub *sub; /**< Buddy presence subscription */ |
| 138 | pjsip_pres_status status; /**< Buddy presence status. */ |
| 139 | |
| 140 | } pjsua_buddy; |
| 141 | |
| 142 | |
| 143 | /** |
| 144 | * File player/recorder data. |
| 145 | */ |
| 146 | typedef struct pjsua_file_data |
| 147 | { |
Benny Prijono | a66c331 | 2007-01-21 23:12:40 +0000 | [diff] [blame] | 148 | pj_bool_t type; /* 0=player, 1=playlist */ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 149 | pjmedia_port *port; |
| 150 | unsigned slot; |
| 151 | } pjsua_file_data; |
| 152 | |
| 153 | |
| 154 | /** |
| 155 | * Additional parameters for conference bridge. |
| 156 | */ |
| 157 | typedef struct pjsua_conf_setting |
| 158 | { |
| 159 | unsigned channel_count; |
| 160 | unsigned samples_per_frame; |
| 161 | unsigned bits_per_sample; |
| 162 | } pjsua_conf_setting; |
| 163 | |
| 164 | |
| 165 | /** |
| 166 | * Global pjsua application data. |
| 167 | */ |
| 168 | struct pjsua_data |
| 169 | { |
| 170 | |
| 171 | /* Control: */ |
| 172 | pj_caching_pool cp; /**< Global pool factory. */ |
| 173 | pj_pool_t *pool; /**< pjsua's private pool. */ |
| 174 | pj_mutex_t *mutex; /**< Mutex protection for this data */ |
| 175 | |
| 176 | /* Logging: */ |
| 177 | pjsua_logging_config log_cfg; /**< Current logging config. */ |
| 178 | pj_oshandle_t log_file; /**<Output log file handle */ |
| 179 | |
| 180 | /* SIP: */ |
| 181 | pjsip_endpoint *endpt; /**< Global endpoint. */ |
| 182 | pjsip_module mod; /**< pjsua's PJSIP module. */ |
Benny Prijono | 62c5c5b | 2007-01-13 23:22:40 +0000 | [diff] [blame] | 183 | pjsua_transport_data tpdata[8]; /**< Array of transports. */ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 184 | |
| 185 | /* Threading: */ |
| 186 | pj_bool_t thread_quit_flag; /**< Thread quit flag. */ |
| 187 | pj_thread_t *thread[4]; /**< Array of threads. */ |
| 188 | |
Benny Prijono | c97608e | 2007-03-23 16:34:20 +0000 | [diff] [blame] | 189 | /* STUN and resolver */ |
| 190 | pj_stun_config stun_cfg; /**< Global STUN settings. */ |
| 191 | pj_sockaddr stun_srv; /**< Resolved STUN server address */ |
| 192 | pj_status_t stun_status; /**< STUN server status. */ |
| 193 | pj_dns_resolver *resolver; /**< DNS resolver. */ |
| 194 | |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 195 | /* Account: */ |
| 196 | unsigned acc_cnt; /**< Number of accounts. */ |
| 197 | pjsua_acc_id default_acc; /**< Default account ID */ |
| 198 | pjsua_acc acc[PJSUA_MAX_ACC]; /**< Account array. */ |
Benny Prijono | 093d302 | 2006-09-24 00:07:11 +0000 | [diff] [blame] | 199 | pjsua_acc_id acc_ids[PJSUA_MAX_ACC]; /**< Acc sorted by prio*/ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 200 | |
| 201 | /* Calls: */ |
| 202 | pjsua_config ua_cfg; /**< UA config. */ |
| 203 | unsigned call_cnt; /**< Call counter. */ |
| 204 | pjsua_call calls[PJSUA_MAX_CALLS];/**< Calls array. */ |
| 205 | |
| 206 | /* Buddy; */ |
| 207 | unsigned buddy_cnt; /**< Buddy count. */ |
| 208 | pjsua_buddy buddy[PJSUA_MAX_BUDDIES]; /**< Buddy array. */ |
| 209 | |
| 210 | /* Media: */ |
| 211 | pjsua_media_config media_cfg; /**< Media config. */ |
| 212 | pjmedia_endpt *med_endpt; /**< Media endpoint. */ |
| 213 | pjsua_conf_setting mconf_cfg; /**< Additionan conf. bridge. param */ |
| 214 | pjmedia_conf *mconf; /**< Conference bridge. */ |
| 215 | int cap_dev; /**< Capture device ID. */ |
| 216 | int play_dev; /**< Playback device ID. */ |
Benny Prijono | e909eac | 2006-07-27 22:04:56 +0000 | [diff] [blame] | 217 | pj_bool_t no_snd; /**< No sound (app will manage it) */ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 218 | pjmedia_snd_port *snd_port; /**< Sound port. */ |
| 219 | pjmedia_master_port *null_snd; /**< Master port for null sound. */ |
| 220 | pjmedia_port *null_port; /**< Null port. */ |
| 221 | |
| 222 | |
| 223 | /* File players: */ |
| 224 | unsigned player_cnt;/**< Number of file players. */ |
Benny Prijono | cba59d9 | 2007-02-16 09:22:56 +0000 | [diff] [blame] | 225 | pjsua_file_data player[PJSUA_MAX_PLAYERS];/**< Array of players.*/ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 226 | |
| 227 | /* File recorders: */ |
| 228 | unsigned rec_cnt; /**< Number of file recorders. */ |
Benny Prijono | cba59d9 | 2007-02-16 09:22:56 +0000 | [diff] [blame] | 229 | pjsua_file_data recorder[PJSUA_MAX_RECORDERS];/**< Array of recs.*/ |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 230 | }; |
| 231 | |
| 232 | |
| 233 | extern struct pjsua_data pjsua_var; |
| 234 | |
| 235 | |
| 236 | /** |
| 237 | * IM callback data. |
| 238 | */ |
| 239 | typedef struct pjsua_im_data |
| 240 | { |
| 241 | pjsua_acc_id acc_id; |
| 242 | pjsua_call_id call_id; |
| 243 | pj_str_t to; |
| 244 | pj_str_t body; |
| 245 | void *user_data; |
| 246 | } pjsua_im_data; |
| 247 | |
| 248 | |
| 249 | /** |
| 250 | * Duplicate IM data. |
| 251 | */ |
| 252 | PJ_INLINE(pjsua_im_data*) pjsua_im_data_dup(pj_pool_t *pool, |
| 253 | const pjsua_im_data *src) |
| 254 | { |
| 255 | pjsua_im_data *dst; |
| 256 | |
Benny Prijono | 07113c9 | 2006-11-21 08:38:00 +0000 | [diff] [blame] | 257 | dst = (pjsua_im_data*) pj_pool_alloc(pool, sizeof(*dst)); |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 258 | dst->acc_id = src->acc_id; |
| 259 | dst->call_id = src->call_id; |
| 260 | pj_strdup_with_null(pool, &dst->to, &src->to); |
| 261 | dst->user_data = src->user_data; |
| 262 | pj_strdup_with_null(pool, &dst->body, &src->body); |
| 263 | |
| 264 | return dst; |
| 265 | } |
| 266 | |
| 267 | |
Benny Prijono | 148c9dd | 2006-09-19 13:37:53 +0000 | [diff] [blame] | 268 | #if 1 |
| 269 | #define PJSUA_LOCK() pj_mutex_lock(pjsua_var.mutex) |
| 270 | #define PJSUA_TRY_LOCK() pj_mutex_trylock(pjsua_var.mutex) |
| 271 | #define PJSUA_UNLOCK() pj_mutex_unlock(pjsua_var.mutex) |
Benny Prijono | 3a5e1ab | 2006-08-15 20:26:34 +0000 | [diff] [blame] | 272 | #else |
| 273 | #define PJSUA_LOCK() |
Benny Prijono | 148c9dd | 2006-09-19 13:37:53 +0000 | [diff] [blame] | 274 | #define PJSUA_TRY_LOCK() PJ_SUCCESS |
Benny Prijono | 3a5e1ab | 2006-08-15 20:26:34 +0000 | [diff] [blame] | 275 | #define PJSUA_UNLOCK() |
| 276 | #endif |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 277 | |
| 278 | |
Benny Prijono | c97608e | 2007-03-23 16:34:20 +0000 | [diff] [blame] | 279 | /** |
| 280 | * Resolve STUN server. |
| 281 | */ |
| 282 | pj_status_t pjsua_resolve_stun_server(pj_bool_t wait); |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 283 | |
| 284 | /** |
| 285 | * Handle incoming invite request. |
| 286 | */ |
| 287 | pj_bool_t pjsua_call_on_incoming(pjsip_rx_data *rdata); |
| 288 | |
Benny Prijono | c97608e | 2007-03-23 16:34:20 +0000 | [diff] [blame] | 289 | /* |
| 290 | * Media channel. |
| 291 | */ |
| 292 | pj_status_t pjsua_media_channel_init(pjsua_call_id call_id, |
| 293 | pjsip_role_e role); |
| 294 | pj_status_t pjsua_media_channel_create_sdp(pjsua_call_id call_id, |
| 295 | pj_pool_t *pool, |
| 296 | pjmedia_sdp_session **p_sdp); |
| 297 | pj_status_t pjsua_media_channel_update(pjsua_call_id call_id, |
| 298 | pjmedia_sdp_session *local_sdp, |
| 299 | pjmedia_sdp_session *remote_sdp); |
| 300 | pj_status_t pjsua_media_channel_deinit(pjsua_call_id call_id); |
| 301 | |
| 302 | |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 303 | /** |
| 304 | * Init presence. |
| 305 | */ |
| 306 | pj_status_t pjsua_pres_init(); |
| 307 | |
| 308 | /* |
| 309 | * Start presence subsystem. |
| 310 | */ |
| 311 | pj_status_t pjsua_pres_start(void); |
| 312 | |
| 313 | /** |
| 314 | * Refresh presence subscriptions |
| 315 | */ |
| 316 | void pjsua_pres_refresh(void); |
| 317 | |
| 318 | /* |
| 319 | * Shutdown presence. |
| 320 | */ |
| 321 | void pjsua_pres_shutdown(void); |
| 322 | |
| 323 | /** |
Benny Prijono | 3a5e1ab | 2006-08-15 20:26:34 +0000 | [diff] [blame] | 324 | * Init presence for aoocunt. |
| 325 | */ |
| 326 | pj_status_t pjsua_pres_init_acc(int acc_id); |
| 327 | |
| 328 | /** |
Benny Prijono | 8b6834f | 2007-02-24 13:29:22 +0000 | [diff] [blame] | 329 | * Send PUBLISH |
| 330 | */ |
| 331 | pj_status_t pjsua_pres_init_publish_acc(int acc_id); |
| 332 | |
| 333 | /** |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 334 | * Terminate server subscription for the account |
| 335 | */ |
| 336 | void pjsua_pres_delete_acc(int acc_id); |
| 337 | |
| 338 | /** |
| 339 | * Init IM module handler to handle incoming MESSAGE outside dialog. |
| 340 | */ |
| 341 | pj_status_t pjsua_im_init(void); |
| 342 | |
| 343 | /** |
| 344 | * Init call subsystem. |
| 345 | */ |
| 346 | pj_status_t pjsua_call_subsys_init(const pjsua_config *cfg); |
| 347 | |
| 348 | /** |
| 349 | * Start call subsystem. |
| 350 | */ |
| 351 | pj_status_t pjsua_call_subsys_start(void); |
| 352 | |
| 353 | /** |
| 354 | * Init media subsystems. |
| 355 | */ |
| 356 | pj_status_t pjsua_media_subsys_init(const pjsua_media_config *cfg); |
| 357 | |
| 358 | /** |
| 359 | * Start pjsua media subsystem. |
| 360 | */ |
| 361 | pj_status_t pjsua_media_subsys_start(void); |
| 362 | |
| 363 | /** |
| 364 | * Destroy pjsua media subsystem. |
| 365 | */ |
| 366 | pj_status_t pjsua_media_subsys_destroy(void); |
| 367 | |
| 368 | /** |
| 369 | * Private: check if we can accept the message. |
| 370 | * If not, then p_accept header will be filled with a valid |
| 371 | * Accept header. |
| 372 | */ |
| 373 | pj_bool_t pjsua_im_accept_pager(pjsip_rx_data *rdata, |
| 374 | pjsip_accept_hdr **p_accept_hdr); |
| 375 | |
| 376 | /** |
| 377 | * Private: process pager message. |
| 378 | * This may trigger pjsua_ui_on_pager() or pjsua_ui_on_typing(). |
| 379 | */ |
| 380 | void pjsua_im_process_pager(int call_id, const pj_str_t *from, |
| 381 | const pj_str_t *to, pjsip_rx_data *rdata); |
| 382 | |
| 383 | |
| 384 | /** |
| 385 | * Create Accept header for MESSAGE. |
| 386 | */ |
| 387 | pjsip_accept_hdr* pjsua_im_create_accept(pj_pool_t *pool); |
| 388 | |
| 389 | /* |
| 390 | * Add additional headers etc in msg_data specified by application |
| 391 | * when sending requests. |
| 392 | */ |
| 393 | void pjsua_process_msg_data(pjsip_tx_data *tdata, |
| 394 | const pjsua_msg_data *msg_data); |
| 395 | |
| 396 | |
| 397 | /* |
| 398 | * Add route_set to outgoing requests |
| 399 | */ |
| 400 | void pjsua_set_msg_route_set( pjsip_tx_data *tdata, |
| 401 | const pjsip_route_hdr *route_set ); |
| 402 | |
| 403 | |
| 404 | /* |
| 405 | * Simple version of MIME type parsing (it doesn't support parameters) |
| 406 | */ |
| 407 | void pjsua_parse_media_type( pj_pool_t *pool, |
| 408 | const pj_str_t *mime, |
| 409 | pjsip_media_type *media_type); |
| 410 | |
| 411 | |
Benny Prijono | 62c5c5b | 2007-01-13 23:22:40 +0000 | [diff] [blame] | 412 | /* |
| 413 | * Internal function to init transport selector from transport id. |
| 414 | */ |
| 415 | void pjsua_init_tpselector(pjsua_transport_id tp_id, |
| 416 | pjsip_tpselector *sel); |
| 417 | |
| 418 | |
| 419 | |
Benny Prijono | eebe9af | 2006-06-13 22:57:13 +0000 | [diff] [blame] | 420 | PJ_END_DECL |
| 421 | |
| 422 | #endif /* __PJSUA_INTERNAL_H__ */ |
| 423 | |