Changes between Version 11 and Version 12 of Python_SIP_Tutorial

Timestamp:

Jul 22, 2008 7:04:47 PM (16 years ago)

Author:

bennylp

Comment:

--

Python_SIP_Tutorial

@@ -1 +1 @@
 = PJSUA Python Module =
 
+[[TracNav(Python_SIP_TOC)]]
+
 The PJSUA for Python Module is an object oriented Python wrapper/abstraction for [http://www.pjsip.org/pjsip/docs/html/group__PJSUA__LIB.htm PJSUA API]. It provides high level API for constructing SIP multimedia user agent applications. It wraps together the signaling, media, and NAT traversal functionality into an easy to use call control API, account management, buddy list management, presence, instant messaging, along with multimedia features such as local conferencing, file streaming, local playback, and voice recording, and powerful NAT traversal techniques utilizing STUN, TURN, and ICE.
-
-[[TracNav(Python_SIP_TOC)]]
 
 
@@ -47 +47 @@
 == Developing Python SIP Application == #develop
 
-== Introduction ==
-
-The pjsua module only contains few classes so it should be straightforward to use.
-
-== Error Handling ==
-
-By convention, we use exceptions as means to report error. Operations which yields error will raise [http://www.pjsip.org/python/pjsua.htm#Error pjsua.Error] exception.
+=== Concepts === #concepts
+
+==== Asynchronous Operations ====
+
+If you have developed applications with PJSIP you'll know about this already, but this concept probably needs to be explained a little bit here to new PJSIP users.
+
+In PJSIP, all operations that involve sending and receiving SIP messages are asynchronous, meaning that the function that invokes the operation will complete immediately, and you will be given the completion status as callbacks. Take a look for example the {{{make_call()}}} method of the [http://www.pjsip.org/python/pjsua.htm#Account Account] class. This function is used to initiate outgoing call to a destination. When this function returns successfully, it does not mean that the call has been established, but rather that the call has been '''initiated''' successfully. You will be given the report of the call completion (such as ''Ringing'' or ''Connected''/''Confirmed''' events) in the {{{on_state()}}} callback of [http://www.pjsip.org/python/pjsua.htm#CallCallback CallCallback] class.
+
+
+==== Basic Usage Pattern ====
+
+Ah, talking about callbacks.
+
+
+
+==== Error Handling ====
+
+By convention, we use exceptions as means to report error, as this would make the program flows more naturally. Operations which yield error will raise [http://www.pjsip.org/python/pjsua.htm#Error pjsua.Error] exception. Here is a sample:
+
+ {{{
+#!python
+import pjsua
+
+try:
+    call = acc.make_call('sip:buddy@example.org')
+except pjsua.Error, err:
+    print 'Exception has occured:', err
+except:
+    print 'Ouch..'
+ }}}
+
+The sample above will print the full error information to stdout. If you prefer to display the error in more structured manner, the [http://www.pjsip.org/python/pjsua.htm#Error pjsua.Error] class has several members to explain the error, such as the object name that raised the error, the operation name, and the error message itself.
+
+