FreeSWITCH小结:关于export的原理介绍及应用
Export原理
普通export用法
在dialplan中经常会用到export,如下所示:
<action application="export" data="myvar=test"/>
上面的xml在执行后,会在本地通道中修改如下:
myvar=test
export_vars=<other_export_vars>,myvar
在本地变量中增加myvar,同时修改export_vars变量,将export指定的变量附加到后面。
这样,在bridge时候,系统会将export_vars指定的变量从a腿导入到b腿上.
带nolocal的export用法
有时候,仅仅需要将变量设置到b腿,而不需要设置到a腿,所以这里就需要参数nolocal.
用法如下:
<action application="export" data="nolocal:myvar=test"/>
上面的命令在执行后,会在本地增加的变量如下:
nolocal:myvar=test
export_vars=<other_export_vars>,nolocal:myvar
也就是说增加的变量名称就是nolocal:myvar, 由于有nolocal前缀,就可以跟本地变量很好的区别开。
同样,在bridge的时候,系统也会将export_vars指定的变量从a腿导出到b腿。
巧妙的是,在导出nolocal:myvar的时候,会自动将nolocal:前缀去掉,从而达到将变量只设置到b腿的目的。
而如果留意就会发现,使用下面的命令还是可以获取到值的:
uuid_getvar <a_leg_uuid> nolocal:myvar
而使用下面的命令是获取不到任何值的:
uuid_getvar <a_leg_uuid> myvar
Export用法
知道了export的原理之后,即使api命令中没有uuid_export,我们也可以模拟出来。
如下:
用法1:只将指定的变量导出到b腿
originate {nolocal:sip_h_X-AutoAccept=true,export_vars='nolocal:sip_h_X-AutoAccept'}user/60400 60401
用法2:只将指定的变量设置到a腿
originate {sip_h_X-AutoAccept=true}user/60400 60401
用法3:同时将变量设置到a腿和b腿
originate {sip_h_X-AutoAccept=true,nolocal:sip_h_X-AutoAccept=true,export_vars='nolocal:sip_h_X-AutoAccept'}user/60400 60401
注意事项
这里所说的设置到b腿,是指bridge之后设置到b腿
Export示例
示例1:在呼叫前,同时设置a腿和b腿的uuid,以便后期跟踪
originate {origination_uuid=xxxxx,nolocal:origination_uuid=yyyyy,export_vars='nolocal:origination_uuid'}user/60401 60402