Authorware类和函数:authorware7.0脚本教学文章连载-- Speech Xtra

newobject

语法：object:=newobject（"speechxtra"）

说明：没有使用。

voicecount

语法：result:=voicecount（ ）

说明：返回系统中安装的语音数量。语音数量也可以从windows控制面板中的语音属性中得到。

voiceget

语法：result:=voiceget（ ）

说明：返回描述系统当前语音的属性列表。列表格式为：[#name:string，#age:string，#gender:string，#index:integer]，其中【name】属性，【age】属性，【gende】属性由系统中安装的语音引擎决定（往往表示人名、年龄和制造商），【index】属性指示当前语音在语音列表中的位置索引。例如：[#name:"microsoft mary"，#age:"adult"，#gender:"female"，#index:1]。当前语音也可以从windows控制面板中的语音属性中得到，但是语音的位置索引值与语音属性中显示的位置不一定相等。

voicegetall

语法：result:=voicegetall（）

说明：返回一个以语音属性列表为元素的线性列表，每个元素描述了系统中安装的一种类型的语音。例如，[[#name:"microsoft mary"，#age:"adult"，#gender:"female"，#index:1]，[#name: "microsoft mike"，#age:"adult"，#gender:"male"，#index:2]，[#name:"microsoft sam"，#age: "adult"，#gender:"male"，#index:3]]，其中每个属性的含义请参阅函数voiceget的说明。系统中安装的所有语音也可以从windows控制面板中的语音属性中得到，但是语音的位置索引值与语音属性中显示的位置不一定相等。

voicegetpitch

语法：result:=voicegetpitch（ ）

说明：返回当前语音的音调。音调范围由各种语音本身决定。

voicegetrate

语法：result:=voicegetrate（ ）

说明：返回当前语音的语速。语速范围由各种语音本身决定。

voicegetvolume

语法：result:=voicegetvolume（ ）

说明：返回当前语音的音量。音量范围由各种语音本身决定。

voiceinitialize

语法：result:=voiceinitialize（ ）

说明：检测当前系统中是否正确地安装了tts引擎，是则返回true，否则返回false。

voicepause

语法：result:=voicepause（ ）

说明：暂停当前正在播放的语音，函数执行成功则返回true，否则返回false。暂停的位置由各种语音本身决定，有的语音会继续播放一段时间，直至缓冲区中的语音数据全部输出为止。

voiceresume

语法：result:=voiceresume（ ）

说明：继续播放当前处于暂停状态的语音，函数执行成功则返回true，否则返回false。

voiceset

语法：result:=voiceset（voiceindex）

说明：选择当前使用的语音，并返回实际被选择的语音索引号。参数voiceindex为语音索引号，最小索引号为1，最大索引号可以通过函数voicecount（ ）获得，如果参数voiceindex超出可用索引号的范围，此函数将自动选择索引号最相近的语音。新的语音将在下一次执行函数voicespeak（ ）时被使用。系统中安装的所有语音也可以从windows控制面板中的语音属性中得到，但是语音的位置索引值与语音属性中显示的位置不一定相等。

voicesetpitch

语法：result:=voicesetpitch（value）

说明：设置当前语音的音调，并返回实际被设置的音调。参数value为音调数值，音调数值的范围由各种语音本身决定。新的音调将在下一次执行函数voicespeak时被使用。

voicesetrate

语法：result:=voicesetrate（rate）

说明：设置当前语音的语速，并返回实际被设置的语速。参数rate为语速数值，语速数值的范围由各种语音本身决定。新的语速将在下一次执行函数voicespeak时被使用。

voicesetvolume

语法：result:=voicesetvolume（volume）

说明：设置当前语音的音量，并返回实际被设置的音量。参数rate为音量数值，音量数值的范围由各种语音本身决定。新的音量将在下一次执行函数voicespeak时被使用。

voicespeak

语法：voicespeak（"stringtospeak"）

说明：根据字符串参数stringtospeak的内容开始播放语音。该函数将中断当前正在播放的语音。

voicestate

语法：result:=voicestate（）

说明：检测当前语音的状态，并返回符号类型的结果：#stopped，#playing或#paused。

voicestop

语法：result:=voicestop（）

说明：停止播放当前语音，函数执行成功则返回true，否则返回false。

voicewordpos

语法：result :=voicewordpos（）

说明：返回当前被播放的单词的序号。例如，当前正在播放字符串“how are you”中的单词are，执行该函数将返回2。