录音文件识别极速版

最近更新时间:2025-02-20 09:45:52

我的收藏

1. 接入准备

1.1 SDK获取

实时语音识别 Harmony SDK 以及 Demo 的下载地址: 接入SDK下载

1.2 接入须知

开发者在调用前请先查看录音文件识别极速版的接口说明,了解接口的使用要求使用步骤
该接口需要手机能够连接网络(3G、4G、5G 或 Wi-Fi 等)
运行 Demo 必须设置 AppID、SecretID、SecretKey,可在 API 密钥管理 中获取。

1.3 开发环境

添加录音文件识别极速版SDK har
"dependencies": {
"qcloudfileflash": "file:./sdk/qcloudfileflash.har"
}
需根据实际路径替换配置

2. 快速接入

以下为 demo 中的代码片段,完整代码请参考 sdk/demo 工程。

2.1 配置识别任务

let builder = new QCloud.FileFlash.Builder()
builder.appID = this._app_id
builder.secretID = this._secret_id
builder.secretKey = this._secret_key
builder.token = this._token
builder.setApiParam(QCloud.FileFlash.kEngineType, '16k_zh')
builder.setApiParam(QCloud.FileFlash.kVoiceFormat, 'pcm')
配置识别任务相关参数

2.2 启动识别任务

使用上面的 Builder 可以启动识别任务获取结果
this._result = await builder.build(v).task

3. 主要接口类和方法说明

3.1 Builder 类说明

Builder 用于创建语音识别任务
方法
i. setApiParam(key: string, value: string | number | null)
设置请求后台录音文件识别极速版接口时的参数,后台支持参数请参考录音文件识别极速版接口说明
名称
类型
描述
key
string
请求后台的参数名称
value
string|number|null
请求后台的参数值,null 时将删除已设置的参数,number 会转为 string 后设置
ii. getApiParam(key: string): string | number | null
获取已设置的请求参数
名称
类型
描述
key
string
参数名称
iii. build(data: ArrayBuffer): Controller
创建并启动识别任务同时返回识别任务控制器
名称
类型
描述
data
ArrayBuffer
上传的音频数据
属性
名称
类型
描述
appID
string
腾讯云 appId
secretID
string
腾讯云临时 secretId
secretKey
string
腾讯云临时 secretKey
token
string
腾讯云临时 token,为空字符串时表示不使用临时授权,临时授权参考获取联合身份临时访问凭证

3.2 Controller类说明

Controller 用于控制识别任务的流程
属性
名称
类型
描述
task
Promise<string>
识别任务,识别任务正常结束则此 Promise 正常返回后台返回参数,否则抛出异常

4. 错误码

识别任务抛出类型为 SDKErrorImpl 时的错误码
错误码
名称
描述
-1
UNKNOWN_ERROR
未知错误
1
NETWORK_ERROR
网络错误
2
SERVER_ERROR
服务端错误,详情通过 message 查看