Changes between Version 1 and Version 2 of PJSUA_Initialization

Timestamp:

Jul 12, 2013 4:51:52 AM (11 years ago)

Author:

ming

Comment:

--

PJSUA_Initialization

@@ -7 +7 @@
 = PJSUA initialization and shutdown =
 
-As described in the [http://www.pjsip.org/docs/latest/pjsip/docs/html/group__PJSUA__LIB__BASE.htm#details PJSUA-API Basic API documentation], application needs to call {{{pjsua_create()}}}, {{{pjsua_pool_create()}}}, {{{pjsua_init()}}} to perform the initialization. Then app must call {{{pjsua_start()}}} to start PJSUA and finally after everything is done, call {{{pjsua_destroy()}}} to shut it down.
+To use PJSIP, it is recommended to call {{{pj_init()}}} and {{{pj_shutdown()}}} from the main thread. After {{{pj_init()}}} is completed, application can continue with the initialization or create a secondary/worker thread and register the thread by calling {{{pj_thread_register()}}}. As described in [http://www.pjsip.org/docs/latest/pjsip/docs/html/group__PJSUA__LIB__BASE.htm#details PJSUA-API Basic API documentation], app needs to call {{{pjsua_create()}}}, {{{pjsua_pool_create()}}}, {{{pjsua_init()}}} to perform the initialization. Then app must call {{{pjsua_start()}}} to start PJSUA and finally after everything is done, call {{{pjsua_destroy()}}} to shut it down. Sample code:
 
-It is not necessary to call these functions from the main thread, i.e. application can perform the initialization and shutdown from a secondary/worker thread. However, it is recommended to call {{{pj_init()}}} and {{{pj_shutdown()}}} from the main thread.
+ {{{
+ int main()
+ {
+     pj_init();
+     // Continue with PJSUA initialization here or create a secondary thread
+     ....
+     // After pjsua_destroy() is called
+     pj_shutdown();
+ }
+
+ int worker_thread()
+ {
+     // Register the thread, after pj_init() is called
+     pj_thread_register();
+
+     // Create pjsua and pool
+     pjsua_create();
+     pjsua_pool_create();
+
+     // Init pjsua
+     pjsua_init();
+
+     // Start pjsua
+     pjsua_start();
+
+     .........
+
+     // Destroy pjsua
+     pjsua_destroy();
+ }
+ }}}
+
+When restarting the library, after {{{pjsua_destroy()}}} is completed, application needs to call {{{pj_shutdown()}}} and {{{pj_init()}}} in the main thread.
+Application also needs to make sure that the number of calls to {{{pj_shutdown()}}} matches with the calls to {{{pj_init()}}}
 
 {{{