authorware7.0脚本教程连载-- Speech Xtra

来源：作者：出处：巧巧读书 2006-10-13 进入讨论组

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的内容开始播放语音。该函数将中断当前正在播放的语音。