主题
技能库 - OTA
「OTA」是标准版内置系统技能。设备上报 OTA 事件后,由 JoyInside 播报更新说明、获取用户的语音确认,并将决策下发给端侧执行升级。
平台负责升级前的语音交互,不负责固件升级本身。启用方式详见 技能配置。
1. 配置更新内容
进入「产品管理 → 目标产品卡片 → 配置详情 → 编辑智能体 → 技能区域」,添加「OTA」,再通过已添加技能卡片右侧的编辑图标配置。
| 配置项 | 说明 | 维护方式 |
|---|---|---|
| 更新内容 | 检测到新版本时向用户播报的更新说明 | 每次更新需要手动维护,与本次发布的版本内容保持一致 |
本技能仅开放「更新内容」这一个配置项。用户明确拒绝时的回复为固定话术,不可编辑。
2. 交互流程
- 厂商云完成版本比对,设备检查电量、网络、存储等升级条件。
- 设备满足升级及引导条件后,通过已建立的连接上报 OTA 事件。
- JoyInside 播报配置的更新说明,引导用户语音确认是否升级。
- 平台识别用户的升级决策并下发给端侧;用户同意后,由端侧执行升级。
| 用户反馈 | 处理方式 |
|---|---|
| 明确同意升级 | 下发同意决策,由端侧执行升级 |
| 明确拒绝升级 | 播报固定拒绝话术(不可编辑),下发拒绝决策 |
| 其他意图 | 进入闲聊,不将无关表达视为升级确认 |
升级成功或失败由端侧本地处理和反馈,JoyInside 不播报升级成功 / 失败结果。
2.1 端侧上行与下行事件
OTA 确认链路涉及以下三个事件,完整字段及 JSON 示例以接入手册 附录 B · B.4.13 OTA 升级事件 为准:
| 方向 | 事件标识 | 触发时机与端侧处理 | 协议位置 |
|---|---|---|---|
| 上行:设备 → JoyInside | contentType = ACTIVITY,content.activityType = VOICE_CHAT_TRIGGER,content.kvData.type = OTA | 设备确认需要升级且满足升级及引导条件后上报,通知 JoyInside 发起升级语音确认;同时携带电量、当前版本和目标版本 | B.4.9 · 场景三:端侧 OTA 升级上报 |
| 下行:JoyInside → 设备 | contentType = OTA,content.eventType = OTA_START | 用户同意升级后下发。端侧先停止音频上传、禁止打断,播放完 OTA 开始话术 TTS 后再执行升级 | B.4.13 · 下行:OTA 升级启动 |
| 下行:JoyInside → 设备 | contentType = OTA,content.eventType = OTA_REJECT | 用户明确拒绝升级后下发,端侧不启动本次升级 | B.4.13 · 下行:OTA 升级取消 |
**上报字段注意事项:**真实设备上报时,content.kvData.battery、content.kvData.currentVersion 和 content.kvData.targetVersion 均为必填字符串,例如电量传 "71"。调试窗中的示例不是完整的 WebSocket 消息,端侧应按上述协议封装,不能只发送 type = OTA。
3. 各方职责
| 负责方 | 职责 |
|---|---|
| JoyInside | 提供标准技能及更新内容配置、接收 OTA 上行事件、完成语音交互、下发用户决策 |
| 厂商云 | 版本比对、灰度策略、固件包存储 / 分发 / 校验、升级任务生命周期及任务过期管理 |
| 设备端 | 电量 / 网络 / 存储条件判断、OTA 事件上报与决策接收、升级执行 / 断点续传 / 失败回滚、升级结果本地反馈 |
仅在平台添加技能并不能完成 OTA 接入,还需厂商云和端侧实现上述能力。本页说明产品配置与职责,不定义新的端侧协议字段。
4. 在调试窗模拟事件上报
可在调试窗 → 模拟事件上报中选择 「OTA 更新」 进行测试。上报内容示例、操作步骤及验证范围统一见 产品管理 · OTA 更新事件模拟。
5. 上线前检查
- 每次发布新版本前,手动更新「更新内容」,核对播报说明与实际版本一致。
- 验证设备上报事件后能播报更新说明,并能正确处理同意、明确拒绝和无关意图。
- 验证拒绝话术不可编辑,升级结果由端侧本地反馈。
- 由厂商云和端侧验证升级条件、固件校验、失败回滚及任务过期等非语音链路。