# 讯飞转写及翻译键值说明 (/zh-CN/realtime-media/marketplace/reference/iflytek-asr-api)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
<_PlatformTabsGroup>
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="android" />
在声网 SDK 提供的插件相关方法和回调中，`key` 和 `value` 参数取决于你使用的插件。本页提供讯飞转写及翻译插件支持的 `key` 和 `value` 说明。
## 插件的 key 概览 [#插件的-key-概览]
### 方法 key [#方法-key]
本节列出调用声网 SDK 的插件相关方法时，支持传入的 `key` 及对应功能。
| setExtensionProperty 方法的 key| 描述 |
| ------------------------------------ | -------- |
| [`start_listening`](#start_listening) | 启动倾听 |
| [`flush_listening`](#flush_listening) | 结束音频获取结果 |
| [`stop_listening`](#stop_listening) | 停止倾听 |
| setExtensionProviderProperty 方法的 key| 描述 |
| ------------------------------------ | -------- |
| [`log_lv`](#log_lv) | 设置日志等级 |
### 回调 key [#回调-key]
本节列出声网 SDK 的 `onEvent` 回调返回的 `key`。
| onEvent 回调的 key| 描述 |
| ------------------------------------ | -------- |
| [`error`](#error) | 错误类型 |
| [`ist_result`](#ist_result) | 语音转写结果 |
| [`its_result`](#its_result) | 文本翻译结果 |
| [`end`](#end) | 会话结束的最后事件 |
## 方法 key 的 value 说明 [#方法-key-的-value-说明]
### start_listening [#start_listening]
value 包含的参数及含义详见以下代码注释：
```json
{
// 公共对象。必选。
"common": {
// 应用标识。必选。
"app_id": "aaa",
// API key。必选。
"api_key": "bbb",
// API secret。必选。
"api_secret": "ccc"
},
// 语音转写对象。必选。
"ist": {
// URI。必选。
"uri": "wss://ist-api.xfyun.cn/v2/ist",
// 请求对象。必选。
"req": {
// 业务对象。必选。
"business": {
// 语种。必选。中译英："zh_cn"；英译中："zh_cn"。
"language": "zh_cn",
// 口音。必选。中译英："mandarin"；英译中："mandarin"。
"accent": "mandarin",
// 领域。必选。中译英："ist_ed_open"；英译中："ist_ed_open"。
"domain": "ist_ed_open",
// 语言类型（Int）。
// 1：（默认）中英文模式，中文英文均可识别。中译英设为 1。
// 3：英文模式，只识别出英文。英译中设为 3。
"language_type": 1,
// 动态修正。
"dwa": "wpgs"
},
"data": {
// 音频数据格式，raw 表示原生音频。
"encoding": "raw"
}
}
},
// 文本翻译对象。
"its": {
// URI。必选。
"uri": "https://itrans.xfyun.cn/v2/its",
// 请求对象。必选。
"req": {
// 业务对象。必选。
"business": {
// 源语种。必选。中译英："cn"；英译中："en"。
"from": "cn",
// 目标语种。必选。中译英："en"；英译中："cn"。
"to": "en"
}
}
}
}
```
其中，语音转写支持的语种所对应的 `language`、`accent`、`domain` 和 `language_type` 的设置参考下表：
| 实时转写语种 | `language` | `accent` | `domain` | `language_type` |
| --- | --- | --- | --- | --- |
| 中英文混合 | `zh_cn` | `mandarin` | `ist_ed_open` | [iflytek-asr-api-android-ios-windows-html-0-1-4 details](#table-slot-iflytek-asr-api-android-ios-windows-html-0-1-4) |
| 德语 | `de_de` | `mandarin` | `ist_hy` | 无需设置 |
| 阿拉伯语 | `ar_il` | `mandarin` | `ist_open` | 无需设置 |
| 西班牙语 | `es_es` | `mandarin` | `ist_open` | 无需设置 |
| 法语 | `fr_fr` | `mandarin` | `ist_open` | 无需设置 |
| 意大利语 | `it_IT` | `mandarin` | `ist_open` | 无需设置 |
| 日语 | `ja_jp` | `mandarin` | `ist_open` | 无需设置 |
| 韩语 | `ko_kr` | `mandarin` | `ist_open` | 无需设置 |
| 俄语 | `ru_ru` | `mandarin` | `ist_open` | 无需设置 |
| 泰语 | `th_TH` | `mandarin` | `ist_open` | 无需设置 |
| 越南语 | `vi_vn` | `mandarin` | `ist_open` | 无需设置 |
| 粤语 | `zh_cn` | `cantonese` | `ist_open` | 无需设置 |
| 西南官话（包含四川、重庆、云南、贵州） | `zh_cn` | `xinanese` | `ist_open` | 无需设置 |
| 河南话 | `zh_cn` | `henanese` | `ist_open` | 无需设置 |
| 印尼语 | `id_id` | `mandarin` | `ist_hy` | 无需设置 |
**iflytek-asr-api-android-ios-windows-html-0-1-4 details**
语言过滤筛选：
- `1`：（默认）中英文模式，中文英文均可识别
- `2`：中文模式，可识别出简单英文
- `3`：英文模式，只能识别出英文
- `4`：纯中文模式，只能识别出中文
文本翻译支持的源语 `from` 和目标语 `to` 如下：
中文与其它语种互译
英语与其他语种互译
| 语种 | 参数 |
| --- | --- |
| 中文 | `cn` |
| 英语 | `en` |
| 日语 | `ja` |
| 韩语 | `ko` |
| 泰语 | `th` |
| 斯拉夫语系 | [iflytek-asr-api-android-ios-windows-html-1-6-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-6-1) |
| 越系 | [iflytek-asr-api-android-ios-windows-html-1-7-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-7-1) |
| 印欧语系 | [iflytek-asr-api-android-ios-windows-html-1-8-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-8-1) |
| 阿拉伯语系 | [iflytek-asr-api-android-ios-windows-html-1-9-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-9-1) |
| 印地语系 | [iflytek-asr-api-android-ios-windows-html-1-10-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-10-1) |
| 外蒙哈系 | [iflytek-asr-api-android-ios-windows-html-1-11-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-11-1) |
| 突厥语系 | [iflytek-asr-api-android-ios-windows-html-1-12-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-12-1) |
| 希腊语系 | [iflytek-asr-api-android-ios-windows-html-1-13-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-13-1) |
| 维语 | `ug` |
| 藏语 | `za` |
| 粤语 | `yue` |
| 彝语 | `ii` |
| 壮语 | `zua` |
| 内蒙语 | `mn` |
| 内哈萨克语 | `kka` |
| 方言系 | [iflytek-asr-api-android-ios-windows-html-1-21-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-21-1) |
| 南非荷兰语 | `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` |
**iflytek-asr-api-android-ios-windows-html-1-6-1 details**
- 俄语 `ru`
- 保加利亚语 `bg`
- 乌克兰语 `uk`
**iflytek-asr-api-android-ios-windows-html-1-7-1 details**
- 越南语 `vi`
- 马来语 `ms`
- 印尼语 `id`
- 菲律宾语 `tl`
**iflytek-asr-api-android-ios-windows-html-1-8-1 details**
- 德语 `de`
- 西班牙语 `es`
- 法语 `fr`
- 意大利语 `it`
- 葡萄牙语 `pt`
- 捷克语 `cs`
- 罗马尼亚语 `ro`
- 瑞典语 `sv`
- 荷兰语 `nl`
- 波兰语 `pl`
**iflytek-asr-api-android-ios-windows-html-1-9-1 details**
- 阿拉伯语 `ar`
- 波斯语 `fa`
- 普什图语 `ps`
- 乌尔都语 `ur`
**iflytek-asr-api-android-ios-windows-html-1-10-1 details**
- 印地语 `hi`
- 孟加拉语 `bn`
**iflytek-asr-api-android-ios-windows-html-1-11-1 details**
- 外蒙语-西里尔 `nm`
- 外哈语 `kk`
**iflytek-asr-api-android-ios-windows-html-1-12-1 details**
- 土耳其语 `tr`
- 阿塞拜疆语 `az`
- 芬兰语 `fi`
- 豪莎语 `ha`
- 匈牙利语 `hu`
- 斯瓦西里语 `sw`
- 乌兹别克语 `uz`
- 祖鲁语 `zu`
**iflytek-asr-api-android-ios-windows-html-1-13-1 details**
- 希腊语 `el`
- 希伯来语 `he`
- 亚美尼亚语 `hy`
- 格鲁吉亚语 `ka`
**iflytek-asr-api-android-ios-windows-html-1-21-1 details**
- 东北话 `dbiu`
- 山东话 `jlua`
- 四川话 `suji`
- 上海话 `xghu`
- 武汉话 `hbwh`
- 河南话 `hena`
- 长沙话 `hncs`
- 南京话 `jsnj`
| 互译语种 | 参数 |
| --- | --- |
| 英日互译 | [iflytek-asr-api-android-ios-windows-html-2-1-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-1-1) |
| 英韩互译 | [iflytek-asr-api-android-ios-windows-html-2-2-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-2-1) |
| 英俄互译 | [iflytek-asr-api-android-ios-windows-html-2-3-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-3-1) |
| 英西互译 | [iflytek-asr-api-android-ios-windows-html-2-4-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-4-1) |
| 英法互译 | [iflytek-asr-api-android-ios-windows-html-2-5-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-5-1) |
| 英粤互译 | [iflytek-asr-api-android-ios-windows-html-2-6-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-6-1) |
**iflytek-asr-api-android-ios-windows-html-2-1-1 details**
- 英语 `en`
- 日语 `ja`
**iflytek-asr-api-android-ios-windows-html-2-2-1 details**
- 英语 `en`
- 韩语 `ko`
**iflytek-asr-api-android-ios-windows-html-2-3-1 details**
- 英语 `en`
- 俄语 `ru`
**iflytek-asr-api-android-ios-windows-html-2-4-1 details**
- 英语 `en`
- 西班牙语 `es`
**iflytek-asr-api-android-ios-windows-html-2-5-1 details**
- 英语 `en`
- 法语 `fr`
**iflytek-asr-api-android-ios-windows-html-2-6-1 details**
- 英语 `en`
- 粤语 `yue`
### flush_listening [#flush_listening]
无 value 参数。
### stop_listening [#stop_listening]
无 value 参数。
### log_lv [#log_lv]
value 参数为 Int 型，支持设为以下值：
- 0（默认）：LOG_LVL_UNKNOWN
- 1：LOG_LVL_DEFAULT
- 2：LOG_LVL_VERBOSE
- 3：LOG_LVL_DEBUG
- 4：LOG_LVL_INFO
- 5：LOG_LVL_WARN
- 6：LOG_LVL_ERROR
- 7：LOG_LVL_FATAL
- 8：LOG_LVL_SILENT
## 回调 key 的 value 说明 [#回调-key-的-value-说明]
### error [#error]
`value` 包含以下参数：
| value 参数| 描述 |
| ----------- | ---------------------- |
| `err_code`| Int 型，[错误码](#错误码)。|
| `tip`| String 型，提示内容。 |
### ist_result [#ist_result]
value 包含的参数及含义详见以下代码注释：
```json
{
// 错误码，0标识成功。
"code": 0,
// 错误描述
"message": "success",
// 每次会话的唯一标识
"sid": "ist000d6ed7@dx17efb57a7faa497822",
// 识别数据
"data": {
// 识别结果是否结束标识：1：识别中；2：识别结束。
"status": 1,
// 识别结果
"result": {
// 返回结果的序号
"sn": 6,
// 是否是最后一片结果
"ls": false,
// 子句开始时刻，ms。
"bg": 1810,
// 子句结束时刻，ms。
"ed": 3840,
// 开启 wpgs 会有此字段，取值为 "apd"时表示该片结果是追加到前面的最终结果，取值为"rpl" 时表示替换前面的部分结果，替换范围为rg字段。
"pgs": "rpl",
// 替换范围，开启wpgs会有该字段。
"rg": [3, 5],
// 是否子句结束
"sub_end": true,
// 词组
"ws": [
{
// 词相对子句开始时刻，10ms。
"bg": 61,
// 词多候选组
"cw": [
{
"rl": 0,
// 分数
"sc": 0.0,
// 词
"w": "。",
// 词相对子句开始时刻，10ms。
"wb": 61,
"wc": 0.0,
// 词相对子句结束时刻，10ms。
"we": 61,
// 词语的属性，其中n表示正常词、s表示顺滑、p表示标点、g表示分段。
"wp": "p"
}
]
},
{
"bg": 61,
"cw": [
{
"rl": 0,
"sc": 0.0,
"w": "你好",
"wb": 61,
"wc": 0.0,
"we": 112,
"wp": "s"
}
]
}
]
}
},
// 业务上下文id，唯一标识一路完整会话(包括重连成功的请求)。
"context_id": "ZHhpc3QIIKwVpJc3cuhGrtbTFj2t"
}
```
### its_result [#its_result]
value 包含的参数及含义详见以下代码注释：
```json
{
// 错误码，0标识成功。
"code": 0,
// 错误描述
"message": "success",
// 每次会话的唯一标识
"sid": "its000825bc@dx17efb57b09ba11d902",
// 翻译数据
"data": {
// 结果
"result": {
// 源语种
"from": "cn",
// 目标语种
"to": "en",
// 翻译结果
"trans_result": {
// 源文本
"src": "。你好你好",
// 目标文本
"dst": "。 Hello Hello"
}
}
},
// 语音转写结果序号
"ist_sn": 6
}
```
## 错误码 [#错误码]
### SDK 错误码 [#sdk-错误码]
| 错误码 | 说明 | 处理方式 |
| ---- | ----- | --------------------------------------------------------------------- |
| -101 | 未知 | 分析日志 |
| -102 | 内部 | 分析日志 |
| -103 | 无效参数 | 检查输入参数 |
| -104 | 无效参数键 | 检查输入参数键 |
| -105 | 无效参数值 | 检查输入参数值 |
| -106 | 状态 | 检查当前状态下调用是否合法，例如空闲时才能调用 `start_listening`，会话中才能调用 `flush_listening` 和 `stop_listening` |
| -107 | 繁忙 | 分析日志 |
| -108 | 内存不足 | 检查内存用量 |
| -109 | 网络 | 检查网络是否通畅 |
| 0 | 成功 | 无 |
### 常见错误码 [#常见错误码]
| 错误码 | 说明 | 处理方式 |
| ----- | ------------------------- | --------------------------------------------- |
| 10043 | 音频解码失败 | 请检查所传的音频是否与 `encoding` 字段描述的编码格式对应。 |
| 10139 | 参数错误 | 引擎编解码错误 |
| 10221 | 服务端没有可用连接 | 提交工单 |
| 10222 | 有服务端组件服务连接超时 | 提交工单 |
| 10223 | LB 找不到引擎节点 | 提交工单 |
| 10225 | 找不到 atmos | 提交工单 |
| 10317 | 版本非法 | 提交工单 |
| 11200 | 功能未授权或授权到期 | 提交工单申请权限 |
| 11201 | 日流控超限 | 额外需求请提交工单 |
| 11202 | 秒级流控超限 | 额外需求请提交工单 |
| 11203 | 并发流控超限 | 额外需求请提交工单 |
| 11204 | 组鉴权未通过，即组内所有功能均受限 | 如有需求请提交工单 |
| 10160 | 请求数据格式非法 | 检查请求数据是否是合法的 JSON |
| 10161 | Base64 解码失败 | 检查发送的数据是否使用 Base64 编码了 |
| 10163 | 参数校验失败 | 由客户端参数校验失败引起，客户端需要依据返回的 `message` 字段中的描述来更改请求参数 |
| 10200 | 读取数据超时 | 检查是否累计 10 s 未发送数据并且未关闭连接 |
| 10114 | 会话时间超时 | 会话时间超过了 60000 s，请控制会话时间，保持不超过 60000 s。 |
| 10313 | `app_id` 和 `api_key` 不匹配或者没有传 `app_id` | 检查请求参数 |
| 11503 | 服务内部响应数据错误 | 提交工单 |
| 11502 | 服务配置错误 | 提交工单 |
| 10118 | 服务端无法解析后端响应数据 | 提交工单 |
| 12000 | 用户发完数据没有收到结果 | — |
| 12001 | 用户没有正常发送完数据 | - |
| 99999 | 用户异常断开连接，或者会话超时断开连接 | — |
### 引擎通用错误码 [#引擎通用错误码]
| 错误码 | 说明 |
| ------ | ------------------------------------------- |
| 10003 | 无效操作 |
| 10004 | session 模式非法 |
| 10008 | 句柄错误（忽略） |
| 10009 | 输入数据非法 |
| 10010 | 授权不足 |
| 10019 | session 会话超时，请先自查客户端发包间隔时长 |
| 10101 | 引擎会话已结束（忽略） |
| 10300 | 排序缓冲区为空 |
| 10301 | 排序 channel 已关闭 |
| 10400 | pb 协议序列化错误 |
| 10401 | pb 协议反序列化错误 |
| 10500 | 内部同步错误 |
| 10600 | 事件异常错误 |
| 10700 | 引擎异常 |
### 文本翻译错误码 [#文本翻译错误码]
| 错误码 | 说明 | 处理方式 |
| ----- | -------- | --------------- |
| 10324 | Sid 生成失败 | 联系技术人员 |
| 10106 | 非法的参数 | 检查参数是否正确上传 |
| 10107 | 非法参数值 | 检查参数值是否在取值范围内 |
| 10109 | 非法的 data | 检查发送的文本是否合法 |
| 10114 | 超时 | 检查网络是否通畅 |
| 11210 | `app_id` 和 `api_key` 不匹配 | 检查 `app_id` 和 `api_key` 是否匹配 |
<_PlatformProcessedMarker close="true" />
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="ios" />
在声网 SDK 提供的插件相关方法和回调中，`key` 和 `value` 参数取决于你使用的插件。本页提供讯飞转写及翻译插件支持的 `key` 和 `value` 说明。
## 插件的 key 概览 [#插件的-key-概览-1]
### 方法 key [#方法-key-1]
本节列出调用声网 SDK 的插件相关方法时，支持传入的 `key` 及对应功能。
| setExtensionPropertyWithVendor 方法的 key| 描述 |
| ------------------------------------ | -------- |
| [`start_listening`](#start_listening-1) | 启动倾听 |
| [`flush_listening`](#flush_listening-1) | 结束音频获取结果 |
| [`stop_listening`](#stop_listening-1) | 停止倾听 |
| setExtensionProviderPropertyWithVendor 方法的 key| 描述 |
| ------------------------------------ | -------- |
| [`log_lv`](#log_lv-1) | 设置日志等级 |
### 回调 key [#回调-key-1]
本节列出声网 SDK 的 `onEvent` 回调返回的 `key`。
| onEvent 回调的 key| 描述 |
| ------------------------------------ | -------- |
| [`error`](#error-1) | 错误类型 |
| [`ist_result`](#ist_result-1) | 语音转写结果 |
| [`its_result`](#its_result-1) | 文本翻译结果 |
| [`end`](#回调-key-1) | 会话结束的最后事件 |
## 方法 key 的 value 说明 [#方法-key-的-value-说明-1]
### start_listening [#start_listening-1]
value 包含的参数及含义详见以下代码注释：
```json
{
// 公共对象。必选。
"common": {
// 应用标识。必选。
"app_id": "aaa",
// API key。必选。
"api_key": "bbb",
// API secret。必选。
"api_secret": "ccc"
},
// 语音转写对象。必选。
"ist": {
// URI。必选。
"uri": "wss://ist-api.xfyun.cn/v2/ist",
// 请求对象。必选。
"req": {
// 业务对象。必选。
"business": {
// 语种。必选。中译英："zh_cn"；英译中："zh_cn"。
"language": "zh_cn",
// 口音。必选。中译英："mandarin"；英译中："mandarin"。
"accent": "mandarin",
// 领域。必选。中译英："ist_ed_open"；英译中："ist_ed_open"。
"domain": "ist_ed_open",
// 语言类型（Int）。
// 1：（默认）中英文模式，中文英文均可识别。中译英设为 1。
// 3：英文模式，只识别出英文。英译中设为 3。
"language_type": 1,
// 动态修正。
"dwa": "wpgs"
},
"data": {
// 音频数据格式，raw 表示原生音频。
"encoding": "raw"
}
}
},
// 文本翻译对象。
"its": {
// URI。必选。
"uri": "https://itrans.xfyun.cn/v2/its",
// 请求对象。必选。
"req": {
// 业务对象。必选。
"business": {
// 源语种。必选。中译英："cn"；英译中："en"。
"from": "cn",
// 目标语种。必选。中译英："en"；英译中："cn"。
"to": "en"
}
}
}
}
```
其中，语音转写支持的语种所对应的 `language`、`accent`、`domain` 和 `language_type` 的设置参考下表：
| 实时转写语种 | `language` | `accent` | `domain` | `language_type` |
| --- | --- | --- | --- | --- |
| 中英文混合 | `zh_cn` | `mandarin` | `ist_ed_open` | [iflytek-asr-api-android-ios-windows-html-0-1-4 details](#table-slot-iflytek-asr-api-android-ios-windows-html-0-1-4-1) |
| 德语 | `de_de` | `mandarin` | `ist_hy` | 无需设置 |
| 阿拉伯语 | `ar_il` | `mandarin` | `ist_open` | 无需设置 |
| 西班牙语 | `es_es` | `mandarin` | `ist_open` | 无需设置 |
| 法语 | `fr_fr` | `mandarin` | `ist_open` | 无需设置 |
| 意大利语 | `it_IT` | `mandarin` | `ist_open` | 无需设置 |
| 日语 | `ja_jp` | `mandarin` | `ist_open` | 无需设置 |
| 韩语 | `ko_kr` | `mandarin` | `ist_open` | 无需设置 |
| 俄语 | `ru_ru` | `mandarin` | `ist_open` | 无需设置 |
| 泰语 | `th_TH` | `mandarin` | `ist_open` | 无需设置 |
| 越南语 | `vi_vn` | `mandarin` | `ist_open` | 无需设置 |
| 粤语 | `zh_cn` | `cantonese` | `ist_open` | 无需设置 |
| 西南官话（包含四川、重庆、云南、贵州） | `zh_cn` | `xinanese` | `ist_open` | 无需设置 |
| 河南话 | `zh_cn` | `henanese` | `ist_open` | 无需设置 |
| 印尼语 | `id_id` | `mandarin` | `ist_hy` | 无需设置 |
**iflytek-asr-api-android-ios-windows-html-0-1-4 details**
语言过滤筛选：
- `1`：（默认）中英文模式，中文英文均可识别
- `2`：中文模式，可识别出简单英文
- `3`：英文模式，只能识别出英文
- `4`：纯中文模式，只能识别出中文
文本翻译支持的源语 `from` 和目标语 `to` 如下：
中文与其它语种互译
英语与其他语种互译
| 语种 | 参数 |
| --- | --- |
| 中文 | `cn` |
| 英语 | `en` |
| 日语 | `ja` |
| 韩语 | `ko` |
| 泰语 | `th` |
| 斯拉夫语系 | [iflytek-asr-api-android-ios-windows-html-1-6-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-6-1-1) |
| 越系 | [iflytek-asr-api-android-ios-windows-html-1-7-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-7-1-1) |
| 印欧语系 | [iflytek-asr-api-android-ios-windows-html-1-8-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-8-1-1) |
| 阿拉伯语系 | [iflytek-asr-api-android-ios-windows-html-1-9-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-9-1-1) |
| 印地语系 | [iflytek-asr-api-android-ios-windows-html-1-10-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-10-1-1) |
| 外蒙哈系 | [iflytek-asr-api-android-ios-windows-html-1-11-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-11-1-1) |
| 突厥语系 | [iflytek-asr-api-android-ios-windows-html-1-12-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-12-1-1) |
| 希腊语系 | [iflytek-asr-api-android-ios-windows-html-1-13-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-13-1-1) |
| 维语 | `ug` |
| 藏语 | `za` |
| 粤语 | `yue` |
| 彝语 | `ii` |
| 壮语 | `zua` |
| 内蒙语 | `mn` |
| 内哈萨克语 | `kka` |
| 方言系 | [iflytek-asr-api-android-ios-windows-html-1-21-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-21-1-1) |
| 南非荷兰语 | `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` |
**iflytek-asr-api-android-ios-windows-html-1-6-1 details**
- 俄语 `ru`
- 保加利亚语 `bg`
- 乌克兰语 `uk`
**iflytek-asr-api-android-ios-windows-html-1-7-1 details**
- 越南语 `vi`
- 马来语 `ms`
- 印尼语 `id`
- 菲律宾语 `tl`
**iflytek-asr-api-android-ios-windows-html-1-8-1 details**
- 德语 `de`
- 西班牙语 `es`
- 法语 `fr`
- 意大利语 `it`
- 葡萄牙语 `pt`
- 捷克语 `cs`
- 罗马尼亚语 `ro`
- 瑞典语 `sv`
- 荷兰语 `nl`
- 波兰语 `pl`
**iflytek-asr-api-android-ios-windows-html-1-9-1 details**
- 阿拉伯语 `ar`
- 波斯语 `fa`
- 普什图语 `ps`
- 乌尔都语 `ur`
**iflytek-asr-api-android-ios-windows-html-1-10-1 details**
- 印地语 `hi`
- 孟加拉语 `bn`
**iflytek-asr-api-android-ios-windows-html-1-11-1 details**
- 外蒙语-西里尔 `nm`
- 外哈语 `kk`
**iflytek-asr-api-android-ios-windows-html-1-12-1 details**
- 土耳其语 `tr`
- 阿塞拜疆语 `az`
- 芬兰语 `fi`
- 豪莎语 `ha`
- 匈牙利语 `hu`
- 斯瓦西里语 `sw`
- 乌兹别克语 `uz`
- 祖鲁语 `zu`
**iflytek-asr-api-android-ios-windows-html-1-13-1 details**
- 希腊语 `el`
- 希伯来语 `he`
- 亚美尼亚语 `hy`
- 格鲁吉亚语 `ka`
**iflytek-asr-api-android-ios-windows-html-1-21-1 details**
- 东北话 `dbiu`
- 山东话 `jlua`
- 四川话 `suji`
- 上海话 `xghu`
- 武汉话 `hbwh`
- 河南话 `hena`
- 长沙话 `hncs`
- 南京话 `jsnj`
| 互译语种 | 参数 |
| --- | --- |
| 英日互译 | [iflytek-asr-api-android-ios-windows-html-2-1-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-1-1-1) |
| 英韩互译 | [iflytek-asr-api-android-ios-windows-html-2-2-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-2-1-1) |
| 英俄互译 | [iflytek-asr-api-android-ios-windows-html-2-3-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-3-1-1) |
| 英西互译 | [iflytek-asr-api-android-ios-windows-html-2-4-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-4-1-1) |
| 英法互译 | [iflytek-asr-api-android-ios-windows-html-2-5-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-5-1-1) |
| 英粤互译 | [iflytek-asr-api-android-ios-windows-html-2-6-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-6-1-1) |
**iflytek-asr-api-android-ios-windows-html-2-1-1 details**
- 英语 `en`
- 日语 `ja`
**iflytek-asr-api-android-ios-windows-html-2-2-1 details**
- 英语 `en`
- 韩语 `ko`
**iflytek-asr-api-android-ios-windows-html-2-3-1 details**
- 英语 `en`
- 俄语 `ru`
**iflytek-asr-api-android-ios-windows-html-2-4-1 details**
- 英语 `en`
- 西班牙语 `es`
**iflytek-asr-api-android-ios-windows-html-2-5-1 details**
- 英语 `en`
- 法语 `fr`
**iflytek-asr-api-android-ios-windows-html-2-6-1 details**
- 英语 `en`
- 粤语 `yue`
### flush_listening [#flush_listening-1]
无 value 参数。
### stop_listening [#stop_listening-1]
无 value 参数。
### log_lv [#log_lv-1]
value 参数为 Int 型，支持设为以下值：
- 0（默认）：LOG_LVL_UNKNOWN
- 1：LOG_LVL_DEFAULT
- 2：LOG_LVL_VERBOSE
- 3：LOG_LVL_DEBUG
- 4：LOG_LVL_INFO
- 5：LOG_LVL_WARN
- 6：LOG_LVL_ERROR
- 7：LOG_LVL_FATAL
- 8：LOG_LVL_SILENT
## 回调 key 的 value 说明 [#回调-key-的-value-说明-1]
### error [#error-1]
`value` 包含以下参数：
| value 参数| 描述 |
| ----------- | ---------------------- |
| `err_code`| Int 型，[错误码](#错误码-1)。|
| `tip`| String 型，提示内容。 |
### ist_result [#ist_result-1]
value 包含的参数及含义详见以下代码注释：
```json
{
// 错误码，0标识成功。
"code": 0,
// 错误描述
"message": "success",
// 每次会话的唯一标识
"sid": "ist000d6ed7@dx17efb57a7faa497822",
// 识别数据
"data": {
// 识别结果是否结束标识：1：识别中；2：识别结束。
"status": 1,
// 识别结果
"result": {
// 返回结果的序号
"sn": 6,
// 是否是最后一片结果
"ls": false,
// 子句开始时刻，ms。
"bg": 1810,
// 子句结束时刻，ms。
"ed": 3840,
// 开启 wpgs 会有此字段，取值为 "apd"时表示该片结果是追加到前面的最终结果，取值为"rpl" 时表示替换前面的部分结果，替换范围为rg字段。
"pgs": "rpl",
// 替换范围，开启wpgs会有该字段。
"rg": [3, 5],
// 是否子句结束
"sub_end": true,
// 词组
"ws": [
{
// 词相对子句开始时刻，10ms。
"bg": 61,
// 词多候选组
"cw": [
{
"rl": 0,
// 分数
"sc": 0.0,
// 词
"w": "。",
// 词相对子句开始时刻，10ms。
"wb": 61,
"wc": 0.0,
// 词相对子句结束时刻，10ms。
"we": 61,
// 词语的属性，其中n表示正常词、s表示顺滑、p表示标点、g表示分段。
"wp": "p"
}
]
},
{
"bg": 61,
"cw": [
{
"rl": 0,
"sc": 0.0,
"w": "你好",
"wb": 61,
"wc": 0.0,
"we": 112,
"wp": "s"
}
]
}
]
}
},
// 业务上下文id，唯一标识一路完整会话(包括重连成功的请求)。
"context_id": "ZHhpc3QIIKwVpJc3cuhGrtbTFj2t"
}
```
### its_result [#its_result-1]
value 包含的参数及含义详见以下代码注释：
```json
{
// 错误码，0标识成功。
"code": 0,
// 错误描述
"message": "success",
// 每次会话的唯一标识
"sid": "its000825bc@dx17efb57b09ba11d902",
// 翻译数据
"data": {
// 结果
"result": {
// 源语种
"from": "cn",
// 目标语种
"to": "en",
// 翻译结果
"trans_result": {
// 源文本
"src": "。你好你好",
// 目标文本
"dst": "。 Hello Hello"
}
}
},
// 语音转写结果序号
"ist_sn": 6
}
```
## 错误码 [#错误码-1]
### SDK 错误码 [#sdk-错误码-1]
| 错误码 | 说明 | 处理方式 |
| ---- | ----- | --------------------------------------------------------------------- |
| -101 | 未知 | 分析日志 |
| -102 | 内部 | 分析日志 |
| -103 | 无效参数 | 检查输入参数 |
| -104 | 无效参数键 | 检查输入参数键 |
| -105 | 无效参数值 | 检查输入参数值 |
| -106 | 状态 | 检查当前状态下调用是否合法，例如空闲时才能调用 `start_listening`，会话中才能调用 `flush_listening` 和 `stop_listening` |
| -107 | 繁忙 | 分析日志 |
| -108 | 内存不足 | 检查内存用量 |
| -109 | 网络 | 检查网络是否通畅 |
| 0 | 成功 | 无 |
### 常见错误码 [#常见错误码-1]
| 错误码 | 说明 | 处理方式 |
| ----- | ------------------------- | --------------------------------------------- |
| 10043 | 音频解码失败 | 请检查所传的音频是否与 `encoding` 字段描述的编码格式对应。 |
| 10139 | 参数错误 | 引擎编解码错误 |
| 10221 | 服务端没有可用连接 | 提交工单 |
| 10222 | 有服务端组件服务连接超时 | 提交工单 |
| 10223 | LB 找不到引擎节点 | 提交工单 |
| 10225 | 找不到 atmos | 提交工单 |
| 10317 | 版本非法 | 提交工单 |
| 11200 | 功能未授权或授权到期 | 提交工单申请权限 |
| 11201 | 日流控超限 | 额外需求请提交工单 |
| 11202 | 秒级流控超限 | 额外需求请提交工单 |
| 11203 | 并发流控超限 | 额外需求请提交工单 |
| 11204 | 组鉴权未通过，即组内所有功能均受限 | 如有需求请提交工单 |
| 10160 | 请求数据格式非法 | 检查请求数据是否是合法的 JSON |
| 10161 | Base64 解码失败 | 检查发送的数据是否使用 Base64 编码了 |
| 10163 | 参数校验失败 | 由客户端参数校验失败引起，客户端需要依据返回的 `message` 字段中的描述来更改请求参数 |
| 10200 | 读取数据超时 | 检查是否累计 10 s 未发送数据并且未关闭连接 |
| 10114 | 会话时间超时 | 会话时间超过了 60000 s，请控制会话时间，保持不超过 60000 s。 |
| 10313 | `app_id` 和 `api_key` 不匹配或者没有传 `app_id` | 检查请求参数 |
| 11503 | 服务内部响应数据错误 | 提交工单 |
| 11502 | 服务配置错误 | 提交工单 |
| 10118 | 服务端无法解析后端响应数据 | 提交工单 |
| 12000 | 用户发完数据没有收到结果 | — |
| 12001 | 用户没有正常发送完数据 | - |
| 99999 | 用户异常断开连接，或者会话超时断开连接 | — |
### 引擎通用错误码 [#引擎通用错误码-1]
| 错误码 | 说明 |
| ------ | ------------------------------------------- |
| 10003 | 无效操作 |
| 10004 | session 模式非法 |
| 10008 | 句柄错误（忽略） |
| 10009 | 输入数据非法 |
| 10010 | 授权不足 |
| 10019 | session 会话超时，请先自查客户端发包间隔时长 |
| 10101 | 引擎会话已结束（忽略） |
| 10300 | 排序缓冲区为空 |
| 10301 | 排序 channel 已关闭 |
| 10400 | pb 协议序列化错误 |
| 10401 | pb 协议反序列化错误 |
| 10500 | 内部同步错误 |
| 10600 | 事件异常错误 |
| 10700 | 引擎异常 |
### 文本翻译错误码 [#文本翻译错误码-1]
| 错误码 | 说明 | 处理方式 |
| ----- | -------- | --------------- |
| 10324 | Sid 生成失败 | 联系技术人员 |
| 10106 | 非法的参数 | 检查参数是否正确上传 |
| 10107 | 非法参数值 | 检查参数值是否在取值范围内 |
| 10109 | 非法的 data | 检查发送的文本是否合法 |
| 10114 | 超时 | 检查网络是否通畅 |
| 11210 | `app_id` 和 `api_key` 不匹配 | 检查 `app_id` 和 `api_key` 是否匹配 |
<_PlatformProcessedMarker close="true" />
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="web" />
除了声网 Web SDK 提供的插件相关方法以外，每个插件会根据具体功能提供独有的 API。本文介绍讯飞转写及翻译插件的独有 API。
## 方法 [#方法]
### setOptions [#setoptions]
```typescript
setOptions(common, ist, its, callback): void
```
设置插件功能相关参数。每个参数的详细解释如下。
#### common [#common]
鉴权配置对象。
```javascript
let common = {
// 分别传入购买和激活插件时从声网控制台获取的 appKey、appSecret、appId
apiKey: 'aaaaaaaaa',
apiSecret: 'bbbbbbb',
appId: '7777'
}
```
#### ist [#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` 的设置参考下表：
| 实时转写语种 | `language` | `accent` | `domain` | `language_type` |
| --- | --- | --- | --- | --- |
| 中英文混合 | `zh_cn` | `mandarin` | `ist_ed_open` | [iflytek-asr-api-javascript-html-0-1-4 details](#table-slot-iflytek-asr-api-javascript-html-0-1-4) |
| 德语 | `de_de` | `mandarin` | `ist_hy` | 无需设置 |
| 阿拉伯语 | `ar_il` | `mandarin` | `ist_open` | 无需设置 |
| 西班牙语 | `es_es` | `mandarin` | `ist_open` | 无需设置 |
| 法语 | `fr_fr` | `mandarin` | `ist_open` | 无需设置 |
| 意大利语 | `it_IT` | `mandarin` | `ist_open` | 无需设置 |
| 日语 | `ja_jp` | `mandarin` | `ist_open` | 无需设置 |
| 韩语 | `ko_kr` | `mandarin` | `ist_open` | 无需设置 |
| 俄语 | `ru_ru` | `mandarin` | `ist_open` | 无需设置 |
| 泰语 | `th_TH` | `mandarin` | `ist_open` | 无需设置 |
| 越南语 | `vi_vn` | `mandarin` | `ist_open` | 无需设置 |
| 粤语 | `zh_cn` | `cantonese` | `ist_open` | 无需设置 |
| 西南官话（包含四川、重庆、云南、贵州） | `zh_cn` | `xinanese` | `ist_open` | 无需设置 |
| 河南话 | `zh_cn` | `henanese` | `ist_open` | 无需设置 |
| 印尼语 | `id_id` | `mandarin` | `ist_hy` | 无需设置 |
**iflytek-asr-api-javascript-html-0-1-4 details**
语言过滤筛选：
- `1`：（默认）中英文模式，中文英文均可识别
- `2`：中文模式，可识别出简单英文
- `3`：英文模式，只能识别出英文
- `4`：纯中文模式，只能识别出中文
文本翻译支持的源语 `from` 和目标语 `to` 如下：
中文与其它语种互译
英语与其他语种互译
| 语种 | 参数 |
| --- | --- |
| 中文 | `cn` |
| 英语 | `en` |
| 日语 | `ja` |
| 韩语 | `ko` |
| 泰语 | `th` |
| 斯拉夫语系 | [iflytek-asr-api-javascript-html-1-6-1 details](#table-slot-iflytek-asr-api-javascript-html-1-6-1) |
| 越系 | [iflytek-asr-api-javascript-html-1-7-1 details](#table-slot-iflytek-asr-api-javascript-html-1-7-1) |
| 印欧语系 | [iflytek-asr-api-javascript-html-1-8-1 details](#table-slot-iflytek-asr-api-javascript-html-1-8-1) |
| 阿拉伯语系 | [iflytek-asr-api-javascript-html-1-9-1 details](#table-slot-iflytek-asr-api-javascript-html-1-9-1) |
| 印地语系 | [iflytek-asr-api-javascript-html-1-10-1 details](#table-slot-iflytek-asr-api-javascript-html-1-10-1) |
| 外蒙哈系 | [iflytek-asr-api-javascript-html-1-11-1 details](#table-slot-iflytek-asr-api-javascript-html-1-11-1) |
| 突厥语系 | [iflytek-asr-api-javascript-html-1-12-1 details](#table-slot-iflytek-asr-api-javascript-html-1-12-1) |
| 希腊语系 | [iflytek-asr-api-javascript-html-1-13-1 details](#table-slot-iflytek-asr-api-javascript-html-1-13-1) |
| 维语 | `ug` |
| 藏语 | `za` |
| 粤语 | `yue` |
| 彝语 | `ii` |
| 壮语 | `zua` |
| 内蒙语 | `mn` |
| 内哈萨克语 | `kka` |
| 方言系 | [iflytek-asr-api-javascript-html-1-21-1 details](#table-slot-iflytek-asr-api-javascript-html-1-21-1) |
| 南非荷兰语 | `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` |
**iflytek-asr-api-javascript-html-1-6-1 details**
- 俄语 `ru`
- 保加利亚语 `bg`
- 乌克兰语 `uk`
**iflytek-asr-api-javascript-html-1-7-1 details**
- 越南语 `vi`
- 马来语 `ms`
- 印尼语 `id`
- 菲律宾语 `tl`
**iflytek-asr-api-javascript-html-1-8-1 details**
- 德语 `de`
- 西班牙语 `es`
- 法语 `fr`
- 意大利语 `it`
- 葡萄牙语 `pt`
- 捷克语 `cs`
- 罗马尼亚语 `ro`
- 瑞典语 `sv`
- 荷兰语 `nl`
- 波兰语 `pl`
**iflytek-asr-api-javascript-html-1-9-1 details**
- 阿拉伯语 `ar`
- 波斯语 `fa`
- 普什图语 `ps`
- 乌尔都语 `ur`
**iflytek-asr-api-javascript-html-1-10-1 details**
- 印地语 `hi`
- 孟加拉语 `bn`
**iflytek-asr-api-javascript-html-1-11-1 details**
- 外蒙语-西里尔 `nm`
- 外哈语 `kk`
**iflytek-asr-api-javascript-html-1-12-1 details**
- 土耳其语 `tr`
- 阿塞拜疆语 `az`
- 芬兰语 `fi`
- 豪莎语 `ha`
- 匈牙利语 `hu`
- 斯瓦西里语 `sw`
- 乌兹别克语 `uz`
- 祖鲁语 `zu`
**iflytek-asr-api-javascript-html-1-13-1 details**
- 希腊语 `el`
- 希伯来语 `he`
- 亚美尼亚语 `hy`
- 格鲁吉亚语 `ka`
**iflytek-asr-api-javascript-html-1-21-1 details**
- 东北话 `dbiu`
- 山东话 `jlua`
- 四川话 `suji`
- 上海话 `xghu`
- 武汉话 `hbwh`
- 河南话 `hena`
- 长沙话 `hncs`
- 南京话 `jsnj`
| 互译语种 | 参数 |
| --- | --- |
| 英日互译 | [iflytek-asr-api-javascript-html-2-1-1 details](#table-slot-iflytek-asr-api-javascript-html-2-1-1) |
| 英韩互译 | [iflytek-asr-api-javascript-html-2-2-1 details](#table-slot-iflytek-asr-api-javascript-html-2-2-1) |
| 英俄互译 | [iflytek-asr-api-javascript-html-2-3-1 details](#table-slot-iflytek-asr-api-javascript-html-2-3-1) |
| 英西互译 | [iflytek-asr-api-javascript-html-2-4-1 details](#table-slot-iflytek-asr-api-javascript-html-2-4-1) |
| 英法互译 | [iflytek-asr-api-javascript-html-2-5-1 details](#table-slot-iflytek-asr-api-javascript-html-2-5-1) |
| 英粤互译 | [iflytek-asr-api-javascript-html-2-6-1 details](#table-slot-iflytek-asr-api-javascript-html-2-6-1) |
**iflytek-asr-api-javascript-html-2-1-1 details**
- 英语 `en`
- 日语 `ja`
**iflytek-asr-api-javascript-html-2-2-1 details**
- 英语 `en`
- 韩语 `ko`
**iflytek-asr-api-javascript-html-2-3-1 details**
- 英语 `en`
- 俄语 `ru`
**iflytek-asr-api-javascript-html-2-4-1 details**
- 英语 `en`
- 西班牙语 `es`
**iflytek-asr-api-javascript-html-2-5-1 details**
- 英语 `en`
- 法语 `fr`
**iflytek-asr-api-javascript-html-2-6-1 details**
- 英语 `en`
- 粤语 `yue`
#### its [#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 [#callback]
回调函数。该函数接收的对象包含 `key` 和 `value` 两个属性。
对应的 value 示例如下：
```json
{
// 错误码
"code":(int),
// 提示
"message":(string)
}
```
对应的 value 示例如下：
```json
{
// 错误码，0标识成功。
"code":(int),
// 错误描述
"message":(string),
// 每次会话的唯一标识
"sid":(string),
// 识别数据
"data":{
// 识别结果是否结束标识：1：识别中；2：识别结束。
"status":(int),
// 识别结果
"result":{
// 返回结果的序号
"sn":(int),
// 是否是最后一片结果
"ls":(bool),
// 子句开始时刻，ms。
"bg":(long),
// 子句结束时刻，ms。
"ed":(long),
// 开启wpgs会有此字段，取值为 "apd"时表示该片结果是追加到前面的最终结果，取值为"rpl" 时表示替换前面的部分结果，替换范围为rg字段。
"pgs":(string),
// 替换范围，开启wpgs会有该字段。
"rg":(array),
// 是否子句结束
"sub_end":(bool),
// 词组
"ws":[
{
// 词相对子句开始时刻，10ms。
"bg":(long),
// 词多候选组
"cw":[
{
"rl":0,
// 分数
"sc":(double),
// 词
"w":(string),
// 词相对子句开始时刻，10ms。
"wb":(long),
"wc":0.00,
// 词相对子句结束时刻，10ms。
"we":(long),
// 词语的属性，其中n表示正常词、s表示顺滑、p表示标点、g表示分段。
"wp":(string)
}
]
},
...
]
}
},
// 业务上下文id，唯一标识一路完整会话(包括重连成功的请求)。
"context_id":(string)
}
```
对应的 value 示例如下：
```json
{
// 错误码，0标识成功。
"code":(int),
// 错误描述
"message":(string),
// 每次会话的唯一标识
"sid":(string),
// 翻译数据
"data":{
// 结果
"result":{
// 源语种
"from":(string),
// 目标语种
"to":(string),
// 翻译结果
"trans_result":{
// 源文本
"src":(string),
// 目标文本
"dst":(string)
}
}
},
// 语音转写结果序号
"ist_sn":(int)
}
```
### enable [#enable]
```typescript
enable(): void | Promise;
```
开启插件。
该方法必须在 `setOptions` 之后调用。调用该方法后，如果 10 s 内无音频输入，会自动停止识别。你可以重复调用该方法。
### disable [#disable]
```typescript
disable(): void | Promise;
```
关闭插件。
## 错误码 [#错误码-2]
### 通用错误码 [#通用错误码]
| 错误码 | 说明 | 处理方式 |
| ---- | ----- | --------------------------------------------------------------------- |
| -101 | 未知 | 分析日志 |
| -102 | 翻译请求错误 | 分析 error 日志，并检查参数配置或网络 |
| -103 | 翻译请求失败 | 依据 `statusCode` 分析，通常为跨域问题，请配置反向代理等方式解决跨域问题 |
| -104 | 语音识别失败 | 一般为网络连接问题，检查网络、本地时间、以及浏览器是否允许使用 WSS 协议 |
| 0 | 成功 | 无 |
### 语音识别错误码 [#语音识别错误码]
| 错误码 | 说明 | 处理方式 |
| ----- | ------------------------- | --------------------------------------------- |
| 10043 | 音频解码失败 | 请检查所传的音频是否与 `encoding` 字段描述的编码格式对应 |
| 10139 | 参数错误 | 引擎编解码错误 |
| 10221 | 服务端没有可用连接 | 提交工单 |
| 10222 | 有服务端组件服务连接超时 | 提交工单 |
| 10223 | LB 找不到引擎节点 | 提交工单 |
| 10225 | 找不到 atmos | 提交工单 |
| 10317 | 版本非法 | 提交工单 |
| 11200 | 功能未授权或授权到期 | 提交工单申请权限 |
| 11201 | 日流控超限 | 额外需求请提交工单 |
| 11202 | 秒级流控超限 | 额外需求请提交工单 |
| 11203 | 并发流控超限 | 额外需求请提交工单 |
| 11204 | 组鉴权未通过，即组内所有功能均受限 | 如有需求请提交工单 |
| 10160 | 请求数据格式非法 | 检查请求数据是否是合法的 JSON |
| 10161 | Base64 解码失败 | 检查发送的数据是否使用 Base64 编码了 |
| 10163 | 参数校验失败 | 由客户端参数校验失败引起，客户端需要依据返回的 `message` 字段中的描述来更改请求参数 |
| 10200 | 读取数据超时 | 检查是否累计 10 s 未发送数据并且未关闭连接 |
| 10114 | 会话时间超时 | 会话时间超过了 60000 s，请控制会话时间，保持不超过 60000 s |
| 10313 | `appId` 和 `apiKey` 不匹配或者没有传 `appId` | 检查请求参数 |
| 11503 | 服务内部响应数据错误 | 提交工单 |
| 11502 | 服务配置错误 | 提交工单 |
| 10118 | 服务端无法解析后端响应数据 | 提交工单 |
| 12000 | 用户发完数据没有收到结果 | - |
| 12001 | 用户没有正常发送完数据 | - |
| 99999 | 用户异常断开连接，或者会话超时断开连接 | - |
### 机器翻译错误码 [#机器翻译错误码]
| 错误码 | 说明 | 处理方式 |
| ----- | -------- | --------------- |
| 10324 | Sid 生成失败 | 联系技术人员 |
| 10106 | 非法的参数 | 检查参数是否正确上传 |
| 10107 | 非法参数值 | 检查参数值是否在取值范围内 |
| 10109 | 非法的 data | 检查发送的文本是否合法 |
| 10114 | 超时 | 检查网络是否通畅 |
| 11210 | `appId` 和 `apiKey` 不匹配 | 检查 `appId` 和 `apiKey` 是否匹配 |
<_PlatformProcessedMarker close="true" />
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="web" platform="windows" />
在声网 SDK 提供的插件相关方法和回调中，`key` 和 `value` 参数取决于你使用的插件。本页提供讯飞转写及翻译插件支持的 `key` 和 `value` 说明。
## 插件的 key 概览 [#插件的-key-概览-2]
### 方法 key [#方法-key-2]
本节列出调用声网 SDK 的插件相关方法时，支持传入的 `key` 及对应功能。
| setExtensionProperty 方法的 key| 描述 |
| ------------------------------------ | -------- |
| [`start_listening`](#start_listening-2) | 启动倾听 |
| [`flush_listening`](#flush_listening-2) | 结束音频获取结果 |
| [`stop_listening`](#stop_listening-2) | 停止倾听 |
| setExtensionProviderProperty 方法的 key| 描述 |
| ------------------------------------ | -------- |
| [`log_lv`](#log_lv-2) | 设置日志等级 |
### 回调 key [#回调-key-2]
本节列出声网 SDK 的 `onEvent` 回调返回的 `key`。
| onEvent 回调的 key| 描述 |
| ------------------------------------ | -------- |
| [`error`](#error-2) | 错误类型 |
| [`ist_result`](#ist_result-2) | 语音转写结果 |
| [`its_result`](#its_result-2) | 文本翻译结果 |
| [`end`](#回调-key-2) | 会话结束的最后事件 |
## 方法 key 的 value 说明 [#方法-key-的-value-说明-2]
### start_listening [#start_listening-2]
value 包含的参数及含义详见以下代码注释：
```json
{
// 公共对象。必选。
"common": {
// 应用标识。必选。
"app_id": "aaa",
// API key。必选。
"api_key": "bbb",
// API secret。必选。
"api_secret": "ccc"
},
// 语音转写对象。必选。
"ist": {
// URI。必选。
"uri": "wss://ist-api.xfyun.cn/v2/ist",
// 请求对象。必选。
"req": {
// 业务对象。必选。
"business": {
// 语种。必选。中译英："zh_cn"；英译中："zh_cn"。
"language": "zh_cn",
// 口音。必选。中译英："mandarin"；英译中："mandarin"。
"accent": "mandarin",
// 领域。必选。中译英："ist_ed_open"；英译中："ist_ed_open"。
"domain": "ist_ed_open",
// 语言类型（Int）。
// 1：（默认）中英文模式，中文英文均可识别。中译英设为 1。
// 3：英文模式，只识别出英文。英译中设为 3。
"language_type": 1,
// 动态修正。
"dwa": "wpgs"
},
"data": {
// 音频数据格式，raw 表示原生音频。
"encoding": "raw"
}
}
},
// 文本翻译对象。
"its": {
// URI。必选。
"uri": "https://itrans.xfyun.cn/v2/its",
// 请求对象。必选。
"req": {
// 业务对象。必选。
"business": {
// 源语种。必选。中译英："cn"；英译中："en"。
"from": "cn",
// 目标语种。必选。中译英："en"；英译中："cn"。
"to": "en"
}
}
}
}
```
其中，语音转写支持的语种所对应的 `language`、`accent`、`domain` 和 `language_type` 的设置参考下表：
| 实时转写语种 | `language` | `accent` | `domain` | `language_type` |
| --- | --- | --- | --- | --- |
| 中英文混合 | `zh_cn` | `mandarin` | `ist_ed_open` | [iflytek-asr-api-android-ios-windows-html-0-1-4 details](#table-slot-iflytek-asr-api-android-ios-windows-html-0-1-4-2) |
| 德语 | `de_de` | `mandarin` | `ist_hy` | 无需设置 |
| 阿拉伯语 | `ar_il` | `mandarin` | `ist_open` | 无需设置 |
| 西班牙语 | `es_es` | `mandarin` | `ist_open` | 无需设置 |
| 法语 | `fr_fr` | `mandarin` | `ist_open` | 无需设置 |
| 意大利语 | `it_IT` | `mandarin` | `ist_open` | 无需设置 |
| 日语 | `ja_jp` | `mandarin` | `ist_open` | 无需设置 |
| 韩语 | `ko_kr` | `mandarin` | `ist_open` | 无需设置 |
| 俄语 | `ru_ru` | `mandarin` | `ist_open` | 无需设置 |
| 泰语 | `th_TH` | `mandarin` | `ist_open` | 无需设置 |
| 越南语 | `vi_vn` | `mandarin` | `ist_open` | 无需设置 |
| 粤语 | `zh_cn` | `cantonese` | `ist_open` | 无需设置 |
| 西南官话（包含四川、重庆、云南、贵州） | `zh_cn` | `xinanese` | `ist_open` | 无需设置 |
| 河南话 | `zh_cn` | `henanese` | `ist_open` | 无需设置 |
| 印尼语 | `id_id` | `mandarin` | `ist_hy` | 无需设置 |
**iflytek-asr-api-android-ios-windows-html-0-1-4 details**
语言过滤筛选：
- `1`：（默认）中英文模式，中文英文均可识别
- `2`：中文模式，可识别出简单英文
- `3`：英文模式，只能识别出英文
- `4`：纯中文模式，只能识别出中文
文本翻译支持的源语 `from` 和目标语 `to` 如下：
中文与其它语种互译
英语与其他语种互译
| 语种 | 参数 |
| --- | --- |
| 中文 | `cn` |
| 英语 | `en` |
| 日语 | `ja` |
| 韩语 | `ko` |
| 泰语 | `th` |
| 斯拉夫语系 | [iflytek-asr-api-android-ios-windows-html-1-6-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-6-1-2) |
| 越系 | [iflytek-asr-api-android-ios-windows-html-1-7-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-7-1-2) |
| 印欧语系 | [iflytek-asr-api-android-ios-windows-html-1-8-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-8-1-2) |
| 阿拉伯语系 | [iflytek-asr-api-android-ios-windows-html-1-9-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-9-1-2) |
| 印地语系 | [iflytek-asr-api-android-ios-windows-html-1-10-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-10-1-2) |
| 外蒙哈系 | [iflytek-asr-api-android-ios-windows-html-1-11-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-11-1-2) |
| 突厥语系 | [iflytek-asr-api-android-ios-windows-html-1-12-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-12-1-2) |
| 希腊语系 | [iflytek-asr-api-android-ios-windows-html-1-13-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-13-1-2) |
| 维语 | `ug` |
| 藏语 | `za` |
| 粤语 | `yue` |
| 彝语 | `ii` |
| 壮语 | `zua` |
| 内蒙语 | `mn` |
| 内哈萨克语 | `kka` |
| 方言系 | [iflytek-asr-api-android-ios-windows-html-1-21-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-1-21-1-2) |
| 南非荷兰语 | `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` |
**iflytek-asr-api-android-ios-windows-html-1-6-1 details**
- 俄语 `ru`
- 保加利亚语 `bg`
- 乌克兰语 `uk`
**iflytek-asr-api-android-ios-windows-html-1-7-1 details**
- 越南语 `vi`
- 马来语 `ms`
- 印尼语 `id`
- 菲律宾语 `tl`
**iflytek-asr-api-android-ios-windows-html-1-8-1 details**
- 德语 `de`
- 西班牙语 `es`
- 法语 `fr`
- 意大利语 `it`
- 葡萄牙语 `pt`
- 捷克语 `cs`
- 罗马尼亚语 `ro`
- 瑞典语 `sv`
- 荷兰语 `nl`
- 波兰语 `pl`
**iflytek-asr-api-android-ios-windows-html-1-9-1 details**
- 阿拉伯语 `ar`
- 波斯语 `fa`
- 普什图语 `ps`
- 乌尔都语 `ur`
**iflytek-asr-api-android-ios-windows-html-1-10-1 details**
- 印地语 `hi`
- 孟加拉语 `bn`
**iflytek-asr-api-android-ios-windows-html-1-11-1 details**
- 外蒙语-西里尔 `nm`
- 外哈语 `kk`
**iflytek-asr-api-android-ios-windows-html-1-12-1 details**
- 土耳其语 `tr`
- 阿塞拜疆语 `az`
- 芬兰语 `fi`
- 豪莎语 `ha`
- 匈牙利语 `hu`
- 斯瓦西里语 `sw`
- 乌兹别克语 `uz`
- 祖鲁语 `zu`
**iflytek-asr-api-android-ios-windows-html-1-13-1 details**
- 希腊语 `el`
- 希伯来语 `he`
- 亚美尼亚语 `hy`
- 格鲁吉亚语 `ka`
**iflytek-asr-api-android-ios-windows-html-1-21-1 details**
- 东北话 `dbiu`
- 山东话 `jlua`
- 四川话 `suji`
- 上海话 `xghu`
- 武汉话 `hbwh`
- 河南话 `hena`
- 长沙话 `hncs`
- 南京话 `jsnj`
| 互译语种 | 参数 |
| --- | --- |
| 英日互译 | [iflytek-asr-api-android-ios-windows-html-2-1-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-1-1-2) |
| 英韩互译 | [iflytek-asr-api-android-ios-windows-html-2-2-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-2-1-2) |
| 英俄互译 | [iflytek-asr-api-android-ios-windows-html-2-3-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-3-1-2) |
| 英西互译 | [iflytek-asr-api-android-ios-windows-html-2-4-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-4-1-2) |
| 英法互译 | [iflytek-asr-api-android-ios-windows-html-2-5-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-5-1-2) |
| 英粤互译 | [iflytek-asr-api-android-ios-windows-html-2-6-1 details](#table-slot-iflytek-asr-api-android-ios-windows-html-2-6-1-2) |
**iflytek-asr-api-android-ios-windows-html-2-1-1 details**
- 英语 `en`
- 日语 `ja`
**iflytek-asr-api-android-ios-windows-html-2-2-1 details**
- 英语 `en`
- 韩语 `ko`
**iflytek-asr-api-android-ios-windows-html-2-3-1 details**
- 英语 `en`
- 俄语 `ru`
**iflytek-asr-api-android-ios-windows-html-2-4-1 details**
- 英语 `en`
- 西班牙语 `es`
**iflytek-asr-api-android-ios-windows-html-2-5-1 details**
- 英语 `en`
- 法语 `fr`
**iflytek-asr-api-android-ios-windows-html-2-6-1 details**
- 英语 `en`
- 粤语 `yue`
### flush_listening [#flush_listening-2]
无 value 参数。
### stop_listening [#stop_listening-2]
无 value 参数。
### log_lv [#log_lv-2]
value 参数为 Int 型，支持设为以下值：
- 0（默认）：LOG_LVL_UNKNOWN
- 1：LOG_LVL_DEFAULT
- 2：LOG_LVL_VERBOSE
- 3：LOG_LVL_DEBUG
- 4：LOG_LVL_INFO
- 5：LOG_LVL_WARN
- 6：LOG_LVL_ERROR
- 7：LOG_LVL_FATAL
- 8：LOG_LVL_SILENT
## 回调 key 的 value 说明 [#回调-key-的-value-说明-2]
### error [#error-2]
`value` 包含以下参数：
| value 参数| 描述 |
| ----------- | ---------------------- |
| `err_code`| Int 型，[错误码](#错误码-3)。|
| `tip`| String 型，提示内容。 |
### ist_result [#ist_result-2]
value 包含的参数及含义详见以下代码注释：
```json
{
// 错误码，0标识成功。
"code": 0,
// 错误描述
"message": "success",
// 每次会话的唯一标识
"sid": "ist000d6ed7@dx17efb57a7faa497822",
// 识别数据
"data": {
// 识别结果是否结束标识：1：识别中；2：识别结束。
"status": 1,
// 识别结果
"result": {
// 返回结果的序号
"sn": 6,
// 是否是最后一片结果
"ls": false,
// 子句开始时刻，ms。
"bg": 1810,
// 子句结束时刻，ms。
"ed": 3840,
// 开启 wpgs 会有此字段，取值为 "apd"时表示该片结果是追加到前面的最终结果，取值为"rpl" 时表示替换前面的部分结果，替换范围为rg字段。
"pgs": "rpl",
// 替换范围，开启wpgs会有该字段。
"rg": [3, 5],
// 是否子句结束
"sub_end": true,
// 词组
"ws": [
{
// 词相对子句开始时刻，10ms。
"bg": 61,
// 词多候选组
"cw": [
{
"rl": 0,
// 分数
"sc": 0.0,
// 词
"w": "。",
// 词相对子句开始时刻，10ms。
"wb": 61,
"wc": 0.0,
// 词相对子句结束时刻，10ms。
"we": 61,
// 词语的属性，其中n表示正常词、s表示顺滑、p表示标点、g表示分段。
"wp": "p"
}
]
},
{
"bg": 61,
"cw": [
{
"rl": 0,
"sc": 0.0,
"w": "你好",
"wb": 61,
"wc": 0.0,
"we": 112,
"wp": "s"
}
]
}
]
}
},
// 业务上下文id，唯一标识一路完整会话(包括重连成功的请求)。
"context_id": "ZHhpc3QIIKwVpJc3cuhGrtbTFj2t"
}
```
### its_result [#its_result-2]
value 包含的参数及含义详见以下代码注释：
```json
{
// 错误码，0标识成功。
"code": 0,
// 错误描述
"message": "success",
// 每次会话的唯一标识
"sid": "its000825bc@dx17efb57b09ba11d902",
// 翻译数据
"data": {
// 结果
"result": {
// 源语种
"from": "cn",
// 目标语种
"to": "en",
// 翻译结果
"trans_result": {
// 源文本
"src": "。你好你好",
// 目标文本
"dst": "。 Hello Hello"
}
}
},
// 语音转写结果序号
"ist_sn": 6
}
```
## 错误码 [#错误码-3]
### SDK 错误码 [#sdk-错误码-2]
| 错误码 | 说明 | 处理方式 |
| ---- | ----- | --------------------------------------------------------------------- |
| -101 | 未知 | 分析日志 |
| -102 | 内部 | 分析日志 |
| -103 | 无效参数 | 检查输入参数 |
| -104 | 无效参数键 | 检查输入参数键 |
| -105 | 无效参数值 | 检查输入参数值 |
| -106 | 状态 | 检查当前状态下调用是否合法，例如空闲时才能调用 `start_listening`，会话中才能调用 `flush_listening` 和 `stop_listening` |
| -107 | 繁忙 | 分析日志 |
| -108 | 内存不足 | 检查内存用量 |
| -109 | 网络 | 检查网络是否通畅 |
| 0 | 成功 | 无 |
### 常见错误码 [#常见错误码-2]
| 错误码 | 说明 | 处理方式 |
| ----- | ------------------------- | --------------------------------------------- |
| 10043 | 音频解码失败 | 请检查所传的音频是否与 `encoding` 字段描述的编码格式对应。 |
| 10139 | 参数错误 | 引擎编解码错误 |
| 10221 | 服务端没有可用连接 | 提交工单 |
| 10222 | 有服务端组件服务连接超时 | 提交工单 |
| 10223 | LB 找不到引擎节点 | 提交工单 |
| 10225 | 找不到 atmos | 提交工单 |
| 10317 | 版本非法 | 提交工单 |
| 11200 | 功能未授权或授权到期 | 提交工单申请权限 |
| 11201 | 日流控超限 | 额外需求请提交工单 |
| 11202 | 秒级流控超限 | 额外需求请提交工单 |
| 11203 | 并发流控超限 | 额外需求请提交工单 |
| 11204 | 组鉴权未通过，即组内所有功能均受限 | 如有需求请提交工单 |
| 10160 | 请求数据格式非法 | 检查请求数据是否是合法的 JSON |
| 10161 | Base64 解码失败 | 检查发送的数据是否使用 Base64 编码了 |
| 10163 | 参数校验失败 | 由客户端参数校验失败引起，客户端需要依据返回的 `message` 字段中的描述来更改请求参数 |
| 10200 | 读取数据超时 | 检查是否累计 10 s 未发送数据并且未关闭连接 |
| 10114 | 会话时间超时 | 会话时间超过了 60000 s，请控制会话时间，保持不超过 60000 s。 |
| 10313 | `app_id` 和 `api_key` 不匹配或者没有传 `app_id` | 检查请求参数 |
| 11503 | 服务内部响应数据错误 | 提交工单 |
| 11502 | 服务配置错误 | 提交工单 |
| 10118 | 服务端无法解析后端响应数据 | 提交工单 |
| 12000 | 用户发完数据没有收到结果 | — |
| 12001 | 用户没有正常发送完数据 | - |
| 99999 | 用户异常断开连接，或者会话超时断开连接 | — |
### 引擎通用错误码 [#引擎通用错误码-2]
| 错误码 | 说明 |
| ------ | ------------------------------------------- |
| 10003 | 无效操作 |
| 10004 | session 模式非法 |
| 10008 | 句柄错误（忽略） |
| 10009 | 输入数据非法 |
| 10010 | 授权不足 |
| 10019 | session 会话超时，请先自查客户端发包间隔时长 |
| 10101 | 引擎会话已结束（忽略） |
| 10300 | 排序缓冲区为空 |
| 10301 | 排序 channel 已关闭 |
| 10400 | pb 协议序列化错误 |
| 10401 | pb 协议反序列化错误 |
| 10500 | 内部同步错误 |
| 10600 | 事件异常错误 |
| 10700 | 引擎异常 |
### 文本翻译错误码 [#文本翻译错误码-2]
| 错误码 | 说明 | 处理方式 |
| ----- | -------- | --------------- |
| 10324 | Sid 生成失败 | 联系技术人员 |
| 10106 | 非法的参数 | 检查参数是否正确上传 |
| 10107 | 非法参数值 | 检查参数值是否在取值范围内 |
| 10109 | 非法的 data | 检查发送的文本是否合法 |
| 10114 | 超时 | 检查网络是否通畅 |
| 11210 | `app_id` 和 `api_key` 不匹配 | 检查 `app_id` 和 `api_key` 是否匹配 |
<_PlatformProcessedMarker close="true" />