Skip to content

技能库 - OTA ​

「OTA」是标准版内置系统技能。设备上报 OTA 事件后,由 JoyInside 播报更新说明、获取用户的语音确认,并将决策下发给端侧执行升级。

平台负责升级前的语音交互,不负责固件升级本身。启用方式详见 技能配置。

1. 配置更新内容 ​

进入「产品管理 → 目标产品卡片 → 配置详情 → 编辑智能体 → 技能区域」,添加「OTA」,再通过已添加技能卡片右侧的编辑图标配置。

配置项说明维护方式
更新内容检测到新版本时向用户播报的更新说明每次更新需要手动维护,与本次发布的版本内容保持一致

本技能仅开放「更新内容」这一个配置项。用户明确拒绝时的回复为固定话术,不可编辑。

2. 交互流程 ​

  1. 厂商云完成版本比对,设备检查电量、网络、存储等升级条件。
  2. 设备满足升级及引导条件后,通过已建立的连接上报 OTA 事件。
  3. JoyInside 播报配置的更新说明,引导用户语音确认是否升级。
  4. 平台识别用户的升级决策并下发给端侧;用户同意后,由端侧执行升级。
用户反馈处理方式
明确同意升级下发同意决策,由端侧执行升级
明确拒绝升级播报固定拒绝话术(不可编辑),下发拒绝决策
其他意图进入闲聊,不将无关表达视为升级确认

升级成功或失败由端侧本地处理和反馈,JoyInside 不播报升级成功 / 失败结果。

2.1 端侧上行与下行事件 ​

OTA 确认链路涉及以下三个事件,完整字段及 JSON 示例以接入手册 附录 B · B.4.13 OTA 升级事件 为准:

方向事件标识触发时机与端侧处理协议位置
上行:设备 → JoyInsidecontentType = 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. 上线前检查 ​

  • 每次发布新版本前,手动更新「更新内容」,核对播报说明与实际版本一致。
  • 验证设备上报事件后能播报更新说明,并能正确处理同意、明确拒绝和无关意图。
  • 验证拒绝话术不可编辑,升级结果由端侧本地反馈。
  • 由厂商云和端侧验证升级条件、固件校验、失败回滚及任务过期等非语音链路。