主题
G. 下载 Demo
Demo 定位:多语言 Demo(Java / Python / C++ / Android)与芯片无关,是接入协议的参考实现;芯片 SDK Demo 封装了鉴权、唤醒词、设备注册、语音传输等功能,降低对接成本。读代码快速理解协议,改凭证即跑通。
F.1 多语言接入 Demo(与芯片无关)
| 语言 | 下载地址 | 配置文件 | 环境要求 |
|---|---|---|---|
| Python(推荐首次跑通用) | joyinside-python-dev.zip | config.py | Python 3.8+ |
| Java | joyinside-java-dev.zip | AppConfig.java | Java 1.8+ |
| C++ | joyinside-cpp-dev.zip(含签名计算 / websocket client / usage 三个子包) | 见 README | — |
| Android | joyinside-android-demo.zip | AppConfig.java | Android SDK 36+ |
获取凭证:
- AccessKey / SecretKey:登录运营平台 https://joy-inside.jd.com,在
开发者中心 > API密钥页面获取 - vendorId:进入
个人信息,获取注册企业 ID - appId:进入
应用管理,目标应用 ID - botId:注册设备后,设备管理页面「ID」列
填入配置文件(以 Python 为例):
python
# config.py
ACCESS_KEY = "你的 AccessKey"
ACCESS_KEY_SECRET = "你的 SecretKey"
VENDOR_ID = "你的企业 ID"
APP_ID = "你的应用 ID"
BOT_ID = "你的设备 ID"Demo 自带
test.pcm测试音频,跑通流程见 第3章 §3.3 体验设备端接入。
F.2 芯片 SDK Demo
JoyInside 针对主流芯片提供端侧 SDK,封装了鉴权、唤醒词、设备注册、语音传输、有声书模块等功能,降低对接成本。
芯片 SDK 支持矩阵
| 芯片类型 | 基础语音 | 唤醒词 | 芯片 Demo |
|---|---|---|---|
| 乐鑫 ESP32S3 | ✅ 已经支持 | ✅ 已经支持 | joyinside_client_demo_v1.2.zip |
| 博通 BK7258 | ✅ 已经支持 | ✅ 已经支持 | joyinside_beken_demo_v1.0.zip |
| Linux Demo | ✅ 已经支持 | ✅ 已经支持 | joyinside_rk_linux_demo_v1.0.zip |
| 杰里 7911 | 🚧 支持中 | 🚧 支持中 | — |
ESP32S3 Demo 快速接入
通过乐鑫 ESP32-S3 开发板可快速跑通端到端 AI 语音助手:本地离线唤醒("你好东东")+ 基于 WebSocket 的云端实时对话 + 开箱即用直连 JoyInside 云端(无需自建服务器)。
快速接入(以 ESP32S3 为例):
- 克隆 Demo 项目,获取 JoyInside 凭证(Bot ID / AccessKey / SecretKey),参见 SDK 组件文档
components/joyinside_esp32/README.md - 编辑
main/application.cc配置凭证:
cpp
bot_id_ = "your_bot_id"; // 替换为你的 Bot ID
access_key_id_ = "your_ak"; // 替换为你的 Access Key ID
access_key_secret_ = "your_sk"; // 替换为你的 Access Key Secret- 按硬件开发板选择部署教程(如乐鑫 ESP32-S3-Korvo-2 参见
docs/QUICK_START_ESP.md)。接入方式详见各芯片 Demo 的README.md。