nuanceSpeechRecognizer

startTransaction startSpeech

概述

Nuance简介
Nuance公司（Nuance Communications, Inc. (NASDAQ: NUAN)) 是最大的专门从事语音识别软件、图像处理软件及输入法软件研发、销售的公司。目前世界上最先进的电脑语音识别软件Naturally Speaking就出自于Nuance公司。用户对着麦克风说话，屏幕上就会显示出说话的内容。

nuanceSpeechRecognizer模块概述
本模块nuanceSpeechRecognizer 封装了Nuance的SDK，集成了语音识别和文字转语音输出功能；支持全世界大部分的语言识别；使用之前须从Nuance官网申请账号并创建应用（https://developer.nuance.com/public/index.php/），获取 appkey 、appid、host和port。

现提供一个测试账户地址:,复制xml到配置文件key.xml即可使用，此xml只作为测试使用，需要正式请到官网进行注册。

使用此模块之前需配置key.xml文件，配置完毕，需要放在 widget/res 文件目录下，需通过云端编译生效（编译时会自动加密key.xml文件，保证安全性），配置方法如下：

• 参数：nuance_appkey、nuance_appid、nuance_host、nuance_port

• 配置示例:

• 字段描述:

  nuance_appkey：（必须配置）用于验证账户app的应用key

  nuance_appid：（必须配置）从nuance平台获取的 appid。

  nuance_host：（必须配置）识别请求地址。

  nuance_port：（必须配置）识别请求端口。

createNuance

初始化模块nuance

createNuance(callback(ret, err))

ret：

• 类型：JSON对象

• 内部字段：

    {
        status: true      //布尔型；true||false
    }

err：

• 类型：JSON对象

•   {
        code: *     //数字类型；
    }

示例代码

        var nuance = api.require('nuanceSpeechRecognizer');
        nuance.createNuance(function(ret, err){
        if(ret.status){
            alert("初始化成功");
        }else{
            alert(JSON.stringify(err));
        }
    });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

startTransaction

开始语音识别，更多语言请查询（ASR）：https://developer.nuance.com/public/index.php?task=supportedLanguages/

startTransaction({params}, callback(ret, err))

params

language：

• 类型：字符串
• 描述：（可选项）识别语言
• 默认值：eng-USA

callback(ret, err)

ret：

• 类型：JSON对象

• 内部字段：

err：

• 类型：JSON对象

• 内部字段：

    {
        code: *     //数字类型；
        message: ** //错误描述
  

```js
var nuance = api.require('nuanceSpeechRecognizer');
nuance.createNuance();
nuance.startTransaction({"language":"cmn-CHN"}, 
    function(ret,err) {
        alert( JSON.stringify( ret ));
        });
```

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

stopRecording

停止识别，把录音上传到服务器进行验证，验证成功后返回识别文字

stopRecording({}, callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON对象

• 内部字段：

    {
        text: '识别结果'      //字符串;返回识别结果
    }

err：

• 类型：JSON对象

示例代码

var nuance;
function start(){
    nuance = api.require('nuanceSpeechRecognizer');
    nuance.createNuance();
    nuance.startTransaction({"language":"cmn-CHN"}, 
        function(ret,err) {
            });
}
//说完后
function stop(){
    nuance.stopRecording({}, function(ret) {
        if( ret ){
            alert( JSON.stringify( ret ) );
        }
});
}
```

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

startSpeech

根据文字转出为语音进行播放,更多语言请查询（TTS）：

startSpeech({param}, callback(ret, err))

language：

• 类型：字符串
• 描述：识别语言
• 默认值：eng-USA

text：

• 类型：字符串
• 描述：所需要播放的文字

callback(ret, err)

ret：

• 类型：JSON对象

• 内部字段：

    {
        status: true      //布尔型；true||false
    }

err：

• 类型：JSON对象

• 内部字段：

    {
        code: *     //数字类型；
        message: ** //错误描述
    }

示例代码

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

destroyNuance

销毁模块nuance

destroyNuance()

示例代码

iOS系统，Android系统

可提供的1.0.0及更高版本