Changes between Version 2 and Version 3 of SIP_Redirection

Timestamp:

Jan 22, 2008 10:48:42 AM (16 years ago)

Author:

bennylp

Comment:

--

SIP_Redirection

@@ -40 +40 @@
 The parameters of the function are as follows:
 
- * ''call_id'': the call ID of an outgoing call which status is not disconnected yet.
- * ''target'': target URI.
- * ''tgt_code'': operation to be applied to the target:
+ ''call_id''::
+    The call ID of an outgoing call which status is not disconnected yet.
+ ''target'':: 
+    Target URI.
+ ''tgt_code''::
+    Operation to be applied to the target:
      - value 100-199: the target will be added, but it will not be called until it's code is set to 2xx.
      - value 200-299: the target will be added and called as soon as possible.
      - value 300-699: the target will be removed from the list, if it's present.
- * ''referer'': Optionally specify the URI of the referer, that is the URI of the original target which returned redirection response containing this target. This referer URI is used to calculate the priority of this new target. If referer is not used, the target priority will be calculated from the qvalue parameter instead.
- * ''qvalue'': Priority value, from 0 to 1. Target with lower priority number will be called first. If application specify zero, then this target will be selected first for the next call, and if 1, this target will be called last.
- * ''msg_data'': Optional list of headers etc to be added to outgoing call to this target.
+ ''referer'':: 
+    Optionally specify the URI of the referer, that is the URI of the original target which returned redirection response containing this target. This referer URI is used to calculate the priority of this new target. If referer is not used, the target priority will be calculated from the qvalue parameter instead.
+ 'qvalue''::
+    Priority value, from 0 to 1. Target with lower priority number will be called first. If application specify zero, then this target will be selected first for the next call, and if 1, this target will be called last.
+ ''msg_data'':: 
+    Optional list of headers etc to be added to outgoing call to this target.
 
 
-Please see the function documentation for details.
+Fore more information, please see the function documentation for details.
+
+=== Redirection ===
 
 For call redirection, there is new callback in {{{pjsua_callback}}} to notify application about redirection response from callee:
@@ -64 +72 @@
 For SIP redirection, application would have to implement {{{on_call_redirected()}}} callback above, and call {{{pjsua_call_manage_target()}}} for each target that it wants the call to follow.
 
-For configuring alternate target to outgoing call without waiting for 3xx response, application can simply add the target with {{{pjsua_call_manage_target()}}} immediately after making the call
+=== Configuring Alternate Targets ===
+
+For configuring alternate target to outgoing call without waiting for 3xx response, application can simply add the target with {{{pjsua_call_manage_target()}}} at any time before the call is disconnected (the best time would be immediately after making the call, if the alternate target has been known beforehand).
+