Changes between Initial Version and Version 1 of Py_PJSUA

Timestamp:

Jul 15, 2008 9:05:44 AM (16 years ago)

Author:

bennylp

Comment:

--

Py_PJSUA

@@ +1 @@
+
+ '''Note:''' ::
+   '''This Python module has been deprecated. Please use the [wiki:Python_SIP_Tutorial newer tutorial] instead'''
+
+= Getting Started =
+
+The Python language binding for PJSUA-API is available in PJSIP release 0.5.10 or later.
+
+
+== What is it? ==
+
+'''[/repos/browser/pjproject/trunk/pjsip-apps/src/py_pjsua py_pjsua]''' is a Python module implemented in C language to provide '''[http://www.pjsip.org/pjsip/docs/html/group__PJSUA__LIB.htm PJSUA-API]''' for [http://www.python.org Python] applications. Using '''[/repos/browser/pjproject/trunk/pjsip-apps/src/py_pjsua py_pjsua]''' enables Python application to exploit the features of PJSIP, for example:
+ * multiple SIP accounts
+ * SIP for presence (SIMPLE) and instant messaging
+ * multiple/unlimited calls
+ * call hold and transfer (attended or unattended)
+ * DTMF support
+ * conferencing with multiple/unlimited sources
+ * wideband and ultra-wideband audio support
+ * WAV files playback, playlist, and recording
+ * adaptive jitter buffer, silence detection, packet lost concealment, etc.
+ * tone generation
+ * multiple sound devices (planned)
+ * ICE support (planned)
+ * and so on.
+
+== Status ==
+
+The '''py_pjsua''' module has just been released on 0.5.10 version and therefore it's expected to contain few bugs, so it's still in alpha/beta stage.
+
+Also since the Python abstraction is created manually (rather than using automated Python abstraction generation tools), it is expected that there will be time lag between introduction of new API in PJSUA-API (the C API) and the implementation in the Python module.
+
+
+== Building py_pjsua Module ==
+
+Using Microsoft Visual Studio projects:
+ * Open '''pjsip-apps.dsw''' from {{{pjsip-apps\build}}} directory.
+ * Select '''py_pjsua''' project.
+ * Build the project
+ * The Python module will be placed in {{{pjsip-apps\lib}}} directory.
+
+Using Python build script:
+ * Go to {{{pjsip-apps/src/py_pjsua}}} directory.
+ * Run '''{{{'python ./setup.py build'}}}'''
+ * The Python module will be placed in {{{build}}} directory inside current directory.
+ * Alternatively run '''{{{'python ./setup.py install'}}}''' to install the '''py_pjsua''' module to Python's site_packages directory.
+
+
+= Developing Python SIP Application =
+
+== Introduction ==
+
+The Python API is pretty much the same like PJSUA-API - each Python function corresponds to one function in PJSUA-API, therefore one can use [http://www.pjsip.org/pjsip/docs/html/group__PJSUA__LIB.htm PJSUA-API Documentation] or [wiki:PJSIP_Tutorial PJSUA Tutorial] to learn about the Python API.
+
+To highlight the similarities between PJSUA-API and the py_pjsua API, below are some sample names:
+
+{{{
+         PJSUA-API:                       py_pjsua API:
+
+  #include <pjsua-lib/pjsua.h>  ==>   import py_pjsua
+
+  pjsua_create()                ==>   py_pjsua.create()
+  pjsua_init()                  ==>   py_pjsua.init()
+  
+  pjsua_call_make_call()        ==>   py_pjsua.call_make_call()
+}}}
+
+
+
+
+== Sample Application ==
+
+Please see [/repos/browser/pjproject/trunk/pjsip-apps/src/py_pjsua/pjsua_app.py pjsua_app.py] for a sample/simple Python application.
+
+
+== Documentation ==
+
+The documentation for the Python module is integrated with '''[http://www.pjsip.org/pjsip/docs/html/group__PJSUA__LIB.htm PJSUA-API Documentation]'''. Please follow the step by step on how to use the API there, as well as specific instructions to use each PJSUA feature.
+