下发语音

since 4.0.19

POST /v1/stream/voice/upload

立即返回任务对象（含 taskId）。调度、播放、Kafka 结果在后台完成。

• 优先级 0–2，缺省 0；越界拒绝。
• guid 不强制；不传则 Kafka guid 为 null。
• 排队 (priority DESC, reqTm ASC)；同 simNo 串行；不抢占。
• 人工对讲占用 → Kafka result=2，不踢人。
• 超时从 tm 起算，默认 30 秒。

请求

POST https://wx.gratour.info:7200/v1/stream/voice/upload
Content-Type: application/json
X-Auth-Token: HrWwReOAQ9WdLnJQ1JYivA

{
  "guid": 961916803414524930,
  "priority": 0,
  "simNo": "13320200521",
  "voice": "01265242-cc33-4c90-9b27-af7de0be079a",
  "tm": 1775450843525
}

请求实体属性

属性	数据类型	必要	说明
guid	long		平台唯一 ID（since 4.0.19）。建议传入以便 Kafka 对齐业务单
priority	int		0–2，缺省 0（since 4.0.19）
simNo	string	Y	终端识别号
voice	string	Y	音频编号（本地音频库 id）
tm	long	Y	语音起始时间 epoch millis，超时起算点

应答

{
  "errCode": 0,
  "data": [
    {
      "taskId": "v0a1b2c3d4e5",
      "guid": 961916803414524930,
      "priority": 0,
      "simNo": "13320200521",
      "voice": "01265242-cc33-4c90-9b27-af7de0be079a",
      "tm": 1775450843525,
      "state": 0,
      "result": null,
      "reqTm": 1775450843601,
      "endTm": null
    }
  ]
}

state：0 排队；1 执行中；2 结束。result 仅结束时有值，与 Kafka 相同 1–4。