Changes between Version 2 and Version 3 of SIP_Redirection


Ignore:
Timestamp:
Jan 22, 2008 10:48:42 AM (11 years ago)
Author:
bennylp
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • SIP_Redirection

    v2 v3  
    4040The parameters of the function are as follows: 
    4141 
    42  * ''call_id'': the call ID of an outgoing call which status is not disconnected yet. 
    43  * ''target'': target URI. 
    44  * ''tgt_code'': operation to be applied to the target: 
     42 ''call_id'':: 
     43    The call ID of an outgoing call which status is not disconnected yet. 
     44 ''target''::  
     45    Target URI. 
     46 ''tgt_code'':: 
     47    Operation to be applied to the target: 
    4548     - value 100-199: the target will be added, but it will not be called until it's code is set to 2xx. 
    4649     - value 200-299: the target will be added and called as soon as possible. 
    4750     - value 300-699: the target will be removed from the list, if it's present. 
    48  * ''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. 
    49  * ''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. 
    50  * ''msg_data'': Optional list of headers etc to be added to outgoing call to this target. 
     51 ''referer''::  
     52    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. 
     53 'qvalue'':: 
     54    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. 
     55 ''msg_data''::  
     56    Optional list of headers etc to be added to outgoing call to this target. 
    5157 
    5258 
    53 Please see the function documentation for details. 
     59Fore more information, please see the function documentation for details. 
     60 
     61=== Redirection === 
    5462 
    5563For call redirection, there is new callback in {{{pjsua_callback}}} to notify application about redirection response from callee: 
     
    6472For 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. 
    6573 
    66 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 
     74=== Configuring Alternate Targets === 
     75 
     76For 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). 
     77