腾讯云智聆口语评测快速入门-教育服务解决方案
流程图
 
SDK DEMO使用流程
在线调试
1. 使用浏览器打开Demo 。2. 获取密钥后填入,点击开始录音,进行评测。 
开发集成
1. 使用浏览器打开DEMO 。 2. 选择一种接入方式(固定密钥,临时密钥,后端评测)。3. 选择任意一种查看源码。密钥获取参考获取密钥。
固定密钥接入
在 DEMO 中填入固定密钥 SecretId,SecretKey。参考网站源码或者固定密钥传入。 
临时密钥接入
在 DEMO 中填入服务端获取临时密钥地址即可。参考网站源码或者临时密钥接入。 
后端评测接入
在 DEMO 中填入服务端获取评测结果地址。参考网站源码或者后端评测接入。 
SDK 使用方法
SDK 引入
请求头中引入依赖为0.2.2版本。
SDK初始化
固定密钥接入
1. 创建 TencentSOE 对象,使用 SecretId,SecretKey 进行签名认证。注意:该格式适用于前端调试,若使用此格式,请避免泄露密钥。2. TencentSOE 获取的对象是唯一的,不同的界面需要重新创建。同一页面可以使用 reset 修改评测参数。注意建议用户使用子账号密钥 + 环境变量的方式调用 SDK,提高 SDK 使用的安全性。为子账号授权时,请遵循 最小权限指引原则,防止泄漏其他资源。如果您一定要使用永久密钥,建议遵循 最小权限指引原则 对永久密钥的权限范围进行限制。
let recorder = new TencentSOE({  SecretId: 'your secretid', // 用户的 SecretId,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取可参考https://cloud.tencent.com/document/product/598/37140  SecretKey: 'your secretkey',  // 用户的 SecretKey,建议使用子账号密钥,授权遵循最小权限指引,降低使用风险。子账号密钥获取可参考https://cloud.tencent.com/document/product/598/37140  success() {    recorder.start({});  },  error(err) {    console.log(err);  }});
临时密钥接入
使用固定密钥可能存在被盗取的风险,线上环境推荐使用临时访问凭证。示例参考getAuthorization 接口说明。
let recorder = new TencentSOE({  getAuthorization(callback) {    let url = ''; // 服务端获取临时密钥地址    $.get(url, function (data) {      callback({        Token: data.Credentials.Token,        TmpSecretId: data.Credentials.TmpSecretId,        TmpSecretKey: data.Credentials.TmpSecretKey,        ExpiredTime: data.ExpiredTime      });    });  },  success() {    recorder.start({});  },  error(err) {    console.log(err);  }});
服务端评测接入
Web SDK 通过发送 POST 请求, Content-Type 类型为 application/json。调用服务端评测进行评测,将返回结果回调。示例参考TransInitUrl 接口说明。
let recorder = new TencentSOE({  TransInitUrl: '',服务端获取评测结果地址  success() {    recorder.start({});  },  error(err) {    console.log(err);  }});
参数说明
TencentSOE 说明
| 参数 | 类型 | 是否必填 | 默认值 | 说明 | 
| SecretId | String | 否 | 无 | 用户 SecretId | 
| SecretKey | String | 否 | 无 | 用户 SecretKey | 
| getAuthorization | function | 否 | 无 | 获取临时密钥接口,参考getAuthorization 接口说明 | 
| TransInitUrl | String | 否 | 无 | 发音数据传输附带初始化接口地址,参考TransInitUrl 接口说明 | 
| success | function | 否 | 无 | 创建成功回调 | 
| error | function | 否 | 无 | 创建失败回调 | 
| WorkMode | Integer | 否 | 0 | 语音输入模式,0流式分片,1非流式一次性评估。参考语音输入模式介绍 | 
| EvalMode | Integer | 否 | 0 | 评测模式0:单词模式 1:句子模式 2:段落模式 3:自由说模式 4:单词音素纠错模式 5:情景评测模式 6:句子多分支评测模式 7:单词实时评测模式 8:拼音评测模式参考评测模式介绍 | 
| ScoreCoeff | Float | 否 | 3.5 | 评价苛刻指数,取值为[1.0 – 4.0]范围内的浮点数用于平滑不同年龄段的分数,1.0为小年龄段,4.0为最高年龄段。参考苛刻指数介绍 | 
| SoeAppId | String | 否 | 无 | 业务应用 ID,参考业务应用 ID 介绍 | 
| ServerType | Integer | 否 | 0 | 评估语言,0:英文,1:中文。参考评测模式介绍 | 
| TextMode | Integer | 否 | 0 | 输入文本模式,0: 普通文本,1: 音素结构文本,参考音素标注 | 
| SilentDuration | Float | 否 | 5000 | 触发静音回调所需要检测的连续的时间;单位为毫秒 | 
| SilentVolume | Float | 否 | 20 | 低于该值,则认为是静音。取值为1 – 100 | 
| cosBuketUrl | String | 否 | 无 | 音频存储路径,将音频存储到 COS 桶中(0.2.2及以上版本支持)。使用参考音频存储路径 | 
error 错误码说明
| code | 错误说明 | 
| 10000 | 参数格式错误 | 
| 10001 | 当前浏览器不支持录音功能 | 
| 10002 | 未开启麦克风访问权限 | 
| 10003 | 未提供发音评估初始化接口 | 
| 10004 | 未提供发音数据传输接口 | 
| 10005 | 未提供测评文本 | 
| 10006 | 上传文件必须是 MP3 类型 | 
| 10007 | 未引入微信 JS-SDK | 
| 10008 | 用户拒绝用户拒绝授权录音 | 
| 10009 | 上传文件必须是 MP3 类型 | 
| 10010 | 网络异常 | 
| 10011 | TransInitUrl 接口不正确 | 
| 10012 | MediaUrl 接口不正确 | 
| 10013 | 录音失败,请重新录音 | 
| 10020 | 接口错误,具体看返回信息 | 
平台和兼容性
| 操作系统平台 | 浏览器/webview | 版本要求 | 备注 | 
| iOS | Safari ( 只支持 Safari ) | 11.1.2 | – | 
| Android | TBS (微信和手机 QQ 的默认 webview) | 43600 | 微信和手机 QQ 默认内置的浏览器内核为 TBS | 
| Android | Chrome | 86+ | – | 
| Mac | Chrome | 86+ | – | 
| Mac | Safari | 11+ | – | 
| Windows(PC) | Chrome | 86+ | – | 
| Windows(PC) | QQ 浏览器 | 10.2 | – | 
| 微信端 | 微信默认 webview | 无 | 需引入微信 JS-SDK | 
注意非本地环境必须使用 HTTPS 协议。
 腾讯云官网1折活动,限时活动,即将结束,速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
 
              
发表评论