Skip to content

G. 下载 Demo

Demo 定位:多语言 Demo(Java / Python / C++ / Android)与芯片无关,是接入协议的参考实现;芯片 SDK Demo 封装了鉴权、唤醒词、设备注册、语音传输等功能,降低对接成本。读代码快速理解协议,改凭证即跑通。

F.1 多语言接入 Demo(与芯片无关)

语言下载地址配置文件环境要求
Python(推荐首次跑通用)joyinside-python-dev.zipconfig.pyPython 3.8+
Javajoyinside-java-dev.zipAppConfig.javaJava 1.8+
C++joyinside-cpp-dev.zip(含签名计算 / websocket client / usage 三个子包)见 README
Androidjoyinside-android-demo.zipAppConfig.javaAndroid 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 为例):

  1. 克隆 Demo 项目,获取 JoyInside 凭证(Bot ID / AccessKey / SecretKey),参见 SDK 组件文档 components/joyinside_esp32/README.md
  2. 编辑 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
  1. 按硬件开发板选择部署教程(如乐鑫 ESP32-S3-Korvo-2 参见 docs/QUICK_START_ESP.md)。接入方式详见各芯片 Demo 的 README.md