语音文件下发接口
-
接口功能
语音文件下发，指定设备播放，需要设备支持能力集 support_talk=1或3
-
请求地址
-
请求方式
POST
-
请求参数
| 参数名 | 类型 | Parameter Type | 描述 | 是否必填 |
|---|---|---|---|---|
| accessToken | String | body | 访问令牌 | Y |
| deviceSerial | String | body | 设备序列号 | Y |
| channelNo | int | body | 通道号，默认通道号为1 | N |
| fileUrl | String | body | 下载音频文件的url（上传接口返回的url） | Y |
-
请求报文
POST /api/lapp/voice/send HTTP/1.1
Host::
Content-Type: application/x-www-form-urlencoded -
返回数据
{
"msg": "操作成功!",
"code": "200",
} -
错误码
| 返回值 | 返回信息 | 描述 |
|---|---|---|
| 10001 | fileUrl参数不合法 | |
| 10001 | channels参数不合法 | |
| 20002 | 设备不存在 | |
| 10031 | 子账户或萤石用户没有权限 | |
| 20018 | 该用户不拥有该设备 | |
| 49999 | Data error | 未知错误 |
| 20007 | 设备不在线 | |
| 20008 | 设备响应超时 | |
| 20001 | 通道不存在 | |
| 20035 | 该通道被隐藏 | |
| 20015 | 设备不支持对讲 | |
| 111000 | 用户资源包余量不足 | 用户资源包余量不足，可前往控制台购买后使用 |
| 111012 | 文件下发失败,内部错误:{} | 内部错误信息请参考下表 |
| 内部错误码 | 错误描述 | 描述 |
|---|---|---|
| 1 | 排队超时 | |
| 2 | 处理超时 | |
| 3 | 设备链接失败 | 设备网络状况不佳 |
| 4 | 服务器内部错误 | |
| 5 | 消息错误 | |
| 6 | 请求重定向 | |
| 7 | 无效URL | |
| 8 | 认证token失败 | |
| 9 | 验证码或者秘钥不匹配 | |
| 10 | 设备正在对讲 | |
| 11 | 设备通信超时 | |
| 12 | 设备不在线 | |
| 13 | 设备开启隐私保护 | |
| 14 | token无权限 | |
| 15 | session不存在 | |
| 16 | 验证token其他问题 | |
| 17 | 设备监听超时 | |
| 18 | 设备链路断开 | |
| 19 | 隐私遮蔽 | |
| 20 | 声源定位 | |
| 21 | ticket认证失败 | |
| 22 | ticket 未开启 | |
| 23 | ticket bizcode错误 | |
| 1003 | 设备网络异常断开 | |
| 10001 | 创建ticket失败 | |
| 10002 | 连接tts失败 | |
| 10003 | 下载文件失败 | |
| 10004 | kafka消息格式错误 | |
| 10005 | tts断开连接 | |
| 10006 | tts url异常 | |
| 10007 | 超过并发限制 | |
| 10008 | 连接已经存在，重复请求 | |
| 10009 | 发送kafka失败 | |
| 10010 | 不支持的音频格式 |
萤石致力于成为全球领先的智能视觉物联网服务商，构建了全球领先的视觉物联网云平台，打造了硬件产品 + 软件云服务一体化的物联网服务体系。萤石云通过构建多数据中心 + 就近服务点的方式服务于全球客户。截至 2025 年底，萤石物联网云平台在全球拥有超过 120 个数据站点，平台上的 IoT 设备接入数超过 3.6 亿，其中视频类设备超过 3 亿。在夯实自身平台能力的基础上，萤石进一步开放技术能力，将物联价值延伸至千行百业。萤石开放平台深度融合 AI 中台能力，涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等，已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等 42 万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。