介绍通过 AOQ 接入 Qwen-Audio-ASR-Message 的鉴权、媒体配置、建连和任务事件处理流程。
通过 AOQ 接入 Qwen-Audio-ASR-Message 时,客户端通过 Audio 轨上传音频,通过 Data 轨发送任务事件并接收识别结果。
在 AppServer 设置环境变量
若使用 Token Plan,接入域名中的
用
等待
将以下 JSON 序列化为 UTF-8,写入
在
从
录音结束后,停止采集新的音频,等待待发送的音频送出。调用
不再使用连接时,依次调用
准备工作
- 使用
qwen-audio-3.1-asr-flash-message。具体支持范围参见模型与协议支持范围。 - 在业务 AppServer 配置与业务空间匹配的 API Key。
- 从SDK 下载导入对应平台的 AOQ SDK。下文以 Android Java 和 Opus 传输为例,请同时导入 Opus 插件。使用麦克风采集时,请在客户端申请录音权限。
1. 获取连接凭证
如需提前获取 Token,或了解完整的鉴权流程,请参见建连鉴权详解。
DASHSCOPE_API_KEY,用千问AI平台的接入域名替换 {endpoint}。Qwen-Audio-ASR-Message 使用 Inference 建连路径,以下以 qwen-audio-3.1-asr-flash-message 为例。
WorkspaceId 固定为 token-plan。请求体中的 clientIp 可选,填写客户端真实公网 IP,供网关选择 Relay 接入点。未填写时,网关使用请求来源 IP。
API Key 仅保存在 AppServer。AppServer 将下表中的连接参数返回客户端,响应中的 sidExpiresInSecs 表示会话有效期,单位为秒。
| 网关响应字段 | AoqConnectConfig 字段 |
|---|---|
aoqTokenForClient | token |
sid | sid |
clientRelayCertFingerprint | certFingerprint |
clientRelayEndpoints | relayEndpoints,逐项转换 endpoint、port 和 route_index |
extraInfo.workspaceIdHash | workspaceIdHash |
2. 初始化 SDK 并建连
用 AoqCreateConfig 设置 SDK 工作目录,调用 AoqClientEngine.createEngine 创建引擎并注册回调。在 onConnectionStatusChange 中处理连接状态,在 onDataMsg 中解析模型事件,在 onError 中处理 SDK 错误。Android SDK提供引擎初始化和连接字段的完整接口说明。
将 AppServer 返回的凭证填入 connectConfig 后,发布 Audio 和 Data 轨,订阅 Data 轨。下例设置 16 kHz 单声道 Opus 编码和内置采集,建连时关闭 Audio 轨发送。模型的输入格式由任务事件指定,SDK 编码配置用于媒体轨传输。
onConnectionStatusChange 返回 AoqConnectionStatusConnected 后再启动任务。连接异常时清理本地任务状态,重新建连需要获取新的连接凭证。
3. 启动识别任务并处理事件
将以下 JSON 序列化为 UTF-8,写入 AoqDataMsg.data,再用 sendDataMsg 通过 Data 轨发送。每个任务生成新的 task_id,本轮的所有事件使用同一个值。
onDataMsg 中读取 header.event。收到 task-started 后才允许上行音频。
result-generated 的 payload.output.sentence 中读取识别文本,并跳过 heartbeat=true 的心跳。默认返回句子最终文本。若在 run-task 中设置 intermediate_result_enabled=true,还会返回可修订的中间文本。按 sentence_id 更新同一句的文本。收到 task-failed 时,停止本轮上行并读取 header.error_code 和 header.error_message。
任务参数与事件字段参见客户端事件和服务端事件。
4. 结束任务并释放资源
录音结束后,停止采集新的音频,等待待发送的音频送出。调用 enableSendMediaStream 关闭 Audio 轨上行,再通过 Data 轨发送 finish-task。保持连接,接收剩余识别结果并等待 task-finished。
stopAudioCapture、disconnect 和 AoqClientEngine.destroy 释放资源。