tencentOralEvaluation

init setListener setRecorderParam startRecordAndEvaluation stopRecordAndEvaluation

概述

tencentOralEvaluation 模块集成了腾讯云智聆口语评测sdk，腾讯云智聆口语评测（Smart Oral Evaluation，SOE）是腾讯云推出的中英文语音评测产品。支持从儿童到成人全年龄覆盖的语音评测，提供单词、句子、段落、自由说等多种评测模式，从发音准确度、流利度、完整度等多维度评价发音水平，与专家打分相似度达95%以上，可广泛应用于中英文口语教学场景中，关于腾讯云智聆口语评测更详细的介绍请点击 这里

init

初始化

init({params}, callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status:true // 布尔值；是否初始化成功
}

示例代码

var tencentOralEvaluation = api.require('tencentOralEvaluation');
tencentOralEvaluation.init(function(ret) {
    alert(JSON.stringify(ret));
});

可用性

iOS系统，安卓系统

可提供的1.0.0及更高版本

setListener

设置数据回调

setListener(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
     eventType:"onEvaluationData", // 字符串；返回事件类型；
   oralEvaluationData:{},        // JSON对象；口语评测数据 **note：仅 onEvaluationData & onFinalEvaluationData事件类型返回**
   oralEvaluationRet:{},         // JSON对象，口语评测结果 **note：仅 onEvaluationData & onFinalEvaluationData事件类型返回**
   error:{                       // JSON对象，错误信息     **note：仅 onEvaluationData & onFinalEvaluationData事件类型返回**
     msg:'',                     // 字符串；错误信息
     code:''                     // 字符串；错误码
   },
   volume:10,                    // 数字；音量大小
      isSpeak:true                     // 布尔；检测到静音内部不会停止录制，业务层可以根据此回调主动停止录制或提示用户，onEndOfSpeechIsSpeak返回（仅支持iOS）
}

eventType：

  • 类型：字符串
  • 取值范围：
    • onEvaluationData // 语音评测数据
    • onFinalEvaluationData // 最终语音评测数据（iOS不支持）
    • onEndOfSpeech // 结束语音（iOS不支持）
    • onVolumeChanged // 音量变化
      • onEndOfSpeechIsSpeak //静音检测回调（仅支持iOS）

示例代码

var tencentOralEvaluation = api.require('tencentOralEvaluation');
tencentOralEvaluation.setListener(function(ret) {
    alert(JSON.stringify(ret));
});

可用性

iOS系统，安卓系统

可提供的1.0.0及更高版本

setRecorderParam

设置录音参数

setRecorderParam({params}, callback(ret))

params

vadEnable：

  • 类型：布尔
  • 描述：（可选项）是否开启静音检测
  • 默认值：true

vadInterval：

  • 类型：数字
  • 描述：（可选项）静音检测时间间隔
  • 默认值：5000

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status:true // 布尔值；是否设置成功
}

示例代码

var tencentOralEvaluation = api.require('tencentOralEvaluation');
tencentOralEvaluation.setRecorderParam({
  vadEnable:true,
  vadInterval:5000
},function(ret) {
    alert(JSON.stringify(ret));
});

可用性

iOS系统，安卓系统

可提供的1.0.0及更高版本

startRecordAndEvaluation

开始录音及评测

startRecordAndEvaluation({params}, callback(ret))

params

appId：

  • 类型：字符串
  • 描述：appid

sessionId：

  • 类型：字符串
  • 描述：appid

workMode:

  • 类型：数字
  • 描述：工作模式
  • 取值范围：
    • 0 STREAM
    • 1 ONCE

evalMode:

  • 类型：数字
  • 描述：评测模式
  • 取值范围：
    • 0 WORD
    • 1 SENTENCE
    • 2 PARAGRAPH
    • 3 FREE
    • 4 WORD_FIX
    • 5 SCENE
    • 6 MULTI_BRANCH
    • 7 WORD_REALTIME
    • 8 SPELLING

storageMode:

  • 类型：数字
  • 描述：存储模式
  • 取值范围：
    • 0 DISABLE
    • 1 ENABLE
    • 2 PERMANENT
    • 3 CUSTOM

serverType:

  • 类型：数字
  • 描述：服务类型
  • 取值范围：
    • 0 ENGLISH
    • 1 CHINESE

fileType:

  • 类型：数字
  • 描述：文件类型
  • 取值范围：
    • 0 RAW
    • 1 WAV
    • 2 MP3

scoreCoeff:

  • 类型：数字
  • 描述：打分系数

refText:

  • 类型：字符串
  • 描述：参考文本

secretId:

  • 类型：字符串
  • 描述：secretId

secretKey:

  • 类型：字符串
  • 描述：secretKey

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
  error:{                       // JSON对象，错误信息
    msg:'',                     // 字符串；错误信息
    code:''                     // 字符串；错误码
  }
}

示例代码

var tencentOralEvaluation = api.require('tencentOralEvaluation');
tencentOralEvaluation.startRecordAndEvaluation({
  secretId:'',
  secretKey:''
},function(ret) {
    alert(JSON.stringify(ret));
});

可用性

iOS系统，安卓系统

可提供的1.0.0及更高版本

stopRecordAndEvaluation

停止录音及评测

stopRecordAndEvaluation(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
  error:{                       // JSON对象，错误信息
    msg:'',                     // 字符串；错误信息
    code:''                     // 字符串；错误码
  }
}

示例代码

var tencentOralEvaluation = api.require('tencentOralEvaluation');
tencentOralEvaluation.stopRecordAndEvaluation(function(ret) {
    alert(JSON.stringify(ret));
});

可用性

iOS系统，安卓系统

可提供的1.0.0及更高版本