扩展的放音收号标签

扩展的放音收号标签


增强放音和收号标签，能够指定对系统的呼叫的某一方进行放音收号，也可以播放视频收号或视频叠加文字收号，会议除外。
放音将文件名设置为音频文件的后缀，如.wav。
播放视频将文件名设置为视频文件的后缀如.mov和.3gp
视频叠加文字需要使用<videooverlay>标签。

属性


属性名			说明
name 			对象名称
classid			method://ngcc/Call/ExCollectDigit(D)
			method://cm-ngcc/call/excollectdigit(ca)


参数			说明
CallID			系统中呼叫的一方。（IN）
			32位整数，该值为进行该操作呼叫的一方，既可以是被叫，也可以是主叫。
MaxDigit		最大收号位数。（IN）（OP）
			1字节整数。缺省时为<property name="maxdigit"/>属性值，默认该值为1.
InterTime		收号间隙事件。(IN)(OP)
			1字节整数，缺省时为<property name="interdigittimeout"/>属性值，系统默认该值为5秒
EndDigit		收号结束键。（IN）（OP）
			枚举字符。系统默认为（*）星号键。（ZXVXI不支持）
MinDigit		最少收号位数。（IN）（OP）
			1字节整数。系统默认为1位
CancelDigit		收号取消键。（IN）（OP）
			枚举字符。系统默认为（*）星号键。（ZXVXI不支持）
StartDigit		收号开始键。（IN）（OP）
			枚举字符。系统默认为任意键。（ZXVXI不支持）
FirstTime		收号首位超时。（IN）（OP）
			1字节整数。缺省为<property name="timeout"/>的属性值，默认为5秒
PlayTimes		放音次数（IN）（OP）
			1字节整数。可以取以下值：0为无限循环，1.2.3等为放1、2、3次，默认为1.（注意在宽带下不支持此参数）
PlayType		放音类型（IN）（OP）
			1字节整数。可以取以下值：0：放提示音；1.放指定文件，包括ipfile音和可变音。
			2、放临时文件（暂不支持）3.放合成音（暂不支持）4.放质检文件（暂不支持）
			5、tts音。默认为1.
PlayPara		放音参数。（IN）（OP）
			字符串，最大为150个字节，一般为播放的文件名称。
pattern		        收号规则。XMS使用一个标准的正则表达式，表示合法的字符集；MS100直接列举（IN）
			例如[0-7|*]{1,2}#:用户可输入的1到2位字符，字符由数字0-7或*组成，#则是结束键；
			XMS的默认值为[0-9|*]#:表示字符集为0-9、*和#。正则表达式长度不能超过30字节。
			MS100只需要写为01234567*#。只支持宽带下XMS和MS100，不支持CMS.
ignorebargeinkey	需要忽略的打断键。XMS多个键中间用|分开，MS100不需要用|分开。（IN）
			只支持宽带下XMS和MS100，不支持CMS。

返回值
通过name属性来接受返回值
SUCCESS 收号成功
FAILUER 收号失败


注意
1.此标签为异步标签
2.收号结果在waitEvent标签中得到
3.若没有指定EndDigit，结束符默认为‘#’，若制订了EndDigit，但赋值为空值，则结束符默认为0xFF。
4.本标签可以在播放视频收号时，添加使用<videooverlay>实现视频叠加文字。
实例
该示例中收号限制为1-2位，收号首位超时为4，间隙收号3秒超时，收号范围为0-7、*,结束符为#，收号忽略1和2

<?xml version=“1.0” encoding=“gb2312”?>
<vxml version=“2.0”>
	<var name=“ssp” expr=“123456”/>
	<form>
		<object name=“callsetup” classid=“method://ngcc/Call/Callout”>
			<param name=“CLD” expr=“‘99990007’”/>
			<param name=“CallID” expr=“ssp”/>
		<filled >
			<if cond=“callsetup==‘HOOK_OFF’”>
				<log>result:<value expr=“callsetup”/></log>
				<goto next=“#play”/>
			<else/>
				<log>result:<vaue expr=“callsetup”/></log>
				<goto next=“#waitForm”/>
			</if>
		</filled>
		</object>
	</form>
	<fotm id=“play”>
		<!—放音—>
		<var name=“CurrentCallID” expr=“ssp”/>
		<object name=“collectdigit” classid=“method://ngcc/Call/ExCollectDigit”>
			<param name=“CallID” expr=“CurrentCallID”/>
			<param name=“MinDigit” expr=“1”/>
			<param name=“MaxDigit” expr=“2”/>
			<param name=“PlayPara” expr=“ipfile://wait.wav”/>
			<param name=“PlayType” expr=“1”/>
			<param name=“FirstTime” expr=“4”/>
			<param name=“InterTime” expr=“3”/>
			<param name=“pattern” expr=“[0-7|*]{1,2}#”/>
			<param name=“ignorebargeinkey” expr=“1|2”/>
		<filled>
			<log>result:<value expr=“collectdigit”/></log>
			<goto next=“#waitForm”/>
		</filled>
		</object>
	</form>
	<form id=“waitForm”>
		<!—等待用户挂机—>
		<var name=“outputinfo”/>
		<object name=“asynTrans” classid=“method://function/waitEvent”>
			<param name=“OutputInfo” expr=“outputinfo”/>
		<filled>
			<log> pc:<value expr=“outputinfo”/></log>
		</filled>
		</object>
	</form>
</vxml>