腾讯云智聆口语评测快速入门-教育服务解决方案

流程图



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折活动,限时活动,即将结束,速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠

发表评论