aardio 文档

com.sapi.voice 库模块帮助文档

com.sapi 成员列表

com.sapi.voice

SAPI语音对象,
SAPI为正常系统自带组件，如果是精简过删除了SAPI组件的系统请自行安装修复该组件

com.sapi.voice()

创建SAPI语音对象

返回对象:comsapivoiceObject

comsapivoiceObject 成员列表

comsapivoiceObject.displayUI(hWndParent,title,typeOfUI,extraData)

显示指定界面

comsapivoiceObject.eachVoices()

for name,lang,gender,age,vendor,description in comsapivoiceObject.eachVoices(){
    /*遍历所有语音库,  
name为名称,lang为语言代码,gender为性别,age为年龄,vendor为厂商,description为详细说明*/
}

comsapivoiceObject.event

回调事件表

返回对象:comsapivoiceeventObject

comsapivoiceObject.getStatus()

返回当前状态

返回对象:comsapivoicestatusObject

comsapivoiceObject.getVoicesEx()

返回数组,数组由所有语音库的属性列表组成
如果在参数中使用一个字符串参数指定要返回的属性,
则返回由所有语音库的对应属性值组成的数组

comsapivoiceObject.isUiSupported(typeOfUI,extraData)

是否支持指定界面

comsapivoiceObject.pause()

暂停朗读

comsapivoiceObject.rate

说话速度，值范围从 -10到10

comsapivoiceObject.resume()

继续朗读

comsapivoiceObject.setVoice()

设置当前语音库

comsapivoiceObject.setVoiceByAttributes(必需属性,可选属性)

使用属性设置语音库
属性使用"Attribute = Value"或者"Attribute != Value" 格式的字符串表示

comsapivoiceObject.setVoiceByIndex()

使用索引设置语音库

comsapivoiceObject.setVoiceByLanguage()

使用语言代码设置语音库
804 表示中文,409表示英文

comsapivoiceObject.setVoiceByName()

使用名称设置语音库

comsapivoiceObject.skip(type,numItems)

跳过指定的文本

comsapivoiceObject.speak(text,flags)

朗读,text参数指定要朗读的字符串
flags为可选参数,可指定如下值：
SVSFDefault = 0
SVSFlagsAsync = 1
SVSFPurgeBeforeSpeak = 2
SVSFIsFilename = 4
SVSFIsXML = 8
SVSFIsNotXML = 16
SVSFPersistXML = 32
SVSFNLPSpeakPunc = 64
SVSFNLPMask = 64
SVSFVoiceMask = 127
SVSFUnusedFlags = -128

comsapivoiceObject.speakAsync(text,flags)

异步非阻塞朗读,text参数指定要朗读的字符串
flags为可选参数,参考speak函数flags参数的说明
此函数与speak用法相同,但flags默认指定了SVSFlagsAsync选项

comsapivoiceObject.speakCompleteEvent()

返回一个用于等待的事件句柄,
可作为 thread.waitOne 的参数使用

comsapivoiceObject.speakStream(stream,flags)

朗读文件流，例如SAPI.SpFileStream

comsapivoiceObject.speakXml(text,flags)

异步非阻塞朗读XML格式文本,text参数指定要朗读的字符串
flags为可选参数,参考speak函数flags参数的说明
此函数与speak用法相同,但flags默认指定了SVSFlagsAsync,SVSFIsXML选项

comsapivoiceObject.status

当前状态

返回对象:comsapivoicestatusObject

comsapivoiceObject.voice

当前语音库

comsapivoiceObject.volume

音量，值范围从 0到100

comsapivoiceObject.waitOne()

异步朗读时,可使用此函数等待朗读结束

comsapivoiceObject.waitUntilDone(_)

等待直到完成,参数指定超时,超时指定为-1表示直到朗读完成

comsapivoiceeventObject 成员列表

comsapivoiceeventObject.AudioLevel

comsapivoiceeventObject.AudioLevel = function(streamNumber,streamPosition,audioLevel){ 
    /*音频变化触发*/  
}

comsapivoiceeventObject.EndStream

comsapivoiceeventObject.EndStream = function(streamNumber ,streamPosition){ 

}

comsapivoiceeventObject.EnginePrivate

comsapivoiceeventObject.EnginePrivate =  function(streamNumber,streamPosition,engineData){

}

comsapivoiceeventObject.Phoneme

comsapivoiceeventObject.Phoneme =  function(streamNumber, streamPosition,Duration,nextPhoneId,Feature,currentPhoneId){
   /*新的音素*/
}

comsapivoiceeventObject.Sentence

comsapivoiceeventObject.Sentence =  function(streamNumber,streamPosition,characterPosition,length){
   /*新的句子*/
}

comsapivoiceeventObject.StartStream

comsapivoiceeventObject.StartStream = function(streamNumber,streamPosition ){ 

}

comsapivoiceeventObject.Viseme

comsapivoiceeventObject.Viseme =  function(streamNumber,streamPosition,duration,nextVisemeId,feature,currentVisemeId){
   /*新的嘴形*/
}

comsapivoiceeventObject.VoiceChange

comsapivoiceeventObject.VoiceChange =  function(streamNumber,streamPosition ,voiceObjectToken ){ 
    var v = voiceObjectToken.GetDescription();
}

comsapivoiceeventObject.Word

comsapivoiceeventObject.Word =  function(streamNumber,streamPosition,characterPosition,length ){ 
   /*一个新单词开始*/
}

comsapivoicestatusObject 成员列表

comsapivoicestatusObject.currentStreamNumber

输入流数目.

comsapivoicestatusObject.inputSentenceLength

当前语句长度

comsapivoicestatusObject.inputSentencePosition

当前语句开始位置

comsapivoicestatusObject.inputWordLength

当前朗读的单词长度

comsapivoicestatusObject.inputWordPosition

当前朗读的单词开始位置

comsapivoicestatusObject.lastBookmark

最后一个书签的字符串值

comsapivoicestatusObject.lastBookmarkId

最后一个书签的ID

comsapivoicestatusObject.lastHResult

最后一次调用speak,speakStream的状态码

comsapivoicestatusObject.lastStreamNumberQueued

朗读的最后一个音频流编号

comsapivoicestatusObject.phonemeId

当前音素ID

comsapivoicestatusObject.runningState

当前朗读状态
SRSEIsSpeaking 值为2 表示正在朗读
SRSEDone 值为1表示朗读已完成

comsapivoicestatusObject.visemeId

当前口形ID

Markdown 格式