1. 回调说明
录音识别请求中，如果用户设置了 CallbackUrl 参数，则通过回调的方式来返回识别结果，用户需要自行搭建可公网访问的 HTTP 或者 HTTPS 服务，并在创建录音识别任务时，将回调 Url 填写到 CallbackUrl 中。回调时，会使用 HTTP 的 POST 方法，将所有内容会放入 Body 中，Content-Type 为 application/x-www-form-urlencoded。
2. 回调 Body 说明
2.1 回调 Body 示例
code=0&requestId=4000048858&appid=12516&projectid=0&text=%5B0%3A1.640%2C0%3A4.600%5D++%E6%88%91%E5%9C%A8%E9%A9%AC%E4%B8%8A%E4%B8%8A%E5%A4%9C%E7%8F%AD%E3%80%82%0A%5B0%3A5.420%2C0%3A7.820%5D++%E6%98%8E%E5%A4%A9%E6%97%A9%E4%B8%8A%E8%AF%B4%E5%93%88%E3%80%82%0A&audioTime=8.420000&message=&resultDetail=2.2 回调参数说明
| 字段 | 类型 | 描述 |
|---|---|---|
| code | int64 | 任务状态码，0为成功，其他：失败；详见 状态码说明 |
| message | string | 失败原因文字描述，成功时此值为空 |
| requestId | uint64 | 任务唯一标识，与录音识别请求中返回的 TaskId 一致。数据格式必须设置为 Uint64 |
| appid | uint64 | 腾讯云应用 ID |
| projectid | int64 | 腾讯云项目 ID |
| audioUrl | string | 语音 url，如创建任务时为上传数据的方式，则不包含该字段 |
| text | string | 识别出的结果文本 |
| resultDetail | string | 包含 详细识别结果，如创建任务时 ResTextFormat 为0，则不包含该字段 |
| audioTime | double | 语音总时长 |
3. 回调 Response 说明
用户侧收到回调请求后，需要以 JSON 格式返回响应。
3.1 回调 Response 示例
{ "code" : 0, "message" : "success" }3.2 回调 Response 参数说明
| 参数名称 | 类型 | 描述 |
|---|---|---|
| code | int64 | 错误码，0为成功，其他值代表失败 |
| message | string | 失败原因说明 |
4. 回调状态码
| 数值 | 说明 |
|---|---|
| 10000 | 转码失败，请确认音频格式是否符合标准 |
| 10001 | 识别失败 |
| 10002 | 语音时长太短 |
| 10003 | 语音时长太长 |
| 10004 | 无效的语音文件 |
| 10005 | 其他失败 |
| 10006 | 音轨个数不匹配 |
| 10007 | 音频下载失败 |
5. 常见问题
5.1 回调最多尝试几次？
最多2次。
5.2 过了很久都没有收到回调怎么办？
- 请确认回调服务正常，且回调地址是否在公网下可访问。
- 如果回调地址是 https 的，请确认证书经过合法 CA 机构认证。
