tencentOralEvaluation

概述

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及更高版本