讯飞转写及翻译键值说明

  • Web

更新时间

查看云市场的讯飞转写及翻译键值说明,了解关键概念、参数说明、使用限制和接入注意事项。

除了声网 Web SDK 提供的插件相关方法以外,每个插件会根据具体功能提供独有的 API。本文介绍讯飞转写及翻译插件的独有 API。

方法

setOptions

TypeScript
setOptions(common, ist, its, callback): void

设置插件功能相关参数。每个参数的详细解释如下。

common

鉴权配置对象。

JavaScript
let common = {
    // 分别传入购买和激活插件时从声网控制台获取的 appKey、appSecret、appId
    apiKey: 'aaaaaaaaa',
    apiSecret: 'bbbbbbb',
    appId: '7777'
}

ist

语音转写配置对象。

JavaScript
let ist = {
    url: 'wss://ist-api.xfyun.cn/v2/ist',
    req: {
        // 业务对象。必选。
        "business": {
            // 语种。必选。"中译英":"zh_cn";"英译中":"zh_cn"。
            "language": (string),
            // 口音。必选。"中译英":"mandarin";"英译中":"mandarin"。
            "accent": (string),
            // 领域。必选。"中译英":"ist_ed_open";"英译中":"ist_ed_open"。
            "domain": (string),
            // 语言类型
            // 值类型:int
            // 值范围:
            // 1:中英文模式,中文英文均可识别;
            // 3:英文模式,只识别出英文
            // 值默认:1
            // "中译英":1;"英译中":3。
            "language_type": (int),
            // 动态修正。"wpgs"。
            "dwa": (string)
        },
        "data": {
            // 音频数据格式,raw 表示原生音频。
            "encoding": "raw"
        }
    }
}

其中,支持的语种所对应的 language、accent、domain 和 language_type 的设置参考下表:

实时转写语种languageaccentdomainlanguage_type
中英文混合zh_cnmandarinist_ed_open

语言过滤筛选:

  • 1:(默认)中英文模式,中文英文均可识别
  • 2:中文模式,可识别出简单英文
  • 3:英文模式,只能识别出英文
  • 4:纯中文模式,只能识别出中文
德语de_demandarinist_hy无需设置
阿拉伯语ar_ilmandarinist_open无需设置
西班牙语es_esmandarinist_open无需设置
法语fr_frmandarinist_open无需设置
意大利语it_ITmandarinist_open无需设置
日语ja_jpmandarinist_open无需设置
韩语ko_krmandarinist_open无需设置
俄语ru_rumandarinist_open无需设置
泰语th_THmandarinist_open无需设置
越南语vi_vnmandarinist_open无需设置
粤语zh_cncantoneseist_open无需设置
西南官话(包含四川、重庆、云南、贵州)zh_cnxinaneseist_open无需设置
河南话zh_cnhenaneseist_open无需设置
印尼语id_idmandarinist_hy无需设置
表格内容超出当前宽度,可横向滚动查看更多列。

文本翻译支持的源语 from 和目标语 to 如下:

语种参数
中文cn
英语en
日语ja
韩语ko
泰语th
斯拉夫语系
  • 俄语 ru
  • 保加利亚语 bg
  • 乌克兰语 uk
越系
  • 越南语 vi
  • 马来语 ms
  • 印尼语 id
  • 菲律宾语 tl
印欧语系
  • 德语 de
  • 西班牙语 es
  • 法语 fr
  • 意大利语 it
  • 葡萄牙语 pt
  • 捷克语 cs
  • 罗马尼亚语 ro
  • 瑞典语 sv
  • 荷兰语 nl
  • 波兰语 pl
阿拉伯语系
  • 阿拉伯语 ar
  • 波斯语 fa
  • 普什图语 ps
  • 乌尔都语 ur
印地语系
  • 印地语 hi
  • 孟加拉语 bn
外蒙哈系
  • 外蒙语-西里尔 nm
  • 外哈语 kk
突厥语系
  • 土耳其语 tr
  • 阿塞拜疆语 az
  • 芬兰语 fi
  • 豪莎语 ha
  • 匈牙利语 hu
  • 斯瓦西里语 sw
  • 乌兹别克语 uz
  • 祖鲁语 zu
希腊语系
  • 希腊语 el
  • 希伯来语 he
  • 亚美尼亚语 hy
  • 格鲁吉亚语 ka
维语ug
藏语za
粤语yue
彝语ii
壮语zua
内蒙语mn
内哈萨克语kka
方言系
  • 东北话 dbiu
  • 山东话 jlua
  • 四川话 suji
  • 上海话 xghu
  • 武汉话 hbwh
  • 河南话 hena
  • 长沙话 hncs
  • 南京话 jsnj
南非荷兰语af
阿姆哈拉语am
加泰罗尼亚语ca
丹麦语da
克罗地亚语hr
冰岛语is
爪哇语jv
高棉语km
老挝语lo
立陶宛语lt
拉脱维亚语lv
马拉雅拉姆语ml
马拉地语mr
缅甸语my
博克马尔挪威语nb
尼泊尔语ne
僧伽罗语si
斯洛伐克语sk
斯洛文尼亚语sl
塞尔维亚语sr
巽他语su
泰米尔语ta
泰卢固语te
塔吉克语tg
土库曼语tk
表格内容超出当前宽度,可横向滚动查看更多列。
互译语种参数
英日互译
  • 英语 en
  • 日语 ja
英韩互译
  • 英语 en
  • 韩语 ko
英俄互译
  • 英语 en
  • 俄语 ru
英西互译
  • 英语 en
  • 西班牙语 es
英法互译
  • 英语 en
  • 法语 fr
英粤互译
  • 英语 en
  • 粤语 yue
表格内容超出当前宽度,可横向滚动查看更多列。

its

文本翻译配置对象。如果不需要翻译功能,设为 null 即可。如果需要翻译功能,传入一个包含以下属性的对象:

JavaScript
let its = {
    protocol: 'http', // 非必填,默认 https
    url: 'localhost', // 必填,反向代理域名,代理为 https://itrans.xfyun.cn/v2/its
    host: 'itrans.xfyun.cn', // 必填,固定值
    path: '/v2/its', // 必填,固定值
    port: 80, // 非必填,http 默认 80,https 默认 443
    req: {
        "business": {
            "from": "cn", // 转写语种
            "to": "en" // 翻译语种
        }
    }
}

callback

回调函数。该函数接收的对象包含 key 和 value 两个属性。

enable

TypeScript
enable(): void | Promise<void>;

开启插件。

该方法必须在 setOptions 之后调用。调用该方法后,如果 10 s 内无音频输入,会自动停止识别。你可以重复调用该方法。

disable

TypeScript
disable(): void | Promise<void>;

关闭插件。

错误码

通用错误码

错误码说明处理方式
-101未知分析日志
-102翻译请求错误分析 error 日志,并检查参数配置或网络
-103翻译请求失败依据 statusCode 分析,通常为跨域问题,请配置反向代理等方式解决跨域问题
-104语音识别失败一般为网络连接问题,检查网络、本地时间、以及浏览器是否允许使用 WSS 协议
0成功无
表格内容超出当前宽度,可横向滚动查看更多列。

语音识别错误码

错误码说明处理方式
10043音频解码失败请检查所传的音频是否与 encoding 字段描述的编码格式对应
10139参数错误引擎编解码错误
10221服务端没有可用连接提交工单
10222有服务端组件服务连接超时提交工单
10223LB 找不到引擎节点提交工单
10225找不到 atmos提交工单
10317版本非法提交工单
11200功能未授权或授权到期提交工单申请权限
11201日流控超限额外需求请提交工单
11202秒级流控超限额外需求请提交工单
11203并发流控超限额外需求请提交工单
11204组鉴权未通过,即组内所有功能均受限如有需求请提交工单
10160请求数据格式非法检查请求数据是否是合法的 JSON
10161Base64 解码失败检查发送的数据是否使用 Base64 编码了
10163参数校验失败由客户端参数校验失败引起,客户端需要依据返回的 message 字段中的描述来更改请求参数
10200读取数据超时检查是否累计 10 s 未发送数据并且未关闭连接
10114会话时间超时会话时间超过了 60000 s,请控制会话时间,保持不超过 60000 s
10313appId 和 apiKey 不匹配或者没有传 appId检查请求参数
11503服务内部响应数据错误提交工单
11502服务配置错误提交工单
10118服务端无法解析后端响应数据提交工单
12000用户发完数据没有收到结果-
12001用户没有正常发送完数据-
99999用户异常断开连接,或者会话超时断开连接-
表格内容超出当前宽度,可横向滚动查看更多列。

机器翻译错误码

错误码说明处理方式
10324Sid 生成失败联系技术人员
10106非法的参数检查参数是否正确上传
10107非法参数值检查参数值是否在取值范围内
10109非法的 data检查发送的文本是否合法
10114超时检查网络是否通畅
11210appId 和 apiKey 不匹配检查 appId 和 apiKey 是否匹配
表格内容超出当前宽度,可横向滚动查看更多列。