Changes between Version 3 and Version 4 of Python_SIP/Accounts

Timestamp:

Jul 23, 2008 12:38:09 AM (16 years ago)

Author:

bennylp

Comment:

--

Python_SIP/Accounts

@@ -145 +145 @@
 
 
+=== Installing Your Callback to Account Object ===
+
+Once you've created the custom callback class, you can install the callback by specifying your callback instance when creating the account, like the previous examples. Here they are again:
+
+ {{{
+#!python
+    my_cb = MyAccountCallback()
+    acc = lib.create_account_for_transport(udp, cb=my_cb)
+ }}}
+
+or
+
+ {{{
+#!python
+    acc_cfg = pjsua.AccountConfig("pjsip.org", "someuser", "secretpass")
+    my_cb = MyAccountCallback()
+    acc = lib.create_account(acc_cfg, cb=my_cb)
+ }}}
+
+''(Note: we omit error handling for brevity)''
+
+That is the preferred way to install the callback, i.e. to specify the callback instance when creating the account. However, if for some reason you cannot do this, you may install the callback later using Account's [[http://www.pjsip.org/python/pjsua.htm#Account-set_callback set_callback()] method. You SHOULD, however, protect the code fragment with library lock to avoid loosing events. A sample code to do this:
+
+ {{{
+#!python
+    # Create account without callback. Protect the fragment with the
+    # library lock below.
+    lck = lib.auto_lock()
+    acc_cfg = pjsua.AccountConfig("pjsip.org", "someuser", "secretpass")
+    acc = lib.create_account(acc_cfg)
+
+    # Do something else
+    ...
+
+    # Create and install the callback
+    my_cb = MyAccountCallback()
+    acc.set_callback(my_cb)
+
+    # Release library lock
+    del lck
+ }}}
+
+Without the library lock like above, it is possible that some events may be delivered to the account while the callback has not been installed yet, thus we're loosing the events. The lock will prevent that from happening (in this case), '''however''', please bear in mind that while you're holding the library lock, the worker thread can't run, so incoming SIP messages will be queued in socket buffer. So please use the library lock wisely.
+
+
 [[TracNav(Python_SIP/TOC)]]