JoyInside 接入手册

主题

第 1 章 认识 JoyInside ​

本章只回答一个问题:JoyInside 能不能帮你把设备做出来。1 分钟读完,你就能判断要不要接、接了能得到什么。

已经了解 JoyInside、只想尽快跑通?直接跳 第 3 章 JoyInside 接入预览,听见云端回复。

1.1 JoyInside 是什么 ​

JoyInside 是京东的语音智能体接入平台,让硬件具备"听得懂、会说话、能执行"的能力。

它把云端智能体当"大脑",硬件设备当"耳朵和嘴巴"——设备采集声音上传,云端完成识别、思考、合成,再把语音和动作指令发回设备播放与执行。

用户说话 → 设备采集 → 云端 ASR 识别 → 云端 LLM 思考 → 云端 TTS 合成
                                                              ↓
                                              语音回复下发播放 + 指令下发执行

一个硬件接入 JoyInside 后,能获得三类能力(按需组合):

能力做什么谁配置
语音对话闲聊问答、记忆人设、情感陪伴运营在平台配置(无需写代码)
指令控制语音驱动设备动作("把灯调暗")运营配置指令 + 研发端侧执行
内容/能力扩展有声书、自定义技能、A2A 智能体、图片生成研发对接 API

协议细节(鉴权/设备身份/WS/音频格式)见 第 4 章,配置字段见 附录 E。本章不展开。

1.2 你的设备能做成什么样:3 个场景 ​

JoyInside 已覆盖 7 类硬件,这里选 3 个典型代表,对应上表三类能力组合。

场景 1:毛绒玩具 / 点读笔(纯语音对话) ​

硬件:毛绒玩具 + AI 机盒,配麦克风和扬声器。 接入后:孩子抱住玩具说"给我讲个故事",玩具开口讲起来——支持闲聊、内容播放、连续对话、自定义人设与音色。

场景 2:家电 / 3C(语音 + 指令控制) ​

硬件:灯具/空调/扫地机等 + AI 硬件。 接入后:说一句"我冷了",空调自动调到 26 度并回复"已为你调高温度"——语音驱动设备动作,支持执行结果反馈。

场景 3:打印机(语音 + 内容生成) ​

硬件:打印机 + AI 硬件。 接入后:孩子说"画一只戴帽子的猫",打印机吐出一张画——对话中根据上下文生成图片并完成打印。

其他场景 ​

场景硬件形态核心差异
双目显示玩具毛绒 + AI 硬件 + 双目屏双目情绪屏幕展示
舵机控制玩具含舵机复杂动作指令控制
视觉对话AI 硬件 + 视觉识别图像识别 + 对话
机器人(狗)人形/机器狗具身 + 视觉 + 自定义能力

完整 7 类场景与迁移模式见 第 2 章 选你的接入路径。

1.3 接入要走过哪些路 ​

从零到上线分三阶段，跑通第一轮语音对话是第一个里程碑：

运营(平台配置)                    研发(端侧对接)                          量产/运维
   │                                  │                                  │
   ├─ 注册企业/型号(拿 vendorId)       ├─ 选 Demo 改凭证(拿 AccessKey)     ├─ 测试转生产(type 转换)
   ├─ 创建应用选技能(拿 appId)         ├─ 签名 getToken(HMAC-MD5 V2)       ├─ token 过期验证
   ├─ 注册测试设备(拿 botId)           ├─ WS 建联 + 配音频格式              ├─ 产测烧录
   └─ 预览调试验证 ⭐ 云端跑通         └─ 发音频收 TTS ⭐ 端侧跑通          └─ 灰度/OTA/监控
            │                                  │
            └──────────── 跑通后扩展 ───────────┘
                            │
               按设备类型选场景扩展(第6章)
               + 可选:小程序端对接(第8章)
阶段做什么谁来做产出
① 云端配置注册企业/型号/应用/设备 → 预览调试运营/产品vendorId/appId/botId + ⭐ 云端跑通点
② 端侧对接签名 getToken → WS 建联 → 发音频收 TTS嵌入式研发可量产的端侧 SDK/固件 + ⭐ 端侧跑通点
③ 量产运维(持续)测试转生产 → token 过期验证 → 产测 → 灰度 → 运维量产/运维从 1 台到万台

⭐ 关键设计：第①阶段末尾的预览调试是云端跑通点（零代码验证配置），第②阶段的听见 TTS 回复是端侧跑通点。两层解耦，任一层出错都能独立定位。详见 第 3 章。

这条链路对应手册 5 部分：第一部分认识选型（第1-2章）→ 第二部分语音对话接入（第3-7章）→ 第三部分小程序接入（第8-9章，可选）→ 第四部分联调与量产运维（第10-13章）。

1.4 方案商的两条工作面 ​

方案商接入 JoyInside，通常面对两条并列的工作面：

工作面协议用途对应手册
设备端对接WebSocket 长连接实时语音对话、指令控制、内容播放第二部分（第3-7章）
小程序端对接HTTP 接口配网、设备绑定、角色管理、聊天记录、在线设备管理第三部分（第8-9章）
  • 设备端是必走：只要设备要对话，就必须走 WS 协议接入（第3章从零到跑通是起点）
  • 小程序是可选增强：设备端跑通后，若需扩展用户交互面（手机管理设备），再对接小程序接口

两条工作面共享同一套设备身份（botId）与企业凭证（vendorId/appId），但协议不同、时机不同。是否需要小程序，见 第2章 §2.6。

下一步 ​

读完本章，你已经能判断 JoyInside 跟你有没有关系。接下来：